java.lang.Object
java.security.Permission
java.security.BasicPermission
javax.management.MBeanServerPermission
- All Implemented Interfaces:
Serializable,Guard
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()orMBeanServerFactory.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()orMBeanServerFactory.newMBeanServer(java.lang.String). - releaseMBeanServer
- Remove the MBeanServerFactory's reference to an MBeanServer,
using the method
MBeanServerFactory.releaseMBeanServer(javax.management.MBeanServer).
MBeanServerPermission("createMBeanServer") implies
MBeanServerPermission("newMBeanServer").
- Since:
- 1.5
- See Also:
-
Constructor Summary
ConstructorsConstructorDescriptionMBeanServerPermission(String name) Create a new MBeanServerPermission with the given name.MBeanServerPermission(String name, String actions) Create a new MBeanServerPermission with the given name. -
Method Summary
Modifier and TypeMethodDescriptionbooleanChecks two MBeanServerPermission objects for equality.booleanChecks if this MBeanServerPermission object "implies" the specified permission.Methods declared in class java.security.BasicPermission
getActions, hashCode, newPermissionCollectionMethods declared in class java.security.Permission
checkGuard, getName, toString
-
Constructor Details
-
MBeanServerPermission
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 theMBeanServerPermissionclass.- 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.
-
MBeanServerPermission
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 theMBeanServerPermissionclass.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 ifactionsis a non-null non-empty string.NullPointerException- ifnameisnull.IllegalArgumentException- ifnameis empty or if arguments are invalid.
-
-
Method Details
-
implies
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
createMBeanServerpermission implies thenewMBeanServerpermission.- Overrides:
impliesin classBasicPermission- Parameters:
p- the permission to check against.- Returns:
- true if the specified permission is implied by this object, false if not.
-
equals
Checks two MBeanServerPermission objects for equality. Checks that obj is an MBeanServerPermission, and represents the same list of allowable actions as this object.- Overrides:
equalsin classBasicPermission- Parameters:
obj- the object we are testing for equality with this object.- Returns:
- true if the objects are equal.
- See Also:
-