Интерфейс DomainCombiner

public interface DomainCombiner

Класс DomainCombiner предоставляет способ динамического обновления ProtectionDomains, связанных с текущим AccessControlContext.

Класс 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.

Методы

combine

ProtectionDomain[] combine(ProtectionDomain[] currentDomains,
                           ProtectionDomain[] assignedDomains)

Изменить или обновить предоставленные ProtectionDomains. ProtectionDomains могут быть добавлены или удалены из предоставленных ProtectionDomains. ProtectionDomains могут быть переупорядочены. Отдельные ProtectionDomains могут быть изменены (например, с новым набором разрешений).

Параметры:

currentDomains - ProtectionDomains, связанные с текущей нитью выполнения до последнего привилегированного ProtectionDomain. ProtectionDomains перечислены в порядке выполнения, причём последний выполняемый ProtectionDomain находится в начале массива. Этот параметр может быть null если у текущей нити выполнения нет связанных ProtectionDomains.

assignedDomains - массив унаследованных ProtectionDomains. ProtectionDomains могут быть унаследованы от родительской нити или от привилегированного AccessControlContext. Этот параметр может быть null если унаследованных ProtectionDomains нет.

Возвращает:

новый массив, состоящий из обновлённых ProtectionDomains или null.