Класс 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, к которым вы можете получить доступ. Это может быть шаблоном имени объекта, чтобы предоставить доступ ко всем MBean, чьи имена соответствуют шаблону. Это также может быть пустым, что предоставляет доступ ко всем MBean независимо от их имени.

Если у вас есть 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.".

Если member этого объекта равен "*", member 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, 2021, 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/17/docs/api/java.management/javax/management/MBeanPermission.html