java.security

Класс PermissionCollection

java.lang. Объект

java.security. PermissionCollection

Все Реализованные Интерфейсы:

Сериализуемый

Прямые Известные Подклассы:

Полномочия

public abstract class PermissionCollection
extends Object
implements Serializable

Абстрактный класс, представляющий набор Объектов полномочий.

С PermissionCollection Вы можете:

• добавьте разрешение к набору, используя add метод.
• проверьте, чтобы видеть, подразумевается ли определенное разрешение в наборе, используя implies метод.
• перечислите все полномочия, используя elements метод.

Когда это является требуемым, чтобы группироваться много Объектов полномочий того же самого типа, newPermissionCollection метод на том определенном типе Объекта полномочий нужно сначала вызвать. Поведение по умолчанию (от Класса полномочий) должно просто возвратить нуль. Подклассы Разрешения класса переопределяют метод, если они должны сохранить свои полномочия в определенном объекте PermissionCollection, чтобы обеспечить корректную семантику когда PermissionCollection.implies метод вызывают. Если ненулевое значение возвращается, что PermissionCollection должен использоваться. Если нуль возвращается, то вызывающая сторона newPermissionCollection свободно сохранить полномочия данного, вводят любой PermissionCollection, который они выбирают (тот, который использует Хеш-таблицу, тот, который использует Вектор, и т.д.).

PermissionCollection, возвращенный Permission.newPermissionCollection метод является гомогенным набором, который хранит только Объекты полномочий для данного Типа полномочий. PermissionCollection может также быть неоднородным. Например, Полномочия подкласс PermissionCollection, который представляет набор PermissionCollections. Таким образом, его элементы - каждый гомогенный PermissionCollection. Например, у объекта Полномочий могли бы быть FilePermissionCollection для всех объектов FilePermission, SocketPermissionCollection для всех объектов SocketPermission, и так далее. add метод добавляет разрешение к соответствующему набору.

Всякий раз, когда разрешение добавляется к неоднородному PermissionCollection, такому как Полномочия, и PermissionCollection еще не содержит PermissionCollection типа указанного разрешения, PermissionCollection должен вызвать newPermissionCollection метод на классе разрешения, чтобы видеть, требует ли это специального PermissionCollection. Если newPermissionCollection нуль возвратов, PermissionCollection свободен сохранить разрешение в любом типе PermissionCollection, которого это требует (одно использование Хеш-таблицы, одно использование Вектора, и т.д.). Например, объект Полномочий использует реализацию PermissionCollection по умолчанию, которая хранит объекты полномочий в Хеш-таблице.

Реализации подкласса PermissionCollection должны предположить, что их можно вызвать одновременно от многократных потоков, и поэтому должны синхронизироваться должным образом. Кроме того, Перечисления, возвращенные через elements метод не является сбоем быстро. Модификации к набору не должны быть выполнены, перечисляя по тому набору.

См. Также:

Permission, Permissions, Сериализированная Форма

Сводка конструктора

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

Конструктор и Описание
PermissionCollection()

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
abstract void	add(Permission permission) Добавляет объект полномочий к текущему набору объектов полномочий.
abstract Enumeration<Permission>	elements() Возвращает перечисление всех Объектов полномочий в наборе.
abstract boolean	implies(Permission permission) Проверки, чтобы видеть, подразумевается ли указанное разрешение набором Объектов полномочий, сохраненных в этом PermissionCollection.
boolean	isReadOnly() Возвращает true, если этот объект PermissionCollection отмечается как только для чтения.
void	setReadOnly() Марки этот PermissionCollection возражают как "только для чтения".
Строка	toString() Возвращает строку, описывающую этот объект PermissionCollection, предоставляя информацию обо всех полномочиях, которые это содержит.

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

PermissionCollection

public PermissionCollection()

Деталь метода

добавить

public abstract void add(Permission permission)

Добавляет объект полномочий к текущему набору объектов полномочий.

Параметры:

permission - Объект полномочий, чтобы добавить.

Броски:

SecurityException - если этот объект PermissionCollection был отмечен только для чтения

IllegalArgumentException - если этот объект PermissionCollection является гомогенным набором и разрешением, не имеет корректного типа.

подразумевает

public abstract boolean implies(Permission permission)

Проверки, чтобы видеть, подразумевается ли указанное разрешение набором Объектов полномочий, сохраненных в этом PermissionCollection.

Параметры:

permission - Объект полномочий, чтобы сравниться.

Возвраты:

истина, если "разрешение" подразумевается полномочиями в наборе, ложь если нет.

элементы

public abstract Enumeration<Permission> elements()

Возвращает перечисление всех Объектов полномочий в наборе.

Возвраты:

перечисление всех Полномочий.

setReadOnly

public void setReadOnly()

Марки этот PermissionCollection возражают как "только для чтения". После того, как объект PermissionCollection отмечается как только для чтения, никакие новые Объекты полномочий не могут быть добавлены к нему использование add.

isReadOnly

public boolean isReadOnly()

Возвращает true, если этот объект PermissionCollection отмечается как только для чтения. Если это только для чтения, никакие новые Объекты полномочий не могут быть добавлены к этому использование add.

По умолчанию объект не только для чтения. Это может быть установлено в только для чтения звонком setReadOnly.

Возвраты:

истина, если этот объект PermissionCollection отмечается как только для чтения, ложный иначе.

toString

public String toString()

Возвращает строку, описывающую этот объект PermissionCollection, предоставляя информацию обо всех полномочиях, которые это содержит. Формат:

 super.toString() (
   // enumerate all the Permission
   // objects and call toString() on them,
   // one per line..
 )

super.toString звонок toString метод суперкласса этого объекта, который является Объектом. Результатом является имя типа этого PermissionCollection, сопровождаемое хэш-кодом этого объекта, таким образом позволяя клиентам дифференцировать различный объект PermissionCollections, даже если они содержат те же самые полномочия.

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

toString в классе Object

Возвраты:

информация об этом объекте PermissionCollection, как описано выше.