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."
- Since:
- 1.2
- See Also:
-
PrivilegedExceptionAction
,AccessController.doPrivileged(PrivilegedExceptionAction)
,AccessController.doPrivileged(PrivilegedExceptionAction,AccessControlContext)
, Serialized Form
Constructors
Constructor | Description |
---|---|
PrivilegedActionException(Exception exception) | Constructs a new PrivilegedActionException "wrapping" the specific Exception. |
Methods
Modifier and Type | Method | Description |
---|---|---|
Throwable | getCause() | Returns the cause of this exception (the exception thrown by the privileged computation that resulted in this |
Exception | getException() | Returns the exception thrown by the privileged computation that resulted in this |
Methods declared in class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Constructors
PrivilegedActionException
public PrivilegedActionException(Exception exception)
Constructs a new PrivilegedActionException "wrapping" the specific Exception.
- Parameters:
-
exception
- The exception thrown
Methods
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 cause of this exception (the exception thrown by the privileged computation that resulted in this PrivilegedActionException
).
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/security/PrivilegedActionException.html