Интерфейс 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 если это корневой узел.

Returns:: родительский узел этого узла, или null если это корневой узел

getChildren

Iterator<? extends PolicyNode> getChildren()

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

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

getDepth

int getDepth()

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

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

getValidPolicy

String getValidPolicy()

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

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

getPolicyQualifiers

Set<? extends PolicyQualifierInfo> getPolicyQualifiers()

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

Returns:: неизменяемое множество квалификаторов. Для корневого узла это всегда пустое множество.

getExpectedPolicies

Set<String> getExpectedPolicies()

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

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

isCritical

boolean isCritical()

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

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

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/security/cert/PolicyNode.html