PrivilegedActionException (Java 2 Platform SE 5.0) (original) (raw)

java.security

Class PrivilegedActionException

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

All Implemented Interfaces:

public class PrivilegedActionException

This exception is thrown bydoPrivileged(PrivilegedExceptionAction) anddoPrivileged(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 thegetException method. In effect, anPrivilegedActionException 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)](../../java/security/AccessController.html#doPrivileged%28java.security.PrivilegedExceptionAction, java.security.AccessControlContext%29), Serialized Form

Constructor Summary
PrivilegedActionException(Exception exception) Constructs a new PrivilegedActionException "wrapping" the specific Exception.

Method Summary
Throwable	getCause() Returns the the cause of this exception (the exception thrown by the privileged computation that resulted in thisPrivilegedActionException).
Exception	getException() Returns the exception thrown by the privileged computation that resulted in this PrivilegedActionException.
String	toString() Returns a short description of this throwable.

Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, [wait](../../java/lang/Object.html#wait%28long, int%29)

Constructor Detail

PrivilegedActionException

public PrivilegedActionException(Exception exception)

Constructs a new PrivilegedActionException "wrapping" the specific Exception.

Parameters:

exception - The exception thrown

Method Detail

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)](../../java/security/AccessController.html#doPrivileged%28java.security.PrivilegedExceptionAction, java.security.AccessControlContext%29)

getCause

public Throwable getCause()

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

Overrides:

[getCause](../../java/lang/Throwable.html#getCause%28%29) in class [Throwable](../../java/lang/Throwable.html "class in java.lang")

Returns:

the cause of this exception.

Since:

1.4

toString

public String toString()

Description copied from class: [Throwable](../../java/lang/Throwable.html#toString%28%29)

Returns a short description of this throwable. If this Throwable object was created with a non-null detail message string, then the result is the concatenation of three strings:

The name of the actual class of this object
": " (a colon and a space)
The result of the Throwable.getMessage() method for this object If this Throwable object was created with a null detail message string, then the name of the actual class of this object is returned.

Overrides:

[toString](../../java/lang/Throwable.html#toString%28%29) in class [Throwable](../../java/lang/Throwable.html "class in java.lang")

Returns:

a string representation of this throwable.

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.