Spec-Zone.ru › OpenJDK 24

Класс Разрешения

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
См. также:
  • Permission
  • PermissionCollection
  • AllPermission

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

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

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

Модификатор и тип Метод Описание
void add(Permission permission)
Добавляет объект Permission в PermissionCollection для класса, к которому принадлежит разрешение.
Enumeration<Permission> elements()
Возвращает перечисление всех Permission объектов во всех PermissionCollection объектах в этом объекте 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

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

Разрешения

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

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

add

public void add(Permission 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) вместе подразумевают указанное разрешение.

Например, предположим, что в этом объекте FilePermissionCollection есть Permissions, и он содержит одно 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 объектов.
См. также:
  • PermissionCollection.elementsAsStream()

© 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/security/Permissions.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API