AccessControlException (Java Card API, Connected Edition)
Date: 2009-12-11

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## java.security
Class AccessControlException

    java.lang.Object
      java.lang.Throwable
          java.lang.Exception
              java.lang.RuntimeException
                  java.lang.SecurityException
                      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.

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

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