Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/java/security/PrivilegedActionException#pubctors) \| [Methods](https://developer.android.com/reference/java/security/PrivilegedActionException#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/java/security/PrivilegedActionException#inhmethods)

# PrivilegedActionException


`
public


class
PrivilegedActionException
`


`


`

`


`

`

extends https://developer.android.com/reference/java/lang/Exception


`

`


`

|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||||
| ↳ | [java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable) |||
|   | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception) ||
|   |   | ↳ | java.security.PrivilegedActionException |

<br />

*** ** * ** ***

Legacy security code; do not use.

This exception is thrown by
`doPrivileged(PrivilegedExceptionAction)` and
`doPrivileged(PrivilegedExceptionAction,
AccessControlContext context)` to indicate
that the action being performed threw a checked exception. The exception
thrown by the action can be obtained by calling the
`getException` method. In effect, an
`PrivilegedActionException` is a "wrapper"
for an exception thrown by a privileged action.

As of release 1.4, this exception has been retrofitted to conform to
the general purpose exception-chaining mechanism. The "exception thrown
by the privileged computation" that is provided at construction time and
accessed via the `https://developer.android.com/reference/java/security/PrivilegedActionException#getException()` method is now known as the
*cause*, and may be accessed via the `https://developer.android.com/reference/java/lang/Throwable#getCause()`
method, as well as the aforementioned "legacy method."
**See also:**

- `https://developer.android.com/reference/java/security/PrivilegedExceptionAction`
- `https://developer.android.com/reference/java/security/AccessController#doPrivileged(java.security.PrivilegedExceptionAction<T>)`
- `https://developer.android.com/reference/java/security/AccessController#doPrivileged(java.security.PrivilegedExceptionAction<T>,%20java.security.AccessControlContext)`

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/java/security/PrivilegedActionException#PrivilegedActionException(java.lang.Exception)(https://developer.android.com/reference/java/lang/Exception exception) ` Constructs a new PrivilegedActionException "wrapping" the specific Exception. |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/security/PrivilegedActionException#getCause()() ` Returns the cause of this exception (the exception thrown by the privileged computation that resulted in this `PrivilegedActionException`). |
| ` https://developer.android.com/reference/java/lang/Exception` | ` https://developer.android.com/reference/java/security/PrivilegedActionException#getException()() ` Returns the exception thrown by the privileged computation that resulted in this `PrivilegedActionException`. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/security/PrivilegedActionException#toString()() ` Returns a short description of this throwable. |

| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/java/lang/Throwable ` |---|---| | ` final void` | ` https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable exception) ` Appends the specified exception to the exceptions that were suppressed in order to deliver this exception. | | ` https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace()() ` Fills in the execution stack trace. | | ` https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#getCause()() ` Returns the cause of this throwable or `null` if the cause is nonexistent or unknown. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage()() ` Creates a localized description of this throwable. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Throwable#getMessage()() ` Returns the detail message string of this throwable. | | ` https://developer.android.com/reference/java/lang/StackTraceElement` | ` https://developer.android.com/reference/java/lang/Throwable#getStackTrace()() ` Provides programmatic access to the stack trace information printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()`. | | ` final https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#getSuppressed()() ` Returns an array containing all of the exceptions that were suppressed, typically by the `try`-with-resources statement, in order to deliver this exception. | | ` https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable cause) ` Initializes the *cause* of this throwable to the specified value. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace()() ` Prints this throwable and its backtrace to the standard error stream. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter)(https://developer.android.com/reference/java/io/PrintWriter s) ` Prints this throwable and its backtrace to the specified print writer. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream)(https://developer.android.com/reference/java/io/PrintStream s) ` Prints this throwable and its backtrace to the specified print stream. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[])(https://developer.android.com/reference/java/lang/StackTraceElement stackTrace) ` Sets the stack trace elements that will be returned by `https://developer.android.com/reference/java/lang/Throwable#getStackTrace()` and printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()` and related methods. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Throwable#toString()() ` Returns a short description of this throwable. | ||
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class<?>` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait()() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||

## Public constructors

### PrivilegedActionException

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public PrivilegedActionException (Exception exception)
```

Constructs a new PrivilegedActionException "wrapping"
the specific Exception.

<br />

| Parameters ||
|---|---|
| `exception` | `Exception`: The exception thrown <br /> |

## Public methods

### getCause

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Throwable getCause ()
```

Returns the cause of this exception (the exception thrown by
the privileged computation that resulted in this
`PrivilegedActionException`).

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/Throwable` | the cause of this exception. <br /> |

### getException

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public Exception getException ()
```

Returns the exception thrown by the privileged computation that
resulted in this `PrivilegedActionException`.

This method predates the general-purpose exception chaining facility.
The `https://developer.android.com/reference/java/lang/Throwable#getCause()` method is now the preferred means of
obtaining this information.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/Exception` | the exception thrown by the privileged computation that resulted in this `PrivilegedActionException`. <br /> |

**See also:**

- `https://developer.android.com/reference/java/security/PrivilegedExceptionAction`
- `https://developer.android.com/reference/java/security/AccessController#doPrivileged(java.security.PrivilegedExceptionAction<T>)`
- `https://developer.android.com/reference/java/security/AccessController#doPrivileged(java.security.PrivilegedExceptionAction<T>,%20java.security.AccessControlContext)`

### toString

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String toString ()
```

Returns a short description of this throwable.
The result is the concatenation of:

- the [name](https://developer.android.com/reference/java/lang/Class#getName()) of the class of this object
- ": " (a colon and a space)
- the result of invoking this object's `https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage()` method

If `getLocalizedMessage` returns `null`, then just the class name is returned.

<br />

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | a string representation of this throwable. <br /> |