Class MBeanServerPermission

java.lang.Object
java.security.Permission
java.security.BasicPermission
javax.management.MBeanServerPermission
All Implemented Interfaces:
Serializable, Guard
@Deprecated(since="25", forRemoval=true) public class MBeanServerPermission extends BasicPermission
Deprecated, for removal: This API element is subject to removal in a future version.
This class was only useful in conjunction with the Security Manager, which is no longer supported. There is no replacement for this class.
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(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(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").

API Note:
This permission cannot be used for controlling access to resources as the Security Manager is no longer supported. Consequently this class is deprecated for removal in a future release.
Since:
1.5
See Also:

  • Constructor Summary

    Constructors
    Constructor
    Description
    MBeanServerPermission(String name)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Create a new MBeanServerPermission with the given name.
    MBeanServerPermission(String name, String actions)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Create a new MBeanServerPermission with the given name.

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    equals(Object obj)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Checks two MBeanServerPermission objects for equality.
    int
    hashCode()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Returns the hash code value for this object.
    boolean
    implies(Permission p)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Checks if this MBeanServerPermission object "implies" the specified permission.
    PermissionCollection
    newPermissionCollection()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Returns a new PermissionCollection object for storing BasicPermission objects.

    Methods inherited from class BasicPermission

    getActions

    Methods inherited from class Permission

    checkGuard, getName, toString

    Methods inherited from class Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • Constructor Details

    • MBeanServerPermission

      public MBeanServerPermission(String name)
      Deprecated, for removal: This API element is subject to removal in a future version.

      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.

    • MBeanServerPermission

      public MBeanServerPermission(String name, String actions)
      Deprecated, for removal: This API element is subject to removal in a future version.

      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.

  • Method Details

    • hashCode

      public int hashCode()
      Deprecated, for removal: This API element is subject to removal in a future version.
      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(), where getName is from the Permission superclass.
      Overrides:
      hashCode in class BasicPermission
      Returns:
      the hash code value for this object
      See Also:

    • implies

      public boolean implies(Permission p)
      Deprecated, for removal: This API element is subject to removal in a future version.

      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.

      Overrides:
      implies in class BasicPermission
      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)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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 class BasicPermission
      Parameters:
      obj - the object we are testing for equality with this object.
      Returns:
      true if the objects are equal.
      See Also:

    • newPermissionCollection

      public PermissionCollection newPermissionCollection()
      Deprecated, for removal: This API element is subject to removal in a future version.
      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(Permission) method to be implemented in an efficient (and consistent) manner.

      Overrides:
      newPermissionCollection in class BasicPermission
      Returns:
      a new PermissionCollection object suitable for storing BasicPermission objects.