PrivilegedActionException (Java Platform SE 8 ) (original) (raw)

• 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 the Throwable.getCause() method, as well as the aforementioned "legacy method."
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 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](../../java/lang/Throwable.html "class in java.lang")  
     `[addSuppressed](../../java/lang/Throwable.html#addSuppressed-java.lang.Throwable-), [fillInStackTrace](../../java/lang/Throwable.html#fillInStackTrace--), [getLocalizedMessage](../../java/lang/Throwable.html#getLocalizedMessage--), [getMessage](../../java/lang/Throwable.html#getMessage--), [getStackTrace](../../java/lang/Throwable.html#getStackTrace--), [getSuppressed](../../java/lang/Throwable.html#getSuppressed--), [initCause](../../java/lang/Throwable.html#initCause-java.lang.Throwable-), [printStackTrace](../../java/lang/Throwable.html#printStackTrace--), [printStackTrace](../../java/lang/Throwable.html#printStackTrace-java.io.PrintStream-), [printStackTrace](../../java/lang/Throwable.html#printStackTrace-java.io.PrintWriter-), [setStackTrace](../../java/lang/Throwable.html#setStackTrace-java.lang.StackTraceElement:A-)`  
     * ### Methods inherited from class java.lang.[Object](../../java/lang/Object.html "class in java.lang")  
     `[clone](../../java/lang/Object.html#clone--), [equals](../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../java/lang/Object.html#finalize--), [getClass](../../java/lang/Object.html#getClass--), [hashCode](../../java/lang/Object.html#hashCode--), [notify](../../java/lang/Object.html#notify--), [notifyAll](../../java/lang/Object.html#notifyAll--), [wait](../../java/lang/Object.html#wait--), [wait](../../java/lang/Object.html#wait-long-), [wait](../../java/lang/Object.html#wait-long-int-)`

• • Constructor Detail

     * #### PrivilegedActionException  
     public PrivilegedActionException([Exception](../../java/lang/Exception.html "class in java.lang") exception)  
     Constructs a new PrivilegedActionException "wrapping" the specific Exception.  
     Parameters:  
     `exception` \- The exception thrown  

  • Method Detail

    * #### getException  
    public [Exception](../../java/lang/Exception.html "class in java.lang") 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()](../../java/lang/Throwable.html#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](../../java/security/PrivilegedExceptionAction.html "interface in java.security"), [AccessController.doPrivileged(PrivilegedExceptionAction)](../../java/security/AccessController.html#doPrivileged-java.security.PrivilegedExceptionAction-), [AccessController.doPrivileged(PrivilegedExceptionAction, AccessControlContext)](../../java/security/AccessController.html#doPrivileged-java.security.PrivilegedExceptionAction-java.security.AccessControlContext-)  
    * #### getCause  
    public [Throwable](../../java/lang/Throwable.html "class in java.lang") getCause()  
    Returns the cause of this exception (the exception thrown by the privileged computation that resulted in this`PrivilegedActionException`).  
    Overrides:  
    `[getCause](../../java/lang/Throwable.html#getCause--)` in class `[Throwable](../../java/lang/Throwable.html "class in java.lang")`  
    Returns:  
    the cause of this exception.  
    Since:  
    1.4  
    * #### toString  
    public [String](../../java/lang/String.html "class in java.lang") toString()  
    Description copied from class: `[Throwable](../../java/lang/Throwable.html#toString--)`  
    Returns a short description of this throwable. The result is the concatenation of:  
             * the [name](../../java/lang/Class.html#getName--) of the class of this object  
             * ": " (a colon and a space)  
             * the result of invoking this object's [Throwable.getLocalizedMessage()](../../java/lang/Throwable.html#getLocalizedMessage--) method  
     If `getLocalizedMessage` returns `null`, then just the class name is returned.  
    Overrides:  
    `[toString](../../java/lang/Throwable.html#toString--)` 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 SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.