Класс BasicPermission

java.lang.Object

java.security.Permission

java.security.BasicPermission

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

public abstract class BasicPermission extends Permission implements Serializable

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

Имя для BasicPermission — это имя заданного разрешения (например, "exit", "setFactory", "print.queueJob" и т. д.). Соглашение об именовании соответствует соглашению об иерархическом именовании свойств. Звёздочка может использоваться отдельно или, если ей непосредственно предшествует ".", в конце имени для обозначения соответствия шаблону. Например, "*" и "java.*" обозначают соответствие шаблону, а "*java", "a*b" и "java*" — нет.

Строка действий (унаследованная от Permission) не используется. Поэтому BasicPermission обычно используется в качестве базового класса для «именованных» разрешений (содержащих имя, но не список действий; у вас либо есть именованное разрешение, либо его нет). При необходимости подклассы могут реализовывать действия поверх BasicPermission.

Начиная с:

1.2

См. также:

Краткое описание конструкторов

Конструктор	Описание
`BasicPermission(String name)`	Создаёт новый объект `BasicPermission` с указанным именем.
`BasicPermission(String name, String actions)`	Создаёт новый объект `BasicPermission` с указанным именем.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Проверяет два объекта `BasicPermission` на равенство.
`String`	`getActions()`	Возвращает каноническое строковое представление действий, которым в настоящее время является пустая строка "", поскольку у `BasicPermission` нет действий.
`int`	`hashCode()`	Возвращает значение хеш-кода этого объекта.
`boolean`	`implies(Permission p)`	Проверяет, подразумевается ли указанное разрешение этим объектом.
`PermissionCollection`	`newPermissionCollection()`	Возвращает новый объект `PermissionCollection` для хранения объектов `BasicPermission`.

Методы, объявленные в классе Permission

checkGuard, getName, toString

Модификатор и тип	Метод	Описание
`void`	`checkGuard(Object object)`	Реализует интерфейс guard для разрешения.
`final String`	`getName()`	Возвращает имя этого `Permission`.
`String`	`toString()`	Возвращает строку с описанием этого `Permission`.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API будет удалён в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.

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

BasicPermission

public BasicPermission(String name)

Создаёт новый объект BasicPermission с указанным именем. Имя — это символьное имя разрешения, например "setFactory", "print.queueJob" или "topLevelWindow" и т. д.

Параметры:: name — имя BasicPermission.
Исключения:: NullPointerException — если name равно null.; IllegalArgumentException — если name пусто.

BasicPermission

public BasicPermission(String name, String actions)

Создаёт новый объект BasicPermission с указанным именем. Имя — это символьное имя BasicPermission, а строка действий String в настоящее время не используется.

Параметры:: name — имя BasicPermission.; actions — игнорируется.
Исключения:: NullPointerException — если name равно null.; IllegalArgumentException — если name пусто.

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

implies

public boolean implies(Permission p)

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

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

класс p совпадает с классом этого объекта, и
имя p совпадает с именем этого объекта или (в случае шаблонов) подразумевается им. Например, "a.b.*" подразумевает "a.b.c".

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

equals

public boolean equals(Object obj)

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

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

equals в классе Permission

Параметры:

obj — объект, с которым проверяется равенство этого объекта.

Возвращает:

true, если класс obj совпадает с классом этого объекта и имеет то же имя, что и этот объект BasicPermission, и false в противном случае.

См. также:

hashCode

public int hashCode()

Возвращает значение хеш-кода этого объекта. Используется хеш-код имени, то есть getName().hashCode(), где getName берётся из суперкласса Permission.

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

hashCode в классе Permission

Возвращает:

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

См. также:

getActions

public String getActions()

Возвращает каноническое строковое представление действий, которым в настоящее время является пустая строка "", поскольку у BasicPermission нет действий.

Определено в:: getActions в классе Permission
Возвращает:: пустую строку "".

newPermissionCollection

public PermissionCollection newPermissionCollection()

Возвращает новый объект PermissionCollection для хранения объектов BasicPermission.

Объекты BasicPermission должны храниться таким образом, чтобы их можно было добавлять в любом порядке, но при этом метод PermissionCollection.implies(Permission) мог быть реализован эффективно и единообразно.

Переопределяет:: newPermissionCollection в классе Permission
Возвращает:: новый объект PermissionCollection, подходящий для хранения объектов BasicPermission.

© 1993, 2025, 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.