java.security: public class: PrivilegedActionException

java.security
public class: PrivilegedActionException [javadoc | source]

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

All Implemented Interfaces:
Serializable

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."

Also see:

PrivilegedExceptionAction

AccessController#doPrivileged(PrivilegedExceptionAction)

AccessController#doPrivileged(PrivilegedExceptionAction,AccessControlContext)

Fields inherited from java.lang.Exception:
serialVersionUID

Constructor:

Constructor:
public PrivilegedActionException(Exception exception) { super((Throwable)null); // Disallow initCause this.exception = exception; } Constructs a new PrivilegedActionException "wrapping" the specific Exception. Parameters: `exception` - The exception thrown

 public PrivilegedActionException(Exception exception) {
        super((Throwable)null);  // Disallow initCause
        this.exception = exception;
}

Constructs a new PrivilegedActionException "wrapping" the specific Exception.

Parameters:

exception - The exception thrown

Method from java.security.PrivilegedActionException Summary:
getCause, getException, toString

Methods from java.lang.Throwable:
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getStackTraceDepth, getStackTraceElement, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from java.security.PrivilegedActionException Detail:
public Throwable getCause() { return exception; } Returns the cause of this exception (the exception thrown by the privileged computation that resulted in this `PrivilegedActionException`).
public Exception getException() { return exception; } 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.
public String toString() { String s = getClass().getName(); return (exception != null) ? (s + ": " + exception.toString()) : s; }

Method from java.security.PrivilegedActionException Detail:

 public Throwable getCause() {
        return exception;
}

PrivilegedActionException

 public Exception getException() {
        return exception;
}

PrivilegedActionException

This method predates the general-purpose exception chaining facility. The Throwable#getCause() method is now the preferred means of obtaining this information.

 public String toString() {
        String s = getClass().getName();
        return (exception != null) ? (s + ": " + exception.toString()) : s;
}