Class PrivilegedActionException

public class PrivilegedActionException
extends Exception

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 getException() method is now known as the cause, and may be accessed via the Throwable.getCause() method, as well as the aforementioned "legacy method."

Constructors

PrivilegedActionException

public PrivilegedActionException(Exception exception)

Constructs a new PrivilegedActionException "wrapping" the specific Exception.

Parameters:

exception - The exception thrown

Methods

getException

public Exception getException()

Returns:

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

See Also:

PrivilegedExceptionAction, AccessController.doPrivileged(PrivilegedExceptionAction), AccessController.doPrivileged(PrivilegedExceptionAction, AccessControlContext)

getCause

public Throwable getCause()

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

Overrides:

getCause in class Throwable

Returns:

the cause of this exception.

Since:

1.4

toString

public String toString()

Description copied from class: Throwable

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

• the name of the class of this object
• ": " (a colon and a space)
• the result of invoking this object's Throwable.getLocalizedMessage() method

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

Overrides:

toString in class Throwable

Returns:

a string representation of this throwable.