to top
Android APIs
public abstract class

TokenWatcher

extends Object
java.lang.Object
   ↳ android.os.TokenWatcher

Class Overview

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

? Examples 		TokenWatcher( Handler h, String tag)
Construct the TokenWatcher
Public Methods

? Examples 		void acquire( IBinder token, String tag)
Record that this token has been acquired.

? Examples 		abstract void acquired()
Called when the number of active tokens goes from 0 to 1.

? Examples 		void cleanup( IBinder token, boolean unlink)

? Examples 		void dump()

? Examples 		void dump( PrintWriter pw)

? Examples 		boolean isAcquired()

? Examples 		void release( IBinder token)

? Examples 		abstract void released()
Called when the number of active tokens goes from 1 to 0.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public TokenWatcher (Handler h, String tag)

Added in API level 1

Construct the TokenWatcher

Parameters
h 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 A debugging tag for this TokenWatcher

Public Methods

public void acquire (IBinder token, String tag)

Added in API level 1

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 An IBinder object. If this token has already been acquired, no action is taken.
tag A string used by the dump() method for debugging, to see who has references.

public abstract void acquired ()

Added in API level 1

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

public void cleanup (IBinder token, boolean unlink)

Added in API level 1

public void dump ()

Added in API level 1

public void dump (PrintWriter pw)

Added in API level 16

public boolean isAcquired ()

Added in API level 1

public void release (IBinder token)

Added in API level 1

public abstract void released ()

Added in API level 1

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

No examples for this method.
Frequently called with: [Clear]
Portions of this page are reproduced from work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. The original page is available here.