javax.management

Класс MBeanPermission

java.lang. Объект

java.security. Разрешение

javax.management. MBeanPermission

Все Реализованные Интерфейсы:

Сериализуемый, Защита

public class MBeanPermission
extends Permission

Разрешение, управляющее доступом к операциям MBeanServer. Если менеджер безопасности был установлен, используя System.setSecurityManager(java.lang.SecurityManager), большинство операций на Сервере MBean требует, чтобы полномочия вызывающей стороны подразумевали MBeanPermission, подходящий для работы. Это описывается подробно в документации для MBeanServer интерфейс.

Как с другим Permission объекты, MBeanPermission может представить или разрешение, которое Вы имеете или разрешение, в котором Вы нуждаетесь. Когда секретная операция проверяется на разрешение, MBeanPermission создается, представляя разрешение, в котором Вы нуждаетесь. Работа только позволяется, если полномочия, которые Вы имеете, подразумевают разрешение, Вы нуждаетесь.

MBeanPermission содержит четыре единицы информации:

• Действие. Для разрешения Вы нуждаетесь, это - одно из действий в списке ниже. Для разрешения Вы имеете, это - список разделенных запятой значений тех действий, или *, представление всех действий.

  Действие возвращается getActions().

• Имя класса.

  Для разрешения Вы нуждаетесь, это - имя класса MBean, которым Вы получаете доступ, как возвращено MBeanServer.getMBeanInfo(name).getClassName(). Определенные операции не ссылаются на имя класса, когда имя класса является нулем.

  Для разрешения Вы имеете, это или пусто или образец имени класса. Образец имени класса является строкой после соглашений Java для разделенных от точки имен классов. Это может закончиться".*"означая, что разрешение предоставляет доступ к любому классу, который начинается со строки, предыдущей".*". Например,"javax.management.*"предоставляет доступ к javax.management.MBeanServerDelegate и javax.management.timer.Timer, среди других классов.

  Образец имени класса может также быть пустым или единственный символ"*", оба из которых предоставляют доступ к любому классу.

• Элемент.

  Для разрешения Вы нуждаетесь, это - имя атрибута или работы, к которой Вы получаете доступ. Для операций, которые не ссылаются на атрибут или работу, элемент является нулем.

  Для разрешения Вы имеете, это - или имя атрибута или работа, к которой можно получить доступ, или это пусто или единственный символ"*", оба из которых предоставляют доступ к любому элементу.

• Имя объекта.

  Для разрешения Вы нуждаетесь, это ObjectName из MBean Вы получаете доступ. Для операций, которые не ссылаются на единственный MBean, это - нуль. Это никогда не образец имени объекта.

  Для разрешения Вы имеете, это ObjectName из MBean или MBeans можно получить доступ. Это может быть образец имени объекта, чтобы предоставить доступ ко всему MBeans, имена которого соответствуют образец. Это может также быть пусто, который предоставляет доступ ко всему MBeans вообще их имя.

Если у Вас есть MBeanPermission, он позволяет операции, только если все четыре из элементов соответствуют.

Имя класса, элемент, и имя объекта могут быть записаны вместе как единственная строка, которая является именем этого разрешения. Имя разрешения является строкой, возвращенной getName(). Формат строки:

className#member[objectName]

Имя объекта пишется, используя обычный синтаксис для ObjectName. Это может содержать любые юридические символы, включая ]. Это завершается a ] символ, который является последним знаком в строке.

Один или больше className, member, или objectName может быть опущен. Если member опускается, # может быть также (но не должен быть). Если objectName опускается, [] может быть также (но не должен быть). Не законно опустить все три элемента, у которого должно быть имя, которое является пустой строкой.

Один или больше className, member, или objectName может быть символ"-", который эквивалентен нулевому значению. Нулевое значение подразумевается любым значением (включая другое нулевое значение), но не подразумевает никакое другое значение.

Возможные действия - они:

• addNotificationListener
• getAttribute
• getClassLoader
• getClassLoaderFor
• getClassLoaderRepository
• getDomains
• getMBeanInfo
• getObjectInstance
• инстанцировать
• вызвать
• 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 возражают для равенства.
Строка	getActions() Возвращает "каноническое строковое представление" действий.
int	hashCode() Возвращает значение хэш-кода для этого объекта.
boolean	implies(Permission p) Проверки, если этот объект MBeanPermission "подразумевает" указанное разрешение.

Методы java.security унаследованный от класса. Разрешение

checkGuard, getName, newPermissionCollection, toString

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

MBeanPermission

public MBeanPermission(String name,
               String actions)

Создайте новый объект MBeanPermission с указанным целевым именем и действиями.

Целевое имя имеет форму"className#member[objectName]"где каждая часть является дополнительной. Это не должно быть пустым или нулевым.

Параметр действий содержит список разделенных запятой значений требуемых действий, предоставленных на целевом имени. Это не должно быть пустым или нулевым.

Параметры:

name - триплет "className#member [имя объекта]".

actions - строка действия.

Броски:

IllegalArgumentException - если name или actions недопустимо.

MBeanPermission

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

Создайте новый объект MBeanPermission с указанным целевым именем (имя класса, элемент, имя объекта) и действия.

Имя класса, имя элемента и параметры имени объекта определяют целевое имя формы"className#member[objectName]"где каждая часть является дополнительной. Это будет результатом Permission.getName() на результирующем MBeanPermission.

Параметр действий содержит список разделенных запятой значений требуемых действий, предоставленных на целевом имени. Это не должно быть пустым или нулевым.

Параметры:

className - имя класса, к которому применяется это разрешение. Может быть нуль или "-", который представляет имя класса, которое подразумевается любым именем класса, но не подразумевает никакое другое имя класса.

member - элемент, к которому применяется это разрешение. Может быть нуль или "-", который представляет элемент, который подразумевается любым элементом, но не подразумевает никакой другой элемент.

objectName - имя объекта, к которому применяется это разрешение. Может быть нуль, который представляет имя объекта, которое подразумевается любым именем объекта, но не подразумевает никакое другое имя объекта.

actions - строка действия.

Деталь метода

getActions

public String getActions()

Возвращает "каноническое строковое представление" действий. Таким образом, этот метод всегда возвращает существующие действия в алфавитном порядке.

Определенный:

getActions в классе Permission

Возвраты:

каноническое строковое представление действий.

хэш-код

public int hashCode()

Возвращает значение хэш-кода для этого объекта.

Определенный:

hashCode в классе Permission

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

подразумевает

public boolean implies(Permission p)

Проверки, если этот объект MBeanPermission "подразумевает" указанное разрешение.

Более определенно этот метод возвращает true если:

• p является экземпляром MBeanPermission; и
• у p есть нулевое имя класса, или имя класса p соответствует имя класса этого объекта; и
• у p есть нулевой элемент, или элемент p соответствует элемент этого объекта; и
• у p есть нулевое имя объекта, или имя объекта p соответствует имя объекта этого объекта; и
• действия p являются подмножеством действий этого объекта

Если имя класса этого объекта"*", имя класса p всегда соответствует это. Если это"a.*", имя класса p соответствует это, если это начинается"a.".

Если элемент этого объекта"*", элемент p всегда соответствует это.

Если имя объекта этого объекта n1 является образцом имени объекта, имя объекта p n2 соответствует его если n1.equals(n2) или если n1.apply(n2).

Разрешение, которое включает queryMBeans действие, как полагают, включает queryNames также.

Определенный:

implies в классе Permission

Параметры:

p - разрешение, чтобы проверить по.

Возвраты:

истина, если указанное разрешение подразумевается этим объектом, ложь если нет.

равняется

public boolean equals(Object obj)

Проверки два MBeanPermission возражают для равенства. Проверки, что obj является MBeanPermission, и имеет то же самое имя и действия как этот объект.

Определенный:

equals в классе Permission

Параметры:

obj - объект мы тестируем на равенство с этим объектом.

Возвраты:

истина, если obj является MBeanPermission, и имеет то же самое имя и действия как этот объект MBeanPermission.

См. Также:

Object.hashCode(), HashMap