public class ResultReceiver
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.os.ResultReceiver |
Generic interface for receiving a callback result from someone. Use this by creating a subclass and implement onReceiveResult(int, Bundle)
, which you can then pass to others and send through IPC, and receive results they supply with send(int, Bundle)
.
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.
Inherited constants |
---|
![]() android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<ResultReceiver> |
CREATOR
|
Public constructors |
|
---|---|
ResultReceiver(Handler handler) Create a new ResultReceive to receive results. |
Public methods |
|
---|---|
int |
describeContents() Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
void |
send(int resultCode, Bundle resultData) Deliver a result to this receiver. |
void |
writeToParcel(Parcel out, int flags) Flatten this object in to a Parcel. |
Protected methods |
|
---|---|
void |
onReceiveResult(int resultCode, Bundle resultData) Override to receive results delivered to this object. |
Inherited methods |
|
---|---|
![]() java.lang.Object
|
|
![]() android.os.Parcelable
|
ResultReceiver (Handler handler)
Create a new ResultReceive to receive results. Your onReceiveResult(int, Bundle)
method will be called from the thread running handler if given, or from an arbitrary thread if null.
Parameters | |
---|---|
handler |
Handler
|
int describeContents ()
Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(Parcel, int)
, the return value of this method must include the CONTENTS_FILE_DESCRIPTOR
bit.
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
void send (int resultCode, Bundle resultData)
Deliver a result to this receiver. Will call onReceiveResult(int, Bundle)
, always asynchronously if the receiver has supplied a Handler in which to dispatch the result.
Parameters | |
---|---|
resultCode |
int : Arbitrary result code to deliver, as defined by you. |
resultData |
Bundle : Any additional data provided by you. |
void writeToParcel (Parcel out, int flags)
Flatten this object in to a Parcel.
Parameters | |
---|---|
out |
Parcel : The Parcel in which the object should be written. |
flags |
int : Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . |
void onReceiveResult (int resultCode, Bundle resultData)
Override to receive results delivered to this object.
Parameters | |
---|---|
resultCode |
int : Arbitrary result code delivered by the sender, as defined by the sender. |
resultData |
Bundle : Any additional data provided by the sender. |