Класс Permissions

java.lang.Object

java.security.PermissionCollection

java.security.Permissions

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

public final class Permissions extends PermissionCollection implements Serializable

Этот класс представляет собой гетерогенную коллекцию разрешений. То есть, он содержит различные типы объектов Permission, организованные в PermissionCollections. Например, если любые java.io.FilePermission объекты будут добавлены в экземпляр этого класса, они все будут храниться в одной PermissionCollection. Это PermissionCollection, возвращаемое при вызове метода newPermissionCollection в классе FilePermission. Аналогично, любые java.lang.RuntimePermission объекты хранятся в PermissionCollection, возвращаемом вызовом метода newPermissionCollection в классе RuntimePermission. Таким образом, этот класс представляет собой коллекцию PermissionCollections.

Когда вызывается метод add для добавления разрешения, разрешение хранится в соответствующей PermissionCollection. Если такой коллекции еще не существует, определяется класс объекта Permission и вызывается метод newPermissionCollection этого класса для создания PermissionCollection и добавления его в объект Permissions. Если newPermissionCollection возвращает null, то создается и используется по умолчанию PermissionCollection, использующий хеш-таблицу. Каждый элемент хеш-таблицы хранит объект Permission как ключ, так и значение.

Перечисления, возвращаемые методом elements , не являются *fail-fast*. Изменения в коллекции не должны выполняться во время перебора этой коллекции.

С тех пор:

1.2

См. также:

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

Конструктор	Описание
`Permissions()`	Создаёт новый объект Permissions, не содержащий PermissionCollections.

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

Модификатор и тип	Метод	Описание
`void`	`add(Permission permission)`	Добавляет объект разрешения в PermissionCollection для класса, к которому принадлежит разрешение.
`Enumeration<Permission>`	`elements()`	Возвращает перечисление всех объектов Permission во всех PermissionCollections в этом объекте Permissions.
`boolean`	`implies(Permission permission)`	Проверяет, подразумевает ли PermissionCollection этого объекта для разрешений указанного класса разрешений разрешения, выраженного в объекте permission.

Методы, объявленные в классе java.security.PermissionCollection

elementsAsStream, isReadOnly, setReadOnly, toString

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

Permissions

public Permissions()

Создаёт новый объект Permissions, не содержащий PermissionCollections.

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

add

public void add(Permission permission)

Добавляет объект разрешения в PermissionCollection для класса, к которому принадлежит разрешение. Например, если permission является FilePermission, он добавляется в FilePermissionCollection, хранящийся в этом объекте Permissions. Этот метод создаёт новый объект PermissionCollection (и добавляет в него разрешение), если соответствующая коллекция ещё не существует.

Указано в:

add в классе PermissionCollection

Параметры:

permission - объект Permission для добавления.

Исключения:

SecurityException - если этот объект Permissions помечен как только для чтения.

См. также:

PermissionCollection.isReadOnly()

implies

public boolean implies(Permission permission)

Проверяет, подразумевает ли PermissionCollection этого объекта для разрешений указанного класса разрешений разрешение, выраженное в объекте permission. Возвращает true, если комбинация разрешений в соответствующей PermissionCollection (например, FilePermissionCollection для FilePermission) вместе подразумевают указанное разрешение.

Например, предположим, что в этом объекте Permissions есть FilePermissionCollection, и она содержит одно FilePermission, которое задаёт доступ для чтения для всех файлов во всех подкаталогах каталога "/tmp", и другое FilePermission, которое задаёт доступ для записи для всех файлов в каталоге "/tmp/scratch/foo". Тогда, если метод implies вызывается с разрешением, задающим доступ и для чтения, и для записи к файлам в каталоге "/tmp/scratch/foo", возвращается true.

Кроме того, если эта PermissionCollection содержит AllPermission, этот метод всегда вернёт true.

Указано в:: implies в классе PermissionCollection
Параметры:: permission - объект Permission для проверки.
Возвращает:: true, если "permission" подразумевается разрешениями в PermissionCollection, к которой он принадлежит, false в противном случае.

elements

public Enumeration<Permission> elements()

Возвращает перечисление всех объектов Permission во всех PermissionCollections в этом объекте Permissions.

Указано в:

elements в классе PermissionCollection

Возвращает:

перечисление всех Permission.

См. также:

PermissionCollection.elementsAsStream()

© 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.base/java/security/Permissions.html