Интерфейс PolicyNode

public interface PolicyNode

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

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

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

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

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

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

Since:: 1.4

Методы

Модификатор и тип	Метод	Описание
`Iterator<? extends PolicyNode>`	`getChildren()`	Возвращает итератор по дочерним узлам этого узла.
`int`	`getDepth()`	Возвращает глубину этого узла в дереве допустимых политик.
`Set<String>`	`getExpectedPolicies()`	Возвращает набор ожидаемых политик, которые удовлетворят допустимой политике этого узла в следующем обрабатываемом сертификате.
`PolicyNode`	`getParent()`	Возвращает родителя этого узла или `null` если это корневой узел.
`Set<? extends PolicyQualifierInfo>`	`getPolicyQualifiers()`	Возвращает набор квалификаторов политик, связанных с допустимой политикой, представленной этим узлом.
`String`	`getValidPolicy()`	Возвращает допустимую политику, представленную этим узлом.
`boolean`	`isCritical()`	Возвращает индикатор критичности расширения политики сертификата в наиболее недавно обработанном сертификате.

Методы

getParent

PolicyNode getParent()

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

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

getChildren

Iterator<? extends PolicyNode> getChildren()

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

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

getDepth

int getDepth()

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

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

getValidPolicy

String getValidPolicy()

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

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

getPolicyQualifiers

Set<? extends PolicyQualifierInfo> getPolicyQualifiers()

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

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

getExpectedPolicies

Set<String> getExpectedPolicies()

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

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

isCritical

boolean isCritical()

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

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