PrivilegedActionException
public
class
PrivilegedActionException
extends Exception
java.lang.Object | |||
↳ | java.lang.Throwable | ||
↳ | java.lang.Exception | ||
↳ | java.security.PrivilegedActionException |
Legacy security code; do not use.
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."
See also:
Summary
Public constructors | |
---|---|
PrivilegedActionException(Exception exception)
Constructs a new PrivilegedActionException "wrapping" the specific Exception. |
Public methods | |
---|---|
Throwable
|
getCause()
Returns the cause of this exception (the exception thrown by
the privileged computation that resulted in this
|
Exception
|
getException()
Returns the exception thrown by the privileged computation that
resulted in this |
String
|
toString()
Returns a short description of this throwable. |
Inherited methods | |
---|---|
Public constructors
PrivilegedActionException
public PrivilegedActionException (Exception exception)
Constructs a new PrivilegedActionException "wrapping" the specific Exception.
Parameters | |
---|---|
exception |
Exception : The exception thrown |
Public methods
getCause
public Throwable getCause ()
Returns the cause of this exception (the exception thrown by
the privileged computation that resulted in this
PrivilegedActionException
).
Returns | |
---|---|
Throwable |
the cause of this exception. |
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 | |
---|---|
Exception |
the exception thrown by the privileged computation that
resulted in this PrivilegedActionException . |
toString
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
getLocalizedMessage
returns null
, then just
the class name is returned.
Returns | |
---|---|
String |
a string representation of this throwable. |