java.util.logging: public final class: LoggingPermission

java.util.logging
public final class: LoggingPermission [javadoc | source]

java.lang.Object
   java.security.Permission
      java.security.BasicPermission
         java.util.logging.LoggingPermission

All Implemented Interfaces:
Serializable, Guard

The permission which the SecurityManager will check when code that is running with a SecurityManager calls one of the logging control methods (such as Logger.setLevel).

Currently there is only one named LoggingPermission. This is "control" and it grants the ability to control the logging configuration, for example by adding or removing Handlers, by adding or removing Filters, or by changing logging levels.

Programmers do not normally create LoggingPermission objects directly. Instead they are created by the security policy code based on reading the security policy file.

Also see:

java.security.BasicPermission

java.security.Permission

java.security.Permissions

java.security.PermissionCollection

java.lang.SecurityManager

since: 1.4 -

Constructor:

Constructor:
public LoggingPermission(String name, String actions) throws IllegalArgumentException { super(name); if (!name.equals("control")) { throw new IllegalArgumentException("name: " + name); } if (actions != null && actions.length() > 0) { throw new IllegalArgumentException("actions: " + actions); } } Creates a new LoggingPermission object. Parameters: `name` - Permission name. Must be "control". `actions` - Must be either null or the empty string. Throws: `NullPointerException` - if `name` is `null`. `IllegalArgumentException` - if `name` is empty or if arguments are invalid.

 public LoggingPermission(String name,
    String actions) throws IllegalArgumentException {
                                                 
        super(name);
        if (!name.equals("control")) {
            throw new IllegalArgumentException("name: " + name);
        }
        if (actions != null && actions.length()  > 0) {
            throw new IllegalArgumentException("actions: " + actions);
        }
}

Creates a new LoggingPermission object.

Parameters:

name - Permission name. Must be "control".

actions - Must be either null or the empty string.

Throws:

NullPointerException - if name is null.

IllegalArgumentException - if name is empty or if arguments are invalid.

Methods from java.security.BasicPermission:
equals, getActions, getCanonicalName, hashCode, implies, newPermissionCollection

Methods from java.security.Permission:
checkGuard, equals, getActions, getName, hashCode, implies, newPermissionCollection, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait