Класс DOMValidateContext

java.lang.Object

javax.xml.crypto.dom.DOMCryptoContext

javax.xml.crypto.dsig.dom.DOMValidateContext

Все реализованные интерфейсы:: XMLValidateContext, XMLCryptoContext

public class DOMValidateContext extends DOMCryptoContext implements XMLValidateContext

Специфичный для DOM XMLValidateContext. Этот класс содержит дополнительные методы для указания местоположения в дереве DOM, из которого следует выполнить демаршалинг и проверку XMLSignature.

Обратите внимание, что поведение демаршалированного XMLSignature не определено, если вызывающий код изменяет содержимое базового дерева DOM после создания XMLSignature.

Также обратите внимание, что экземпляры DOMValidateContext могут содержать сведения и состояние, относящиеся к используемой с ними структуре XML-подписи. Результаты непредсказуемы, если DOMValidateContext используется с различными структурами подписи (например, не следует использовать один и тот же экземпляр DOMValidateContext для проверки двух разных объектов XMLSignature).

Примечание по реализации:

Реализация JDK поддерживает следующие свойства, которые можно задать с помощью метода setProperty.

org.jcp.xml.dsig.secureValidation: значение должно иметь тип Boolean. Если режим включен, проверка XML-подписей выполняется с более строгой проверкой алгоритмов и других ограничений, указанных в свойстве безопасности jdk.xml.dsig.secureValidationPolicy. Значение по умолчанию, если оно не задано, — Boolean.TRUE. Режим можно отключить, задав свойству значение Boolean.FALSE. Режим также можно включить или отключить, задав системному свойству org.jcp.xml.dsig.secureValidation значение "true" или "false". Любое другое значение системного свойства также интерпретируется как "false". Если системное свойство задано, оно имеет приоритет над значением свойства DOMValidateContext.
org.jcp.xml.dsig.validateManifests: значение должно иметь тип Boolean. Если свойство включено, ссылки в элементах манифеста (если они есть) проверяются во время проверки подписи. Значение по умолчанию, если оно не задано, — Boolean.FALSE.
org.jcp.xml.dsig.internal.dom.SignatureProvider: значение должно иметь тип Provider. Если оно задано, базовый Signature будет создан из этого поставщика.

С версии:

1.6

См. также:

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

Конструктор	Описание
`DOMValidateContext(Key validatingKey, Node node)`	Создает `DOMValidateContext`, содержащий указанные ключ и узел.
`DOMValidateContext(KeySelector ks, Node node)`	Создает `DOMValidateContext`, содержащий указанные селектор ключа и узел.

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

Модификатор и тип	Метод	Описание
`Node`	`getNode()`	Возвращает узел.
`void`	`setNode(Node node)`	Задает узел.

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

get, getBaseURI, getDefaultNamespacePrefix, getElementById, getKeySelector, getNamespacePrefix, getProperty, getURIDereferencer, iterator, put, putNamespacePrefix, setBaseURI, setDefaultNamespacePrefix, setIdAttributeNS, setKeySelector, setProperty, setURIDereferencer

Модификатор и тип	Метод	Описание
`Object`	`get(Object key)`	Эта реализация использует внутренний объект `HashMap` для получения объекта, соответствующего указанному ключу.
`String`	`getBaseURI()`	Возвращает базовый URI.
`String`	`getDefaultNamespacePrefix()`	Возвращает префикс пространства имен по умолчанию.
`Element`	`getElementById(String idValue)`	Возвращает `Element` со значением указанного атрибута ID.
`KeySelector`	`getKeySelector()`	Возвращает селектор ключа для поиска ключа.
`String`	`getNamespacePrefix(String namespaceURI, String defaultPrefix)`	Эта реализация использует внутренний объект `HashMap` для получения префикса, соответствующего указанному URI.
`Object`	`getProperty(String name)`	Эта реализация использует внутренний объект `HashMap` для получения объекта, соответствующего указанному имени.
`URIDereferencer`	`getURIDereferencer()`	Возвращает `URIDereferencer`, используемый для разыменования `URIReference`.
`Iterator<Map.Entry<String,Element>>`	`iterator()`	Возвращает итератор только для чтения по набору сопоставлений Id/Element этого `DOMCryptoContext`.
`Object`	`put(Object key, Object value)`	Эта реализация использует внутренний объект `HashMap` для сопоставления ключа с указанным объектом.
`String`	`putNamespacePrefix(String namespaceURI, String prefix)`	Эта реализация использует внутренний объект `HashMap` для сопоставления URI с указанным префиксом.
`void`	`setBaseURI(String baseURI)`	Задает базовый URI.
`void`	`setDefaultNamespacePrefix(String defaultPrefix)`	Задает префикс пространства имен по умолчанию.
`void`	`setIdAttributeNS(Element element, String namespaceURI, String localName)`	Регистрирует атрибут элемента, указанный URI пространства имен и локальным именем, как атрибут типа ID.
`void`	`setKeySelector(KeySelector ks)`	Задает селектор ключа для поиска ключа.
`Object`	`setProperty(String name, Object value)`	Эта реализация использует внутренний объект `HashMap` для сопоставления имени с указанным объектом.
`void`	`setURIDereferencer(URIDereferencer dereferencer)`	Задает `URIDereferencer`, используемый для разыменования `URIReference`.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 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()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного интервала реального времени.

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

DOMValidateContext

public DOMValidateContext(KeySelector ks, Node node)

Создает DOMValidateContext, содержащий указанные селектор ключа и узел.

Параметры:: ks — селектор ключа для поиска ключа проверки; node — узел
Исключения:: NullPointerException — если ks или node равно null

DOMValidateContext

public DOMValidateContext(Key validatingKey, Node node)

Создает DOMValidateContext, содержащий указанные ключ и узел. Ключ проверки будет сохранен в singleton KeySelector, который возвращается при вызове метода getKeySelector.

Параметры:: validatingKey — ключ проверки; node — узел
Исключения:: NullPointerException — если validatingKey или node равно null

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

setNode

public void setNode(Node node)

Задает узел.

Параметры:

node — узел

Исключения:

NullPointerException — если node равно null

См. также:

getNode

public Node getNode()

Возвращает узел.

Возвращает:

узел (никогда не null)

См. также:

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