io.grpc.binder.internal

Class LeakSafeOneWayBinder

java.lang.Object

android.os.Binder

io.grpc.binder.internal.LeakSafeOneWayBinder

All Implemented Interfaces:

android.os.IBinder

@Internal
public final class LeakSafeOneWayBinder
extends android.os.Binder

An extension of Binder which delegates all transactions to an internal handler, and only supports one way transactions.

Since Binder objects can be anchored forever by a misbehaved remote process, any references they hold can lead to significant memory leaks. To prevent that, the detach() method clears the reference to the delegate handler, ensuring that only this simple class is leaked. Once detached, this binder returns false from any future transactions (and pings).

Since two-way transactions block the calling thread on a remote process, this class only supports one-way calls.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	LeakSafeOneWayBinder.TransactionHandler

Nested classes/interfaces inherited from interface android.os.IBinder

android.os.IBinder.DeathRecipient

Field Summary

Fields inherited from interface android.os.IBinder

DUMP_TRANSACTION, FIRST_CALL_TRANSACTION, FLAG_ONEWAY, INTERFACE_TRANSACTION, LAST_CALL_TRANSACTION, LIKE_TRANSACTION, PING_TRANSACTION, TWEET_TRANSACTION

Constructor Summary

Constructors

Constructor and Description
LeakSafeOneWayBinder(LeakSafeOneWayBinder.TransactionHandler handler)

Method Summary

Modifier and Type	Method and Description
void	detach()
protected boolean	onTransact(int code, android.os.Parcel parcel, android.os.Parcel reply, int flags)
boolean	pingBinder()

Methods inherited from class android.os.Binder

attachInterface, clearCallingIdentity, clearCallingWorkSource, dump, dump, dumpAsync, flushPendingCommands, getCallingPid, getCallingUid, getCallingUidOrThrow, getCallingUserHandle, getCallingWorkSourceUid, getInterfaceDescriptor, isBinderAlive, joinThreadPool, linkToDeath, queryLocalInterface, restoreCallingIdentity, restoreCallingWorkSource, setCallingWorkSourceUid, transact, unlinkToDeath

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LeakSafeOneWayBinder

public LeakSafeOneWayBinder(LeakSafeOneWayBinder.TransactionHandler handler)

Method Detail

detach

public void detach()

onTransact

protected boolean onTransact(int code,
                             android.os.Parcel parcel,
                             android.os.Parcel reply,
                             int flags)

Overrides:

onTransact in class android.os.Binder

pingBinder

public boolean pingBinder()

Specified by:

pingBinder in interface android.os.IBinder

Overrides:

pingBinder in class android.os.Binder