Класс Permissions

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

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

Конструкторы

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()