AccessControlException

  • AccessControlException signals a denied access request to a critical system resource like the file system or network.

  • Denial reasons can include incorrect permission type, invalid values, or violations of the security policy.

  • It provides constructors to detail the exception with a message and optionally, the specific denied permission.

  • The getPermission() method retrieves the associated Permission object, if available.

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.

Public 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.

Public Method Summary

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

Inherited Method Summary

Public Constructors

public AccessControlException (String s)

Constructs an AccessControlException with the specified, detailed message.

Parameters
s the detail message.

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.

Public Methods

public Permission getPermission ()

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

Returns
  • the Permission object.