Android
android.os
public abstract class

android.os.TokenWatcher

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()
          boolean  isAcquired()
          void  release(IBinder token)
abstract          void  released()
Called when the number of active tokens goes from 1 to 0.
Methods inherited from class java.lang.Object

Details

Public Constructors

public TokenWatcher(Handler h, String tag)

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)

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()

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

public void cleanup(IBinder token, boolean unlink)

public void dump()

public boolean isAcquired()

public void release(IBinder token)

public abstract void released()

Called when the number of active tokens goes from 1 to 0.
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:48