Home Original page

PrivilegedActionException (Java SE 10 & JDK 10 )

  • 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
    • 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 this PrivilegedActionException).

      Exception getException()

      Returns the exception thrown by the privileged computation that resulted in this PrivilegedActionException.

      • 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 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).

        Overrides:
        getCause in class Throwable
        Returns:
        the cause of this exception.
        Since:
        1.4

Report a bug or suggest an enhancement
For further API reference and developer documentation see the Java SE Documentation, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples.
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2018, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. Use is subject to license terms and the documentation redistribution policy.