JavaTM Platform
Standard Ed. 6

javax.management
类 MBeanServerPermission

java.lang.Object
  继承者 java.security.Permission
      继承者 java.security.BasicPermission
          继承者 javax.management.MBeanServerPermission
所有已实现的接口:
Serializable, Guard

public class MBeanServerPermission
extends BasicPermission

执行与 MBeanServer 关联的操作的 Permission。权限名称 指定了所请求的操作或该权限允许的操作。对于某项目已授予的权限,该名称可以是 *,表示允许下面指定的所有 MBeanServer 操作。否则,对于授予的权限或请求的权限,它必须是下列之一:

createMBeanServer
使用方法 MBeanServerFactory.createMBeanServer()MBeanServerFactory.createMBeanServer(java.lang.String) 创建新的 MBeanServer 对象。
findMBeanServer
使用方法 MBeanServerFactory.findMBeanServer(java.lang.String) 查找此 JVM 中具有给定名称的 MBeanServer 或所有 MBeanServer。
newMBeanServer
使用方法 MBeanServerFactory.newMBeanServer()MBeanServerFactory.newMBeanServer(java.lang.String) 创建新的 MBeanServer 对象,并且不保持对该对象的引用。
releaseMBeanServer
使用方法 MBeanServerFactory.releaseMBeanServer(javax.management.MBeanServer) 移除 MBeanServerFactory 对 MBeanServer 的引用。
权限名称 也可表示一个或多个逗号分隔的操作列表。该名称 的开始和结束以及逗号前后都允许使用空格。

MBeanServerPermission("createMBeanServer") 隐含 MBeanServerPermission("newMBeanServer")

从以下版本开始:
1.5
另请参见:
序列化表格

构造方法摘要
MBeanServerPermission(String name)
          创建具有给定名称的新 MBeanServerPermission。
MBeanServerPermission(String name, String actions)
          创建具有给定名称的新 MBeanServerPermission。
 
方法摘要
 boolean equals(Object obj)
          检查两个 MBeanServerPermission 对象的相等性。
 int hashCode()
          返回此对象的哈希码值。
 boolean implies(Permission p)
          检查此 MBeanServerPermission 对象是否“隐含”指定的权限。
 PermissionCollection newPermissionCollection()
          用于存储 BasicPermission 对象的新 PermissionCollection 对象。
 
从类 java.security.BasicPermission 继承的方法
getActions
 
从类 java.security.Permission 继承的方法
checkGuard, getName, toString
 
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

MBeanServerPermission

public MBeanServerPermission(String name)

创建具有给定名称的新 MBeanServerPermission。

此构造方法等效于 MBeanServerPermission(name,null)

参数:
name - 所授予权限的名称。它必须服从 MBeanServerPermission 类的描述中所声明的约束。
抛出:
NullPointerException - 如果 name 为 null。
IllegalArgumentException - 如果 name 不是 * 或者某个允许的名称或逗号分隔的允许名称列表。

MBeanServerPermission

public MBeanServerPermission(String name,
                             String actions)

创建具有给定名称的新 MBeanServerPermission。

参数:
name - 所授予权限的名称。它必须服从 MBeanServerPermission 类的描述中所声明的约束。
actions - 关联的操作。目前未使用此参数,必须为 null 或空字符串。
抛出:
NullPointerException - 如果 name 为 null。
IllegalArgumentException - 如果 name 不是 * 或某个允许的名称或逗号分隔的允许名称列表,或者如果 actions 是非 null 非空的字符串。
NullPointerException - 如果 namenull
IllegalArgumentException - 如果 name 为空或者参数无效。
方法详细信息

hashCode

public int hashCode()
从类 BasicPermission 复制的描述
返回此对象的哈希码值。所用的哈希码是名称的哈希码,也就是 getName().hashCode(),其中 getName 来自 Permission 超类。

覆盖:
BasicPermission 中的 hashCode
返回:
此对象的哈希码值。
另请参见:
Object.equals(java.lang.Object), Hashtable

implies

public boolean implies(Permission p)

检查此 MBeanServerPermission 对象是否“隐含”指定的权限。

更确切地说,如果此方法满足以下条件,则返回 true:

createMBeanServer 权限隐含 newMBeanServer 权限。

覆盖:
BasicPermission 中的 implies
参数:
p - 所要检查的权限。
返回:
如果此对象隐含指定的权限,则返回 true;否则返回 false。

equals

public boolean equals(Object obj)
检查两个 MBeanServerPermission 对象的相等性。检查该 obj 是否为 MBeanServerPermission 且表示与此对象相同的可允许操作列表。

覆盖:
BasicPermission 中的 equals
参数:
obj - 要与此对象进行相等性测试的对象。
返回:
如果两个对象是相等的,返回 true。
另请参见:
Object.hashCode(), Hashtable

newPermissionCollection

public PermissionCollection newPermissionCollection()
从类 BasicPermission 复制的描述
用于存储 BasicPermission 对象的新 PermissionCollection 对象。

BasicPermissionCollection 存储 BasicPermission 权限的集合。

BasicPermission 对象必须以允许将它们按任意顺序插入的方式来存储,但同时也允许以有效(并一致)的方式实现 PermissionCollection 的 implies 方法。

覆盖:
BasicPermission 中的 newPermissionCollection
返回:
适合存储 BasicPermissions 的新 PermissionCollection 对象。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策