Класс PermissionCollection

С помощью этого класса вы можете:

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

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