Интерфейс PolicyNode

public interface PolicyNode

Неизменяемый допустимый узел дерева политики, как определено алгоритмом валидации цепочки сертификатов PKIX.

Одним из результатов алгоритма валидации цепочки сертификатов PKIX является допустимое дерево политики, которое включает политики, признанные допустимыми, способ определения этой допустимости и любые встреченные квалификаторы политики. Это дерево имеет глубину n, где n — длина валидированной цепочки сертификатов.

Большинству приложений не потребуется исследовать дерево допустимых политик. Они могут достичь своих целей обработки политики, установив параметры, связанные с политикой, в PKIXParameters. Однако дерево допустимых политик доступно для более сложных приложений, особенно для тех, которые обрабатывают квалификаторы политики.

PKIXCertPathValidatorResult.getPolicyTree возвращает корневой узел допустимого дерева политики. Дерево можно обходить с помощью методов getChildren и getParent. Данные о конкретном узле можно получить с помощью других методов PolicyNode.

Доступность в нескольких потоках

Все объекты PolicyNode должны быть неизменяемыми и потокобезопасными. Несколько потоков могут одновременно вызывать методы, определенные в этом классе, для одного объекта PolicyNode (или более одного) без негативных последствий. Это условие относится ко всем открытым полям и методам этого класса и к любым добавленным или переопределённым дочерними классами.

Методы

getParent

PolicyNode getParent()

Возвращает родителя этого узла или null если это корневой узел.

Возвращает:

родителя этого узла или null если это корневой узел

getChildren

Iterator<? extends PolicyNode> getChildren()

Возвращает итератор по дочерним узлам этого узла. Любые попытки изменить дочерние узлы этого узла через метод remove итератора Iterator должны генерировать исключение UnsupportedOperationException.

Возвращает:

итератор по дочерним узлам этого узла

getDepth

int getDepth()

Возвращает глубину этого узла в дереве допустимых политик.

Возвращает:

глубину узла (0 для корневого узла, 1 для его дочерних узлов и так далее)

getValidPolicy

String getValidPolicy()

Возвращает допустимую политику, представленную этим узлом.

Возвращает:

OID допустимой политики, представленной этим узлом. Для корневого узла этот метод всегда возвращает специальный OID любой политики: "2.5.29.32.0".

getPolicyQualifiers

Set<? extends PolicyQualifierInfo> getPolicyQualifiers()

Возвращает набор квалификаторов политики, связанных с допустимой политикой, представленной этим узлом.

Возвращает:

неизменяемый набор Set квалификаторов PolicyQualifierInfo. Для корневого узла это всегда пустой Set.

getExpectedPolicies

Set<String> getExpectedPolicies()

Возвращает набор ожидаемых политик, которые удовлетворили бы допустимой политике этого узла в следующем обрабатываемом сертификате.

Возвращает:

неизменяемый набор Set ожидаемых OID политик String. Для корневого узла этот метод всегда возвращает Set с одним элементом — специальным OID любой политики: "2.5.29.32.0".

isCritical

boolean isCritical()

Возвращает индикатор критического характера расширения политики сертификата в наиболее недавно обработанном сертификате.

Возвращает:

true если расширение помечено как критическое, false в противном случае. Для корневого узла всегда возвращается false.