Class MBeanServerPermission
- java.lang.Object
-
- java.security.Permission
-
- java.security.BasicPermission
-
- javax.management.MBeanServerPermission
-
- All Implemented Interfaces:
- Serializable, Guard
public class MBeanServerPermission extends BasicPermission
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")
impliesMBeanServerPermission("newMBeanServer")
.- Since:
- 1.5
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description MBeanServerPermission(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
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description 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.-
Methods inherited from class java.security.BasicPermission
getActions
-
Methods inherited from class java.security.Permission
checkGuard, getName, toString
-
-
-
-
Constructor Detail
MBeanServerPermission
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 theMBeanServerPermission
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.
MBeanServerPermission
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 theMBeanServerPermission
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 ifactions
is a non-null non-empty string. -
NullPointerException
- ifname
isnull
. -
IllegalArgumentException
- ifname
is empty or if arguments are invalid.
-
Method Detail
hashCode
public int hashCode()
Description copied from class:BasicPermission
Returns the hash code value for this object. The hash code used is the hash code of the name, that is,getName().hashCode()
, wheregetName
is from the Permission superclass.- Overrides:
-
hashCode
in classBasicPermission
- Returns:
- a hash code value for this object.
- See Also:
-
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
implies
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 thenewMBeanServer
permission.- Overrides:
-
implies
in classBasicPermission
- Parameters:
-
p
- the permission to check against. - Returns:
- true if the specified permission is implied by this object, false if not.
equals
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.- Overrides:
-
equals
in classBasicPermission
- Parameters:
-
obj
- the object we are testing for equality with this object. - Returns:
- true if the objects are equal.
- See Also:
-
Object.hashCode()
,HashMap
newPermissionCollection
public PermissionCollection newPermissionCollection()
Description copied from class:BasicPermission
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.- Overrides:
-
newPermissionCollection
in classBasicPermission
- Returns:
- a new PermissionCollection object suitable for storing BasicPermissions.
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.