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

Untamed: 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

Field Summary

private Exception	exception
private static long	serialVersionUID

Fields inherited from class java.lang.Throwable

Constructor Summary

PrivilegedActionException(Exception exception)
Enabled: Constructs a new PrivilegedActionException "wrapping" the specific Exception.

Method Summary

Throwable	getCause() Enabled: Returns the the cause of this exception (the exception thrown by the privileged computation that resulted in this PrivilegedActionException).
Exception	getException() Enabled: Returns the exception thrown by the privileged computation that resulted in this PrivilegedActionException.
String	toString() Suppressed:

Methods inherited from class java.lang.Throwable

backtrace, eStack, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, initCause, javaStack, leaf, printStackTrace, printStackTrace, printStackTrace, printThrowableOn, setStackTrace, unwrap

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

exception

private Exception exception

Constructor Detail

PrivilegedActionException

public PrivilegedActionException(Exception exception)

Enabled: Constructs a new PrivilegedActionException "wrapping" the specific Exception.

Parameters:

exception - The exception thrown

Method Detail

getException

public Exception getException()

Enabled: 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()

Enabled: 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()

Suppressed:

Overrides:

toString in class Throwable

Returns:

a string representation of this throwable.