Интерфейс DomainCombiner

Объект DomainCombiner передаётся в качестве параметра соответствующему конструктору AccessControlContext. Созданный контекст затем передаётся в метод AccessController.doPrivileged(..., context) для привязки предоставленного контекста (и связанных DomainCombiner) к текущему потоку выполнения. Последующие вызовы AccessController.getContext или AccessController.checkPermission вызывают вызов DomainCombiner.combine.

Метод combine принимает два аргумента. Первый аргумент представляет массив ProtectionDomains из текущего потока выполнения с момента последнего вызова AccessController.doPrivileged. Если вызов doPrivileged не производился, то первый аргумент будет содержать все ProtectionDomains из текущего потока выполнения. Второй аргумент представляет массив унаследованных ProtectionDomains, которые могут быть null. ProtectionDomains могут быть унаследованы от родительского потока или из привилегированного контекста. Если вызов doPrivileged не производился, то второй аргумент будет содержать ProtectionDomains, унаследованные от родительского потока. Если было выполнено одно или несколько вызовов doPrivileged, и последний вызов был doPrivileged(action, context), то второй аргумент будет содержать ProtectionDomains из привилегированного контекста. Если последний вызов был doPrivileged(action), то привилегированного контекста нет, и второй аргумент будет null.

Метод combine исследует два входных массива ProtectionDomains и возвращает единственный массив, содержащий обновлённые ProtectionDomains. В простом случае метод combine объединяет два стека в один. В более сложных случаях метод combine возвращает изменённый стек ProtectionDomains. Изменения могут включать добавление новых ProtectionDomains, удаление определённых ProtectionDomains или просто обновление существующих ProtectionDomains. Также разрешается изменение порядка и другие оптимизации ProtectionDomains. Обычно метод combine основывает свои обновления на информации, закодированной в DomainCombiner.

После того, как метод AccessController.getContext получит объединённый стек ProtectionDomains от DomainCombiner, он возвращает новый AccessControlContext, который содержит как объединённые ProtectionDomains, так и DomainCombiner.