MBeanPermission

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.management
类 MBeanPermission

java.lang.Object
  java.security.Permission
      javax.management.MBeanPermission

所有已实现的接口：: Serializable, Guard

public class MBeanPermission
extends Permission

权限控制对 MBeanServer 操作的访问。如果已使用 System.setSecurityManager(java.lang.SecurityManager) 设置了安全管理器，则 MBeanServer 上的多数操作都需要调用者的权限隐含了适用于该操作的 MBeanPermission。MBeanServer 接口的文档中对此进行了详细描述。

与其他 Permission 对象一样，MBeanPermission 可以表示所拥有的权限，或者是所需要的权限。当检查某个敏感操作的权限时，会构造一个表示所需权限的 MBeanPermission。仅在所拥有的权限隐含所需的权限时才允许该操作。

MBeanPermission 包含四项信息：

操作。对于所需的权限，这是下面列表中的某种操作。对于所拥有的权限，则是这些操作的列表，各项以逗号分隔，或者是 *，表示所有操作。

通过 getActions() 返回操作。
类名。

对于所需的权限，这是正在访问的 MBean 的类名，正如 MBeanServer.getMBeanInfo(name) 和 getClassName() 所返回的一样。某些操作不引用类名，在这种情况下类名为 null。

对于所拥有的权限，这是空或一个类名模式。类名模式是一个服从 Java 对点分类名约定的 string。该模式可以以 ".*" 结尾，意味着该权限允许对名称以 ".*" 前面的字符串开始的类的访问。例如，"javax.management.*" 允许对其他类中的 javax.management.MBeanServerDelegate 和 javax.management.timer.Timer 进行访问。

类名模式也可以为空，或者只有单个字符 "*"，这两种情况都允许对任何类的访问。
成员。

对于所需的权限，这是正在访问的属性或操作名。对于没有引用属性或操作的操作，该成员为 null。

对于所拥有的权限，这要么是可以访问的属性或操作名，要么是空或单个字符 "*"，后面这两种情况都允许对任意成员的访问。
对象名。

对于所需的权限，这是正在访问的 MBean 的 ObjectName。对于不引用单个 MBean 的操作而言，对象名为 null。它永远不会是对象名模式。

对于所拥有的权限，这是可访问的 MBean 或 MBeans 的 ObjectName。可以是一个对象名模式，以允许访问其名称匹配该模式的所有 MBean。还可以为空，这样可访问所有 MBean 而不管其名称是什么。

如果拥有 MBeanPermission，则它只允许这四项都匹配的操作。

可将类名、成员和对象名一同写入单个字符串，这就是此权限的名称。权限的名称是 getName() 所返回的字符串。该字符串的格式为：

className#member[objectName]

使用常规的 ObjectName 语法写对象名称。它可包含任意合法字符，包括 ]。由字符串中最后一个 ] 字符终止该字符串。

可省略一个或多个 className、member 或 objectName。如果省略的 member，则 # 也可省略（但并非必须如此）。如果省略 objectName，则 [] 也可省略（但并非必须如此）。省略所有三项是不合法的，也就是说只有一个空字符串的名称是不合法的。

className、member 或 objectName 中的一个或多个可以是字符 "-"，这等同于 null 值。任意值隐含 null 值（包括另一个 null 值），但是 null 值并不隐含任意其他值。

可能的操作有：

addNotificationListener
getAttribute
getClassLoader
getClassLoaderFor
getClassLoaderRepository
getDomains
getMBeanInfo
getObjectInstance
instantiate
invoke
isInstanceOf
queryMBeans
queryNames
registerMBean
removeNotificationListener
setAttribute
unregisterMBean

在逗号分隔的操作列表中，每个操作的前后允许有空格。

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

构造方法摘要
`MBeanPermission(String name, String actions)` 创建具有指定目标名称和操作的新 MBeanPermission 对象。
`MBeanPermission(String className, String member, ObjectName objectName, String actions)` 创建具有指定目标名称（类名、成员、对象名）和操作的 MBeanPermission 对象。

方法摘要
`boolean`	`equals(Object obj)` 检查两个 MBeanPermission 对象的相等性。
`String`	`getActions()` 返回操作的“规范化字符串表示形式”。
`int`	`hashCode()` 返回此对象的哈希码值。
`boolean`	`implies(Permission p)` 检查此 MBeanPermission 对象是否“隐含”指定的权限。

从类 java.security.Permission 继承的方法
`checkGuard, getName, newPermissionCollection, toString`

从类 java.lang.Object 继承的方法
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

构造方法详细信息

public MBeanPermission(String name,
                       String actions)

创建具有指定目标名称和操作的新 MBeanPermission 对象。

目标名称的形式为 "className#member[objectName]"，其中每部分都是可选的。不可以为空或 null。

actions 参数包含在目标名称上所允许的所需操作列表，该列表用逗号分隔。不可以为空或 null。

参数：: name - 三部分的 "className#member[objectName]"。; actions - 操作字符串。

抛出：

IllegalArgumentException - 如果 name 或 actions 无效。

MBeanPermission

public MBeanPermission(String className,
                       String member,
                       ObjectName objectName,
                       String actions)

创建具有指定目标名称（类名、成员、对象名）和操作的 MBeanPermission 对象。

className、member、objectName 参数定义了 "className#member[objectName]" 形式的目标名称，其中每个部分都是可选的。这将是在结果 MBeanPermission 上调用 Permission.getName() 得到的结果。

actions 参数包含在目标名称上所允许的所需操作列表，该列表用逗号分隔。不可以为空或 null。

参数：: className - 应用此权限的类名。可以为 null 或 "-"，这表示一个由任何类名所隐含的类名，但是并不隐含任意其他类名。; member - 应用此权限的成员。可以为 null 或 "-"，这表示一个由任何成员所隐含的成员，但是并不隐含任意其他成员。; objectName - 应用此权限的对象名。可以为 null，这表示一个由任何对象名所隐含的对象名，但是并不隐含任意其他对象名。; actions - 操作字符串。

方法详细信息

getActions

public String getActions()

返回操作的“规范化字符串表示形式”。也就是说，此方法总是以字母顺序返回存在的操作：

指定者：: 类 Permission 中的 getActions

返回：: 操作的规范化字符串表示形式。

hashCode

public int hashCode()

返回此对象的哈希码值。

指定者：: 类 Permission 中的 hashCode

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

implies

public boolean implies(Permission p)

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

更明确地说，如果此方法满足以下条件，则返回 true：

p 是 MBeanPermission 的一个实例；并且
p 具有 null className 或者 p 的 className 与此对象的 className 相符；并且
p 具有 null 成员或者 p 的成员与此对象的成员相符；并且
p 具有 null 对象名或者 p 的对象名与此对象的对象名相符；并且
p 的动作是此对象动作的一个子集

如果此对象的 className 是 "*"，则 p 的 className 始终与其相符。如果是 "a.*"，则 p 的 className 与开头是 "a." 的 className 相符。

如果此对象的成员是 "*"，则 p 的成员始终与其相符。

如果此对象的 objectName n1 是一个对象名模式，则在 n1.equals(n2) 或者 n1.apply(n2) 的情况下，p 的 objectName n2 与其相符。

将包括 queryMBeans 操作的权限视为还包括 queryNames。

指定者：: 类 Permission 中的 implies

参数：: p - 所要检查的权限。
返回：: 如果此对象隐含指定的权限，则返回 true；否则返回 false。

equals

public boolean equals(Object obj)

检查两个 MBeanPermission 对象的相等性。检查 obj 是否为一个 MBeanPermission，并且检查是否和此对象具有相同的名称和操作。

指定者：: 类 Permission 中的 equals

参数：: obj - 要与此对象进行相等性测试的对象。
返回：: 如果 obj 是一个 MBeanPermission，并且与此 MBeanPermission 对象具有相同的名称和操作，则返回 true。
另请参见：: Object.hashCode(), Hashtable

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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

javax.management 类 MBeanPermission

MBeanPermission

MBeanPermission

getActions

hashCode

implies

equals

javax.management
类 MBeanPermission