Интерфейс DomainCombiner

public interface 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)

Параметры:

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

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

Возвращает:

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