public
abstract
class
TokenWatcher
extends Object
| java.lang.Object | |
| ↳ | android.os.TokenWatcher |
Helper class that helps you use IBinder objects as reference counted tokens. IBinders make good tokens because we find out when they are removed
Public constructors | |
|---|---|
TokenWatcher(Handler h, String tag)
Construct the TokenWatcher |
|
Public methods | |
|---|---|
void
|
acquire(IBinder token, String tag)
Record that this token has been acquired. |
abstract
void
|
acquired()
Called when the number of active tokens goes from 0 to 1. |
void
|
cleanup(IBinder token, boolean unlink)
|
void
|
dump(PrintWriter pw)
|
void
|
dump()
|
boolean
|
isAcquired()
|
void
|
release(IBinder token)
|
abstract
void
|
released()
Called when the number of active tokens goes from 1 to 0. |
Inherited methods | |
|---|---|
 From
class
java.lang.Object
| |
TokenWatcher (Handler h, String tag)
Construct the TokenWatcher
| Parameters | |
|---|---|
h |
Handler:
A handler to call acquired() and released()
on. If you don't care, just call it like this, although your thread
will have to be a Looper thread.
new TokenWatcher(new Handler()) |
tag |
String:
A debugging tag for this TokenWatcher
|
void acquire (IBinder token, String tag)
Record that this token has been acquired. When acquire is called, and the current count is 0, the acquired method is called on the given handler.
| Parameters | |
|---|---|
token |
IBinder:
An IBinder object. If this token has already been acquired,
no action is taken. |
tag |
String:
A string used by the dump() method for debugging,
to see who has references.
|
void acquired ()
Called when the number of active tokens goes from 0 to 1.
void cleanup (IBinder token, boolean unlink)
| Parameters | |
|---|---|
token |
IBinder
|
unlink |
boolean
|
void released ()
Called when the number of active tokens goes from 1 to 0.
Developers