Skip to content

Most visited

Recently visited

navigation

TokenWatcher

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

Summary

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

Public constructors

TokenWatcher

Added in API level 1
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

Public methods

acquire

Added in API level 1
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.

acquired

Added in API level 1
void acquired ()

Called when the number of active tokens goes from 0 to 1.

cleanup

Added in API level 1
void cleanup (IBinder token, 
                boolean unlink)

Parameters
token IBinder
unlink boolean

dump

Added in API level 16
void dump (PrintWriter pw)

Parameters
pw PrintWriter

dump

Added in API level 1
void dump ()

isAcquired

Added in API level 1
boolean isAcquired ()

Returns
boolean

release

Added in API level 1
void release (IBinder token)

Parameters
token IBinder

released

Added in API level 1
void released ()

Called when the number of active tokens goes from 1 to 0.

This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.