AuthenticationRequiredException
public
final
class
AuthenticationRequiredException
extends SecurityException
implements
Parcelable
java.lang.Object | |||||
↳ | java.lang.Throwable | ||||
↳ | java.lang.Exception | ||||
↳ | java.lang.RuntimeException | ||||
↳ | java.lang.SecurityException | ||||
↳ | android.app.AuthenticationRequiredException |
Specialization of SecurityException
that is thrown when authentication is needed from the
end user before viewing the content.
This exception is only appropriate where there is a concrete action the user can take to authorize and make forward progress, such as confirming or entering authentication credentials, or granting access via other means.
Note: legacy code that receives this exception may treat it as a general
SecurityException
, and thus there is no guarantee that the action contained will be
invoked by the user.
Summary
Inherited constants |
---|
Fields | |
---|---|
public
static
final
Creator<AuthenticationRequiredException> |
CREATOR
|
Public constructors | |
---|---|
AuthenticationRequiredException(Throwable cause, PendingIntent userAction)
Create an instance ready to be thrown. |
Public methods | |
---|---|
int
|
describeContents()
Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
PendingIntent
|
getUserAction()
Return primary action that will initiate the authorization. |
void
|
writeToParcel(Parcel dest, int flags)
Flatten this object in to a Parcel. |
Inherited methods | |
---|---|
Fields
Public constructors
AuthenticationRequiredException
public AuthenticationRequiredException (Throwable cause, PendingIntent userAction)
Create an instance ready to be thrown.
Parameters | |
---|---|
cause |
Throwable : original cause with details designed for engineering
audiences. |
userAction |
PendingIntent : primary action that will initiate the recovery. This
must launch an activity that is expected to set
Activity.setResult(int) before finishing to
communicate the final status of the recovery. For example,
apps that observe Activity.RESULT_OK may choose to
immediately retry their operation. |
Public methods
describeContents
public 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(android.os.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.
Value is either 0 or CONTENTS_FILE_DESCRIPTOR |
getUserAction
public PendingIntent getUserAction ()
Return primary action that will initiate the authorization.
Returns | |
---|---|
PendingIntent |
writeToParcel
public void writeToParcel (Parcel dest, int flags)
Flatten this object in to a Parcel.
Parameters | |
---|---|
dest |
Parcel : The Parcel in which the object should be written.
This value cannot be null . |
flags |
int : Additional flags about how the object should be written.
May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE .
Value is either 0 or a combination of Parcelable.PARCELABLE_WRITE_RETURN_VALUE , and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES |