public class

PrivilegedActionException

extends Exception
java.lang.Object
   ↳ java.lang.Throwable
     ↳ java.lang.Exception
       ↳ java.security.PrivilegedActionException

Class Overview

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 getCause() method, as well as the aforementioned "legacy method."

Summary

Public Constructors
PrivilegedActionException(Exception exception)
Constructs a new PrivilegedActionException "wrapping" the specific Exception.
Public Methods
Throwable getCause()
Returns the 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.
String toString()
Returns a short description of this throwable.
[Expand]
Inherited Methods
From class java.lang.Throwable
From class java.lang.Object

Public Constructors

public PrivilegedActionException (Exception exception)

Constructs a new PrivilegedActionException "wrapping" the specific Exception.

Parameters
exception The exception thrown

Public Methods

public Throwable getCause ()

Returns the the cause of this exception (the exception thrown by the privileged computation that resulted in this PrivilegedActionException).

Returns
  • the cause of this exception.

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 getCause() method is now the preferred means of obtaining this information.

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

public String toString ()

Returns 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 getLocalizedMessage() method
If getLocalizedMessage returns null, then just the class name is returned.

Returns
  • a string representation of this throwable.