FileDocCategorySizeDatePackage
PrivilegedActionException.javaAPI DocJava SE 5 API3208Fri Aug 26 14:57:16 BST 2005java.security

PrivilegedActionException

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 {@link #getException()} method is now known as the cause, and may be accessed via the {@link Throwable#getCause()} method, as well as the aforementioned "legacy method."

see
PrivilegedExceptionAction
see
AccessController#doPrivileged(PrivilegedExceptionAction)
see
AccessController#doPrivileged(PrivilegedExceptionAction,AccessControlContext)

Fields Summary
private static final long
serialVersionUID
private Exception
exception
Constructors Summary
public PrivilegedActionException(Exception exception)
Constructs a new PrivilegedActionException "wrapping" the specific Exception.

param
exception The exception thrown


                      
       
	super((Throwable)null);  // Disallow initCause
        this.exception = exception;
Methods Summary
public java.lang.ThrowablegetCause()
Returns the the cause of this exception (the exception thrown by the privileged computation that resulted in this PrivilegedActionException).

return
the cause of this exception.
since
1.4

        return exception;
public java.lang.ExceptiongetException()
Returns the exception thrown by the privileged computation that resulted in this PrivilegedActionException.

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

return
the exception thrown by the privileged computation that resulted in this PrivilegedActionException.
see
PrivilegedExceptionAction
see
AccessController#doPrivileged(PrivilegedExceptionAction)
see
AccessController#doPrivileged(PrivilegedExceptionAction, AccessControlContext)

	return exception;
public java.lang.StringtoString()

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