Класс PolicyQualifierInfo

java.lang.Object

java.security.cert.PolicyQualifierInfo

public class PolicyQualifierInfo extends Object

Неизменяемый квалификатор политики, представленный структурой ASN.1 PolicyQualifierInfo.

Определение ASN.1 выглядит следующим образом:

  PolicyQualifierInfo ::= SEQUENCE {
       policyQualifierId       PolicyQualifierId,
       qualifier               ANY DEFINED BY policyQualifierId }

Расширение политик сертификата, если оно присутствует в сертификате X.509 версии 3, содержит последовательность из одного или нескольких терминов информации о политике, каждый из которых состоит из идентификатора объекта (OID) и необязательных квалификаторов. В сертификате конечного пользователя эти термины информации о политике указывают политику, в соответствии с которой был выдан сертификат, и цели, для которых сертификат может использоваться. В сертификате УЦ эти термины информации о политике ограничивают набор политик для путей сертификации, включающих этот сертификат.

Метод PolicyNode.getPolicyQualifiers возвращает Set объектов PolicyQualifierInfo. Это позволяет приложениям с особыми требованиями к политикам обрабатывать и проверять каждый квалификатор политики. Приложениям, которым необходимо обрабатывать квалификаторы политики, следует явно установить флаг policyQualifiersRejected в значение false (вызвав метод PKIXParameters.setPolicyQualifiersRejected) перед проверкой пути сертификации.

Обратите внимание, что алгоритм проверки пути сертификации PKIX предписывает обрабатывать и проверять любой квалификатор политики в расширении политик сертификата, помеченный как критический. В противном случае путь сертификации должен быть отклонен. Если флаг policyQualifiersRejected установлен в значение false, приложение должно проверить все квалификаторы политики таким образом, чтобы соответствовать требованиям PKIX.

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

Все объекты PolicyQualifierInfo должны быть неизменяемыми и потокобезопасными. Это означает, что несколько потоков могут одновременно вызывать методы, определенные в этом классе, для одного (или нескольких) объекта PolicyQualifierInfo без каких-либо нежелательных последствий. Требование неизменяемости и потокобезопасности объектов PolicyQualifierInfo позволяет передавать их различным фрагментам кода, не беспокоясь о координации доступа.

Начиная с:: 1.4

Краткое описание конструкторов

Конструктор	Описание
`PolicyQualifierInfo(byte[] encoded)`	Создает экземпляр `PolicyQualifierInfo` из закодированных байтов.

Краткое описание методов

Модификатор и тип	Метод	Описание
`final byte[]`	`getEncoded()`	Возвращает форму этого `PolicyQualifierInfo`, закодированную в ASN.1 DER.
`final byte[]`	`getPolicyQualifier()`	Возвращает поле `qualifier` этого `PolicyQualifierInfo`, закодированное в ASN.1 DER.
`final String`	`getPolicyQualifierId()`	Возвращает поле `policyQualifierId` этого `PolicyQualifierInfo`.
`String`	`toString()`	Возвращает текстовое представление этого `PolicyQualifierInfo`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определенного периода реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определенного периода реального времени.

Подробное описание конструкторов

PolicyQualifierInfo

public PolicyQualifierInfo(byte[] encoded) throws IOException

Создает экземпляр PolicyQualifierInfo из закодированных байтов. При создании копируется закодированный массив байтов.

Параметры:: encoded — массив байтов, содержащий квалификатор в кодировке DER
Исключения:: IOException — возникает, если массив байтов не представляет допустимый и разбираемый квалификатор политики

Подробное описание методов

getPolicyQualifierId

public final String getPolicyQualifierId()

Возвращает поле policyQualifierId этого PolicyQualifierInfo. policyQualifierId — это идентификатор объекта (OID), представленный набором неотрицательных целых чисел, разделенных точками.

Возвращает:: OID (никогда не null)

getEncoded

public final byte[] getEncoded()

Возвращает форму этого PolicyQualifierInfo, закодированную в ASN.1 DER.

Возвращает:: байты в кодировке ASN.1 DER (никогда не null). Обратите внимание, что возвращается копия, поэтому данные копируются при каждом вызове этого метода.

getPolicyQualifier

public final byte[] getPolicyQualifier()

Возвращает поле qualifier этого PolicyQualifierInfo, закодированное в ASN.1 DER.

Возвращает:: байты поля qualifier в кодировке ASN.1 DER. Обратите внимание, что возвращается копия, поэтому данные копируются при каждом вызове этого метода.

toString

public String toString()

Возвращает текстовое представление этого PolicyQualifierInfo.

Переопределяет:: toString в классе Object
Возвращает:: String с описанием содержимого этого PolicyQualifierInfo

© 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.