Класс MBeanPermission

java.lang.Object

java.security.Permission

javax.management.MBeanPermission

Все реализованные интерфейсы:: Serializable, Guard

public class MBeanPermission extends Permission

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

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

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

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

Действие возвращается методом getActions().
Имя класса.

Для необходимого разрешения это имя класса MBean, к которому вы осуществляете доступ, как возвращается методом MBeanServer.getMBeanInfo(name).getClassName(). Некоторые операции не ссылаются на имя класса, в этом случае имя класса равно null.

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

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

Для необходимого разрешения это имя атрибута или операции, к которому вы осуществляете доступ. Для операций, которые не ссылаются на атрибут или операцию, атрибут равен null.

Для имеющегося разрешения это либо имя атрибута или операции, к которому вы имеете доступ, либо пустая строка или единственный символ "*", оба из которых предоставляют доступ к любому атрибуту.
Имя объекта.

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

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

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

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

className#member[objectName]

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

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

Один или несколько из className, member, или objectName могут быть символом "-", что эквивалентно значению 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

Подробное описание конструкторов

MBeanPermission

public MBeanPermission(String name, String actions)

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

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

Параметр actions содержит список желаемых действий, разрешённых для целевого имени, разделённый запятыми. Он не должен быть пустым или нулевым.

Параметры:: name - тройка "className#member[objectName]".; 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
Возвращает:: каноническое строковое представление действий.

hashCode

public int hashCode()

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

Определено в:

hashCode в классе Permission

Возвращает:

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

См. также:

implies

public boolean implies(Permission p)

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

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

p является экземпляром MBeanPermission;
p имеет null className или className p совпадает с className этого объекта;
p имеет null member или member p совпадает с member этого объекта;
p имеет null object name или object name p совпадает с object name этого объекта;
действия p являются подмножеством действий этого объекта.

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

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

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

Разрешение, включающее действие queryMBeans, считается включающим также queryNames.

Определено в:: implies в классе Permission
Параметры:: p - разрешение для проверки.
Возвращает:: true, если указанное разрешение подразумевается этим объектом, false — в противном случае.

equals

public boolean equals(Object obj)

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

Определено в:

equals в классе Permission

Параметры:

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

Возвращает:

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

См. также:

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.management/javax/management/MBeanPermission.html