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 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 thegetExceptionmethod. In effect, anPrivilegedActionExceptionis 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 and Description PrivilegedActionException(Exception exception)Constructs a new PrivilegedActionException "wrapping" the specific Exception.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description ThrowablegetCause()Returns the cause of this exception (the exception thrown by the privileged computation that resulted in thisPrivilegedActionException).ExceptiongetException()Returns the exception thrown by the privileged computation that resulted in thisPrivilegedActionException.StringtoString()Returns a short description of this throwable.-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
-
-
-
-
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)
getCause
public Throwable getCause()
Returns the cause of this exception (the exception thrown by the privileged computation that resulted in thisPrivilegedActionException).
toString
public String toString()
Description copied from class:ThrowableReturns 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
getLocalizedMessagereturnsnull, then just the class name is returned.
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
