Merge "Document linkToDeath behavior on object cleanup."

This commit is contained in:
Steven Moreland
2020-04-01 18:35:05 +00:00
committed by Gerrit Code Review

View File

@@ -293,13 +293,16 @@ public interface IBinder {
* then the given {@link DeathRecipient}'s * then the given {@link DeathRecipient}'s
* {@link DeathRecipient#binderDied DeathRecipient.binderDied()} method * {@link DeathRecipient#binderDied DeathRecipient.binderDied()} method
* will be called. * will be called.
* *
* <p>This will automatically be unlinked when all references to the linked
* binder proxy are dropped.</p>
*
* <p>You will only receive death notifications for remote binders, * <p>You will only receive death notifications for remote binders,
* as local binders by definition can't die without you dying as well. * as local binders by definition can't die without you dying as well.</p>
* *
* @throws RemoteException if the target IBinder's * @throws RemoteException if the target IBinder's
* process has already died. * process has already died.
* *
* @see #unlinkToDeath * @see #unlinkToDeath
*/ */
public void linkToDeath(@NonNull DeathRecipient recipient, int flags) public void linkToDeath(@NonNull DeathRecipient recipient, int flags)