javax.management: public class: MBeanTrustPermission

javax.management
public class: MBeanTrustPermission [javadoc | source]

java.lang.Object
   java.security.Permission
      java.security.BasicPermission
         javax.management.MBeanTrustPermission

All Implemented Interfaces:
Serializable, Guard

This permission represents "trust" in a signer or codebase.

MBeanTrustPermission contains a target name but no actions list. A single target name, "register", is defined for this permission. The target "*" is also allowed, permitting "register" and any future targets that may be defined. Only the null value or the empty string are allowed for the action to allow the policy object to create the permissions specified in the policy file.

If a signer, or codesource is granted this permission, then it is considered a trusted source for MBeans. Only MBeans from trusted sources may be registered in the MBeanServer.

since: 1.5 -

Constructor:

Constructor:
public MBeanTrustPermission(String name) { this(name, null); } Create a new MBeanTrustPermission with the given name. This constructor is equivalent to `MBeanTrustPermission(name,null)`. Parameters: `name` - the name of the permission. It must be "register" or "" for this permission. Throws:* `NullPointerException` - if `name` is `null`. `IllegalArgumentException` - if `name` is neither "register" nor "*".
public MBeanTrustPermission(String name, String actions) { super(name, actions); /* Check that actions is a null empty string / if (actions != null && actions.length() > 0) throw new IllegalArgumentException("MBeanTrustPermission " + "actions must be null: " + actions); if (!name.equals("register") && !name.equals("")) throw new IllegalArgumentException("MBeanTrustPermission: " + "Unknown target name " + "[" + name + "]"); } Create a new MBeanTrustPermission with the given name. Parameters: `name` - the name of the permission. It must be "register" or "" for this permission. `actions` - the actions for the permission. It must be null or `""`. Throws:* `NullPointerException` - if `name` is `null`. `IllegalArgumentException` - if `name` is neither "register" nor "*"; or if `actions` is a non-null non-empty string.

 public MBeanTrustPermission(String name) {
                                                                                  
        this(name, null);
}

Create a new MBeanTrustPermission with the given name.

This constructor is equivalent to MBeanTrustPermission(name,null).

Parameters:

name - the name of the permission. It must be "register" or "*" for this permission.

Throws:

NullPointerException - if name is null.

IllegalArgumentException - if name is neither "register" nor "*".

 public MBeanTrustPermission(String name,
    String actions) {
        super(name, actions);
        /* Check that actions is a null empty string */
        if (actions != null && actions.length()  > 0)
            throw new IllegalArgumentException("MBeanTrustPermission " +
                                               "actions must be null: " +
                                               actions);
        if (!name.equals("register") && !name.equals("*"))
            throw new IllegalArgumentException("MBeanTrustPermission: " +
                                               "Unknown target name " +
                                               "[" + name + "]");
}

Create a new MBeanTrustPermission with the given name.

Parameters:

name - the name of the permission. It must be "register" or "*" for this permission.

actions - the actions for the permission. It must be null or "".

Throws:

NullPointerException - if name is null.

IllegalArgumentException - if name is neither "register" nor "*"; or if actions is a non-null non-empty string.

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