java.security
Class PrivilegedActionException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.security.PrivilegedActionException

All Implemented Interfaces:

Serializable

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."

See Also:

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

PrivilegedActionException

public PrivilegedActionException(Exception exception)

Constructs a new PrivilegedActionException "wrapping" the specific Exception.

Parameters:

exception - The exception thrown

getException

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 Throwable.getCause() method is now the preferred means of obtaining this information.

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 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: If this Throwable object was created with a non-null detail message string, then the result is the concatenation of three strings:

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

If If this Throwable object was created with a getLocalizedMessage returns null , then just the class name is returned. detail message string, then the name of the actual class of this object is returned.

Overrides:

toString in class Throwable

Returns:

a string representation of this throwable.