java.security
Class AccessControlException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by java.lang.SecurityException
                  extended by java.security.AccessControlException

@TransactionType(value=NOT_SUPPORTED)
public class AccessControlException
extends SecurityException

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.

Since:
CDC 1.0, Java Card 3.0

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

AccessControlException

public AccessControlException(String s)
Constructs an AccessControlException with the specified, detailed message.

Parameters:
s - the detail message.

AccessControlException

public AccessControlException(String s,
                              Permission p)
Constructs an AccessControlException with the specified, detailed message, and the requested permission that caused the exception.

Parameters:
s - the detail message.
p - the permission that caused the exception.
Method Detail

getPermission

public Permission getPermission()
Gets the Permission object associated with this exception, or null if there was no corresponding Permission object.

Returns:
the Permission object.


Copyright (c) 2009 Sun Microsystems, Inc. All rights reserved.