FileDocCategorySizeDatePackage
MBeanTrustPermission.javaAPI DocJava SE 5 API2586Fri Aug 26 14:57:32 BST 2005javax.management

MBeanTrustPermission

public class MBeanTrustPermission extends BasicPermission
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
since.unbundled
JMX 1.2

Fields Summary
private static final long
serialVersionUID
Constructors Summary
public MBeanTrustPermission(String name)

Create a new MBeanTrustPermission with the given name.

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

param
name the name of the permission. It must be "register" or "*" for this permission.
exception
NullPointerException if the name is null.
exception
IllegalArgumentException if the name is neither "register" nor "*".


            	    		         	     	      	      	      
       
        this(name, null);
    
public MBeanTrustPermission(String name, String actions)

Create a new MBeanTrustPermission with the given name.

param
name the name of the permission. It must be "register" or "*" for this permission.
param
actions the actions for the permission. It must be null or "".
exception
NullPointerException if the name is null.
exception
IllegalArgumentException if the name is neither "register" nor "*"; or if actions is a non-null non-empty string.

        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 + "]");
    
Methods Summary