java.lang.Object | |
↳ | android.content.IntentSender |
A description of an Intent and target action to perform with it. The returned object can be handed to other applications so that they can perform the action you described on your behalf at a later time.
By giving a IntentSender to another application, you are granting it the right to perform the operation you have specified as if the other application was yourself (with the same permissions and identity). As such, you should be careful about how you build the IntentSender: often, for example, the base Intent you supply will have the component name explicitly set to one of your own components, to ensure it is ultimately sent there and nowhere else.
A IntentSender itself is simply a reference to a token maintained by the system describing the original data used to retrieve it. This means that, even if its owning application's process is killed, the IntentSender itself will remain usable from other processes that have been given it. If the creating application later re-retrieves the same kind of IntentSender (same operation, same Intent action, data, categories, and components, and same flags), it will receive a IntentSender representing the same token if that is still valid.
Instances of this class can not be made directly, but rather must be
created from an existing PendingIntent
with
PendingIntent.getIntentSender()
.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
IntentSender.OnFinished | Callback interface for discovering when a send operation has completed. | ||||||||||
IntentSender.SendIntentException | Exception thrown when trying to send through a PendingIntent that has been canceled or is otherwise no longer able to execute the request. |
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
android.os.Parcelable
|
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CREATOR |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Describe the kinds of special objects contained in this Parcelable's
marshalled representation.
| |||||||||||
Comparison operator on two IntentSender objects, such that true
is returned then they both represent the same operation from the
same package.
| |||||||||||
Return the package name of the application that created this
IntentSender, that is the identity under which you will actually be
sending the Intent.
| |||||||||||
Return the uid of the application that created this
PendingIntent, that is the identity under which you will actually be
sending the Intent.
| |||||||||||
Return the user handle of the application that created this
PendingIntent, that is the user under which you will actually be
sending the Intent.
| |||||||||||
This method was deprecated
in API level 17.
Renamed to
getCreatorPackage() .
| |||||||||||
Returns an integer hash code for this object.
| |||||||||||
Convenience function for reading either a Messenger or null pointer from
a Parcel.
| |||||||||||
Perform the operation associated with this IntentSender, allowing the
caller to specify information about the Intent to use and be notified
when the send has completed.
| |||||||||||
Perform the operation associated with this IntentSender, allowing the
caller to specify information about the Intent to use and be notified
when the send has completed.
| |||||||||||
Returns a string containing a concise, human-readable description of this
object.
| |||||||||||
Convenience function for writing either a IntentSender or null pointer to
a Parcel.
| |||||||||||
Flatten this object in to a Parcel.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
android.os.Parcelable
|
Describe the kinds of special objects contained in this Parcelable's marshalled representation.
Comparison operator on two IntentSender objects, such that true is returned then they both represent the same operation from the same package.
otherObj | the object to compare this instance with. |
---|
true
if the specified object is equal to this Object
; false
otherwise.Return the package name of the application that created this IntentSender, that is the identity under which you will actually be sending the Intent. The returned string is supplied by the system, so that an application can not spoof its package.
Return the uid of the application that created this PendingIntent, that is the identity under which you will actually be sending the Intent. The returned integer is supplied by the system, so that an application can not spoof its uid.
Return the user handle of the application that created this
PendingIntent, that is the user under which you will actually be
sending the Intent. The returned UserHandle is supplied by the system, so
that an application can not spoof its user. See
Process.myUserHandle()
for
more explanation of user handles.
Returns an integer hash code for this object. By contract, any two
objects for which equals(Object)
returns true
must return
the same hash code value. This means that subclasses of Object
usually override both methods or neither method.
Note that hash values must not change over time unless information used in equals comparisons also changes.
See Writing a correct
hashCode
method
if you intend implementing your own hashCode
method.
Convenience function for reading either a Messenger or null pointer from
a Parcel. You must have previously written the Messenger with
writeIntentSenderOrNullToParcel(IntentSender, Parcel)
.
in | The Parcel containing the written Messenger. |
---|
Perform the operation associated with this IntentSender, allowing the caller to specify information about the Intent to use and be notified when the send has completed.
context | The Context of the caller. This may be null if intent is also null. |
---|---|
code | Result code to supply back to the IntentSender's target. |
intent | Additional Intent data. See Intent.fillIn() for information on how this is applied to the
original Intent. Use null to not modify the original Intent. |
onFinished | The object to call back on when the send has completed, or null for no callback. |
handler | Handler identifying the thread on which the callback should happen. If null, the callback will happen from the thread pool of the process. |
requiredPermission | Name of permission that a recipient of the PendingIntent
is required to hold. This is only valid for broadcast intents, and
corresponds to the permission argument in
Context.sendOrderedBroadcast(Intent, String) .
If null, no permission is required. |
IntentSender.SendIntentException | Throws CanceledIntentException if the IntentSender is no longer allowing more intents to be sent through it. |
---|
Perform the operation associated with this IntentSender, allowing the caller to specify information about the Intent to use and be notified when the send has completed.
context | The Context of the caller. This may be null if intent is also null. |
---|---|
code | Result code to supply back to the IntentSender's target. |
intent | Additional Intent data. See Intent.fillIn() for information on how this is applied to the
original Intent. Use null to not modify the original Intent. |
onFinished | The object to call back on when the send has completed, or null for no callback. |
handler | Handler identifying the thread on which the callback should happen. If null, the callback will happen from the thread pool of the process. |
IntentSender.SendIntentException | Throws CanceledIntentException if the IntentSender is no longer allowing more intents to be sent through it. |
---|
Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:
getClass().getName() + '@' + Integer.toHexString(hashCode())
See Writing a useful
toString
method
if you intend implementing your own toString
method.
Convenience function for writing either a IntentSender or null pointer to
a Parcel. You must use this with readIntentSenderOrNullFromParcel(Parcel)
for later reading it.
sender | The IntentSender to write, or null. |
---|---|
out | Where to write the IntentSender. |
Flatten this object in to a Parcel.
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_WRITE_RETURN_VALUE .
|