- 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 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 theThrowable.getCause()
method, as well as the aforementioned "legacy method."
-
-
Constructor Summary
Constructors Constructor Description PrivilegedActionException(Exception exception)
Constructs a new PrivilegedActionException "wrapping" the specific Exception.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Throwable
getCause()
Returns 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 thisPrivilegedActionException
.-
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods declared in class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
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 thisPrivilegedActionException
.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)
-
-