Класс PermissionCollection

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

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

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

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

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

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