|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
java.lang.SecurityException
java.security.AccessControlException
@TransactionType(value=NOT_SUPPORTED) public class AccessControlException
This exception is thrown by the AccessController to indicate that a requested access (to a critical system resource such as the file system or the network) is denied.
The reason to deny access can vary. For example, the requested permission might be of an incorrect type, contain an invalid value, or request access that is not allowed according to the security policy. Such information should be given whenever possible at the time the exception is thrown.
This Java Card class is a subset of the CDC 1.1 AccessControlException class. Some interfaces, methods and/or variables have been pruned, and/or other methods simplified, in an effort to reduce the size of this class and/or eliminate dependencies on unsupported features.
Direct instances of this exception class are not bound to any context and can be
passed between contexts without any restrictions. Objects created and returned
by the methods of this class are owned by the caller. In particular, a call to the Throwable.getMessage()
returns a String instance bound to the owner context of the caller.
See Runtime Environment Specification for the Java Card Platform, Connected Edition, chapter 7 for details regarding transfer of ownership.
Constructor Summary | |
---|---|
AccessControlException(String s)
Constructs an AccessControlException with the specified,
detailed message. |
|
AccessControlException(String s,
Permission p)
Constructs an AccessControlException with the specified,
detailed message, and the requested permission that caused the exception. |
Method Summary | |
---|---|
Permission |
getPermission()
Gets the Permission object associated with this exception, or null if there was no corresponding Permission object. |
Methods inherited from class java.lang.Throwable |
---|
getMessage, printStackTrace, toString |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public AccessControlException(String s)
AccessControlException
with the specified,
detailed message.
s
- the detail message.public AccessControlException(String s, Permission p)
AccessControlException
with the specified,
detailed message, and the requested permission that caused the exception.
s
- the detail message.p
- the permission that caused the exception.Method Detail |
---|
public Permission getPermission()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |