Класс 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

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

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/security/BasicPermission.html