Класс PermissionCollection

С помощью PermissionCollection вы можете:

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

Когда требуется сгруппировать несколько объектов Permission одного типа, необходимо сначала вызвать метод newPermissionCollection на объекте этого типа Permission. По умолчанию (из класса Permission) этот метод просто возвращает null. Подклассы класса Permission переопределяют этот метод, если им нужно хранить свои разрешения в определённом объекте PermissionCollection для корректной семантики при вызове метода PermissionCollection.implies. Если возвращается ненулевое значение, оно должно быть использовано. Если возвращается null, вызывающий метод newPermissionCollection свободен хранить разрешения данного типа в любом PermissionCollection по своему усмотрению (например, используя Hashtable или Vector).

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

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

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