Класс Permissions

java.lang.Object

java.security.PermissionCollection

java.security.Permissions

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

public final class Permissions extends PermissionCollection implements Serializable

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

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

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

Начиная с:

1.2

См. также:

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

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

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

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

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

elementsAsStream, isReadOnly, setReadOnly, toString

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

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

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

Permissions

public Permissions()

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

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

add

public void add(Permission permission)

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

Переопределено:

add в классе PermissionCollection

Параметры:

permission — объект Permission, который нужно добавить.

Исключения:

SecurityException — если для этого объекта Permissions установлен режим «только для чтения».

См. также:

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 во всех объектах PermissionCollection этого объекта Permissions.

Переопределено:

elements в классе PermissionCollection

Возвращает:

перечисление всех объектов Permission.

См. также:

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