JavaTM 2 Platform
Standard Ed. 5.0

javax.management
Class MBeanTrustPermission

java.lang.Object
  extended by java.security.Permission
      extended by java.security.BasicPermission
          extended by javax.management.MBeanTrustPermission
All Implemented Interfaces:
Serializable, Guard

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
See Also:
Serialized Form

Constructor Summary
MBeanTrustPermission(String name)
          Create a new MBeanTrustPermission with the given name.
MBeanTrustPermission(String name, String actions)
          Create a new MBeanTrustPermission with the given name.
 
Method Summary
 
Methods inherited from class java.security.BasicPermission
equals, getActions, hashCode, implies, newPermissionCollection
 
Methods inherited from class java.security.Permission
checkGuard, getName, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

MBeanTrustPermission

public MBeanTrustPermission(String name)

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 the name is null.
IllegalArgumentException - if the name is neither "register" nor "*".

MBeanTrustPermission

public MBeanTrustPermission(String name,
                            String actions)

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 the name is null.
IllegalArgumentException - if the name is neither "register" nor "*"; or if actions is a non-null non-empty string.

JavaTM 2 Platform
Standard Ed. 5.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.