public final class Messenger extends Object implements Parcelable
Note: the implementation underneath is just a simple wrapper around
a Binder
that is used to perform the communication. This means
semantically you should treat it as such: this class does not impact process
lifecycle management (you must be using some higher-level component to tell
the system that your process needs to continue running), the connection will
break if your process goes away for any reason, etc.
Parcelable.ClassLoaderCreator<T>, Parcelable.Creator<T>
Modifier and Type | Field and Description |
---|---|
static Parcelable.Creator<Messenger> |
CREATOR |
CONTENTS_FILE_DESCRIPTOR, PARCELABLE_ELIDE_DUPLICATES, PARCELABLE_WRITE_RETURN_VALUE
Constructor and Description |
---|
Messenger(Handler target)
Create a new Messenger pointing to the given Handler.
|
Messenger(IBinder target)
Create a Messenger from a raw IBinder, which had previously been
retrieved with
getBinder() . |
Modifier and Type | Method and Description |
---|---|
int |
describeContents()
Describe the kinds of special objects contained in this Parcelable
instance's marshaled representation.
|
boolean |
equals(Object otherObj)
Comparison operator on two Messenger objects, such that true
is returned then they both point to the same Handler.
|
IBinder |
getBinder()
Retrieve the IBinder that this Messenger is using to communicate with
its associated Handler.
|
int |
hashCode()
Returns a hash code value for the object.
|
static Messenger |
readMessengerOrNullFromParcel(Parcel in)
Convenience function for reading either a Messenger or null pointer from
a Parcel.
|
void |
send(Message message)
Send a Message to this Messenger's Handler.
|
static void |
writeMessengerOrNullToParcel(Messenger messenger,
Parcel out)
Convenience function for writing either a Messenger or null pointer to
a Parcel.
|
void |
writeToParcel(Parcel out,
int flags)
Flatten this object in to a Parcel.
|
public static final Parcelable.Creator<Messenger> CREATOR
public Messenger(Handler target)
Handler.sendMessage(Message)
had
been called directly.target
- The Handler that will receive sent messages.public Messenger(IBinder target)
getBinder()
.target
- The IBinder this Messenger should communicate with.public void send(Message message) throws RemoteException
message
- The Message to send. Usually retrieved through
Message.obtain()
.RemoteException
- Throws DeadObjectException if the target
Handler no longer exists.public IBinder getBinder()
public boolean equals(Object otherObj)
equals
in class Object
otherObj
- the reference object with which to compare.true
if this object is the same as the obj
argument; false
otherwise.Object.hashCode()
,
HashMap
public int hashCode()
Object
HashMap
.
The general contract of hashCode
is:
hashCode
method
must consistently return the same integer, provided no information
used in equals
comparisons on the object is modified.
This integer need not remain consistent from one execution of an
application to another execution of the same application.
equals(Object)
method, then calling the hashCode
method on each of
the two objects must produce the same integer result.
Object.equals(java.lang.Object)
method, then calling the hashCode
method on each of the
two objects must produce distinct integer results. However, the
programmer should be aware that producing distinct integer results
for unequal objects may improve the performance of hash tables.
As much as is reasonably practical, the hashCode method defined by
class Object
does return distinct integers for distinct
objects. (This is typically implemented by converting the internal
address of the object into an integer, but this implementation
technique is not required by the
JavaTM programming language.)
hashCode
in class Object
Object.equals(java.lang.Object)
,
System.identityHashCode(java.lang.Object)
public int describeContents()
Parcelable
Parcelable.writeToParcel(Parcel, int)
,
the return value of this method must include the
Parcelable.CONTENTS_FILE_DESCRIPTOR
bit.describeContents
in interface Parcelable
Parcelable.CONTENTS_FILE_DESCRIPTOR
public void writeToParcel(Parcel out, int flags)
Parcelable
writeToParcel
in interface Parcelable
out
- The Parcel in which the object should be written.flags
- Additional flags about how the object should be written.
May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE
.public static void writeMessengerOrNullToParcel(Messenger messenger, Parcel out)
readMessengerOrNullFromParcel(android.os.Parcel)
for later reading it.messenger
- The Messenger to write, or null.out
- Where to write the Messenger.public static Messenger readMessengerOrNullFromParcel(Parcel in)
writeMessengerOrNullToParcel(android.os.Messenger, android.os.Parcel)
.in
- The Parcel containing the written Messenger.