public class

MBeanServerPermission

extends BasicPermission
java.lang.Object
   ↳ java.security.Permission
     ↳ java.security.BasicPermission
       ↳ javax.management.MBeanServerPermission

Class Overview

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 createMBeanServer() or createMBeanServer(java.lang.String).
findMBeanServer
Find an MBeanServer with a given name, or all MBeanServers in this JVM, using the method findMBeanServer(String).
newMBeanServer
Create a new MBeanServer object without keeping a reference to it, using the method newMBeanServer() or newMBeanServer(java.lang.String).
releaseMBeanServer
Remove the MBeanServerFactory's reference to an MBeanServer, using the method releaseMBeanServer(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").

Summary

Public Constructors
MBeanServerPermission(String name)

Create a new MBeanServerPermission with the given name.

MBeanServerPermission(String name, String actions)

Create a new MBeanServerPermission with the given name.

Public Methods
boolean equals(Object obj)
Checks two MBeanServerPermission objects for equality.
int hashCode()
Returns the hash code value for this object.
boolean implies(Permission p)

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

PermissionCollection newPermissionCollection()
Returns a new PermissionCollection object for storing BasicPermission objects.
[Expand]
Inherited Methods
From class java.security.BasicPermission
From class java.security.Permission
From class java.lang.Object
From interface java.security.Guard

Public Constructors

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 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 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.

Public Methods

public boolean equals (Object obj)

Checks two MBeanServerPermission objects for equality. Checks that obj is an MBeanServerPermission, and represents the same list of allowable actions as this object.

Parameters
obj the object we are testing for equality with this object.
Returns
  • true if the objects are equal.

public int hashCode ()

Returns the hash code value for this object. The hash code used is the hash code of the name, that is, getName().hashCode(), where getName is from the Permission superclass.

Returns
  • a hash code value for this object.

public boolean implies (Permission p)

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

More specifically, this method returns true if:

  • p is an instance of MBeanServerPermission,
  • p's target names are a subset of this object's target names

The createMBeanServer permission implies the newMBeanServer permission.

Parameters
p the permission to check against.
Returns
  • true if the specified permission is implied by this object, false if not.

public PermissionCollection newPermissionCollection ()

Returns a new PermissionCollection object for storing BasicPermission objects.

BasicPermission objects must be stored in a manner that allows them to be inserted in any order, but that also enables the PermissionCollection implies method to be implemented in an efficient (and consistent) manner.

Returns
  • a new PermissionCollection object suitable for storing BasicPermissions.