Spec-Zone.ru › OpenJDK 25

Интерфейс PolicyNode

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

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

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

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

Параллельный доступ

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

Начиная с:
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 String допустимой политики, представленной этим узлом. Для корневого узла этот метод всегда возвращает специальный 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.

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, где содержатся более подробные описания для разработчиков, включая концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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/25/docs/api/java.base/java/security/cert/PolicyNode.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API