MBeanServerPermission JDK 1.6)

Description

public class MBeanServerPermission

A Permission to perform actions related to MBeanServers.

A Permission to perform actions related to MBeanServers. The name of the permission specifies the operation requested or granted by the permission. For a granted permission, it can be * to allow all of the MBeanServer operations specified below. Otherwise, for a granted or requested permission, it must be one of the following:

createMBeanServer: Create a new MBeanServer object using the method MBeanServerFactory.createMBeanServer() or MBeanServerFactory.createMBeanServer(java.lang.String).
findMBeanServer: Find an MBeanServer with a given name, or all MBeanServers in this JVM, using the method MBeanServerFactory.findMBeanServer(java.lang.String).
newMBeanServer: Create a new MBeanServer object without keeping a reference to it, using the method MBeanServerFactory.newMBeanServer() or MBeanServerFactory.newMBeanServer(java.lang.String).
releaseMBeanServer: Remove the MBeanServerFactory's reference to an MBeanServer, using the method MBeanServerFactory.releaseMBeanServer(javax.management.MBeanServer).

The name of the permission can also denote a list of one or more comma-separated operations. Spaces are allowed at the beginning and end of the name and before and after commas.

MBeanServerPermission("createMBeanServer") implies MBeanServerPermission("newMBeanServer").

See also:

Constructors

pack-private MBeanServerPermission (int mask)

public MBeanServerPermission (String name)

Create a new MBeanServerPermission with the given name.

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

Parameters:
- name - the name of the granted permission. It must respect the constraints spelt out in the description of the {@link MBeanServerPermission} class.
Throws:
- NullPointerException - if the name is null.
- IllegalArgumentException - if the name is not * or one of the allowed names or a comma-separated list of the allowed names.

public MBeanServerPermission (String name, String actions)

Create a new MBeanServerPermission with the given name.

Parameters:
- name - the name of the granted permission. It must respect the constraints spelt out in the description of the {@link MBeanServerPermission} class.
- actions - the associated actions. This parameter is not currently used and must be null or the empty string.
Throws:
- NullPointerException - if the name is null.
- IllegalArgumentException - if the name is not * or one of the allowed names or a comma-separated list of the allowed names, or if actions is a non-null non-empty string.
- NullPointerException - if name is null.
- IllegalArgumentException - if name is empty or if arguments are invalid.

Methods

Hide/Show inherited methods

public void checkGuard (Object object) throws SecurityException [Inherited From Permission]

Implements the guard interface for a permission.

Implements the guard interface for a permission. The
SecurityManager.checkPermission method is called,
passing this permission object as the permission to check.
Returns silently if access is granted. Otherwise, throws
a SecurityException.
Parameters:
- object - the object being guarded (currently ignored).
Throws:
- SecurityException - if a security manager exists and its checkPermission method doesn't allow access.
See Also: Guard, GuardedObject, SecurityManager.checkPermission(java.security.Permission),

public boolean equals (Object obj) [Overrides BasicPermission] [Specified in Permission]

Checks two MBeanServerPermission objects for equality.

public String getActions () [Inherited From BasicPermission] [Specified in Permission]

Returns the canonical string representation of the actions, which currently is the empty string "", since there are no actions for a BasicPermission.

pack-privatestatic String getCanonicalName (int mask)

publicfinal String getName () [Inherited From Permission]

Returns the name of this Permission.

Returns the name of this Permission.
For example, in the case of a java.io.FilePermission,
the name will be a pathname.
Returns: the name of this Permission.

public int hashCode () [Overrides BasicPermission] [Specified in Permission]

pack-privatestatic int impliedMask (int mask)

public boolean implies (Permission p) [Overrides BasicPermission] [Specified in Permission]

Checks if this MBeanServerPermission object "implies" the specified permission.

public PermissionCollection newPermissionCollection () [Overrides BasicPermission]

pack-privatestatic int simplifyMask (int mask)

public String toString () [Inherited From Permission]

Returns a string describing this Permission.