Класс DOMSignContext

java.lang.Object

javax.xml.crypto.dom.DOMCryptoContext

javax.xml.crypto.dsig.dom.DOMSignContext

Все реализуемые интерфейсы:: XMLSignContext, XMLCryptoContext

public class DOMSignContext extends DOMCryptoContext implements XMLSignContext

Реализация XMLSignContext, специфичная для DOM. Этот класс содержит дополнительные методы для указания расположения в дереве DOM, в котором объект XMLSignature должен быть преобразован в XML при создании подписи.

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

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

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

org.jcp.xml.dsig.internal.dom.SignatureProvider: значение должно быть объектом Provider. Если свойство задано, базовый Signature будет создан на основе этого поставщика.
jdk.xmldsig.SecureRandom: значение должно быть объектом SecureRandom. Если свойство задано, этот объект будет использоваться для инициализации базового Signature при подписании с помощью метода Signature.initSign(PrivateKey, SecureRandom).

С момента:

1.6

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

Конструктор	Описание
`DOMSignContext(Key signingKey, Node parent)`	Создает `DOMSignContext` с указанным ключом подписи и родительским узлом.
`DOMSignContext(Key signingKey, Node parent, Node nextSibling)`	Создает `DOMSignContext` с указанным ключом подписи, родительским узлом и следующим соседним узлом.
`DOMSignContext(KeySelector ks, Node parent)`	Создает `DOMSignContext` с указанным селектором ключа и родительским узлом.
`DOMSignContext(KeySelector ks, Node parent, Node nextSibling)`	Создает `DOMSignContext` с указанным селектором ключа, родительским узлом и следующим соседним узлом.

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

Модификатор и тип	Метод	Описание
`Node`	`getNextSibling()`	Возвращает узел nextSibling.
`Node`	`getParent()`	Возвращает родительский узел.
`void`	`setNextSibling(Node nextSibling)`	Задает следующий соседний узел.
`void`	`setParent(Node parent)`	Задает родительский узел.

Методы, объявленные в классе 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)`	В этой реализации для получения префикса, соответствующего указанному URI, используется внутренняя `HashMap`.
`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)`	В этой реализации для сопоставления URI с указанным префиксом используется внутренняя `HashMap`.
`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, либо до истечения заданного времени.

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

DOMSignContext

public DOMSignContext(Key signingKey, Node parent)

Создает DOMSignContext с указанным ключом подписи и родительским узлом. Ключ подписи сохраняется в singleton KeySelector, который возвращается методом getKeySelector. Преобразованный в XML объект XMLSignature будет добавлен как последний дочерний элемент указанного родительского узла, если только следующий соседний узел не задан вызовом метода setNextSibling.

Параметры:: signingKey — ключ подписи; parent — родительский узел
Исключения:: NullPointerException — если signingKey или parent имеет значение null

DOMSignContext

public DOMSignContext(Key signingKey, Node parent, Node nextSibling)

Создает DOMSignContext с указанными ключом подписи, родительским узлом и следующим соседним узлом. Ключ подписи сохраняется в singleton KeySelector, который возвращается методом getKeySelector. Преобразованный в XML объект XMLSignature будет вставлен как дочерний элемент указанного родительского узла непосредственно перед указанным следующим соседним узлом.

Параметры:: signingKey — ключ подписи; parent — родительский узел; nextSibling — следующий соседний узел
Исключения:: NullPointerException — если signingKey, parent или nextSibling имеет значение null

DOMSignContext

public DOMSignContext(KeySelector ks, Node parent)

Создает DOMSignContext с указанным селектором ключа и родительским узлом. Преобразованный в XML объект XMLSignature будет добавлен как последний дочерний элемент указанного родительского узла, если только следующий соседний узел не задан вызовом метода setNextSibling.

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

DOMSignContext

public DOMSignContext(KeySelector ks, Node parent, Node nextSibling)

Создает DOMSignContext с указанными селектором ключа, родительским узлом и следующим соседним узлом. Преобразованный в XML объект XMLSignature будет вставлен как дочерний элемент указанного родительского узла непосредственно перед указанным следующим соседним узлом.

Параметры:: ks — селектор ключа; parent — родительский узел; nextSibling — следующий соседний узел
Исключения:: NullPointerException — если ks, parent или nextSibling имеет значение null

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

setParent

public void setParent(Node parent)

Задает родительский узел.

Параметры:

parent — родительский узел. Преобразованный в XML объект XMLSignature будет добавлен как дочерний элемент этого узла.

Исключения:

NullPointerException — если parent имеет значение null

См. также:

setNextSibling

public void setNextSibling(Node nextSibling)

Задает следующий соседний узел.

Параметры:

nextSibling — следующий соседний узел. Преобразованный в XML объект XMLSignature будет вставлен непосредственно перед этим узлом. Укажите null, чтобы удалить текущую настройку.

См. также:

getParent

public Node getParent()

Возвращает родительский узел.

Возвращает:

родительский узел (никогда не null)

См. также:

getNextSibling

public Node getNextSibling()

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

Возвращает:

узел nextSibling или 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.