Ссылка на интерфейс

Все суперинтерфейсы:: URIReference, XMLStructure

public interface Reference extends URIReference, XMLStructure

Представление элемента Reference, как определено в рекомендации W3C по синтаксису и обработке XML-подписей. Схема XML определена как:

 <element name="Reference" type="ds:ReferenceType"/>
 <complexType name="ReferenceType">
   <sequence>
     <element ref="ds:Transforms" minOccurs="0"/>
     <element ref="ds:DigestMethod"/>
     <element ref="ds:DigestValue"/>
   </sequence>
   <attribute name="Id" type="ID" use="optional"/>
   <attribute name="URI" type="anyURI" use="optional"/>
   <attribute name="Type" type="anyURI" use="optional"/>
 </complexType>

 <element name="DigestValue" type="ds:DigestValueType"/>
 <simpleType name="DigestValueType">
   <restriction base="base64Binary"/>
 </simpleType>

Объект Reference можно создать, вызвав один из методов newReference класса XMLSignatureFactory; например:

   XMLSignatureFactory factory = XMLSignatureFactory.getInstance("DOM");
   Reference ref = factory.newReference
     ("http://www.ietf.org/rfc/rfc3275.txt",
      factory.newDigestMethod(DigestMethod.SHA1, null));

С:

1.6

См. также:

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

Модификатор и тип	Метод	Описание
`byte[]`	`getCalculatedDigestValue()`	Возвращает вычисленный значение дайджеста этого `Reference` после операции проверки.
`Data`	`getDereferencedData()`	Возвращает данные, полученные по ссылке, если включено кеширование ссылок (кеширование ссылок).
`InputStream`	`getDigestInputStream()`	Возвращает предварительно дайджестированный входной поток, если включено кеширование ссылок (кеширование ссылок).
`DigestMethod`	`getDigestMethod()`	Возвращает метод дайджеста этого `Reference`.
`byte[]`	`getDigestValue()`	Возвращает значение дайджеста этого `Reference`.
`String`	`getId()`	Возвращает необязательное атрибут `Id` этого `Reference`, что позволяет ссылаться на эту ссылку из других мест.
`List<Transform>`	`getTransforms()`	Возвращает список `unmodifiable list` объектов `Transform`, содержащихся в этом `Reference`.
`boolean`	`validate(XMLValidateContext validateContext)`	Проверяет эту ссылку.

Методы, объявленные в интерфейсе javax.xml.crypto.URIReference

getType, getURI

Методы, объявленные в интерфейсе javax.xml.crypto.XMLStructure

isFeatureSupported

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

getTransforms

List<Transform> getTransforms()

Возвращает список

unmodifiable
 list

объектов Transform, содержащихся в этом Reference.

Возвращает:: неизменяемый список Transform (может быть пустым, но никогда null)

getDigestMethod

DigestMethod getDigestMethod()

Возвращает метод дайджеста этого Reference.

Возвращает:: метод дайджеста

getId

String getId()

Возвращает необязательное атрибут Id этого Reference, что позволяет ссылаться на эту ссылку из других мест.

Возвращает:: атрибут Id (может быть null, если не указан)

getDigestValue

byte[] getDigestValue()

Возвращает значение дайджеста этого Reference.

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

getCalculatedDigestValue

byte[] getCalculatedDigestValue()

Возвращает вычисленное значение дайджеста этого Reference после операции проверки. Этот метод полезен для отладки, если ссылка не прошла проверку.

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

validate

boolean validate(XMLValidateContext validateContext) throws XMLSignatureException

Проверяет эту ссылку. Этот метод проверяет дайджест этой ссылки.

Этот метод проверяет ссылку только в первый раз, когда он вызывается. При последующих вызовах он возвращает кешированный результат.

Параметры:: validateContext - контекст проверки
Возвращает:: true, если ссылка была успешно проверена; false в противном случае
Исключения:: NullPointerException - если validateContext равно null; XMLSignatureException - если во время проверки ссылки произошла непредвиденная ошибка

getDereferencedData

Data getDereferencedData()

Возвращает данные, полученные по ссылке, если включено кеширование ссылок (кеширование ссылок). Это результат получения данных по URI этой ссылки во время операции проверки или генерации.

Возвращает:: полученные данные или null, если кеширование ссылок не включено или эта ссылка не была сгенерирована или проверена

getDigestInputStream

InputStream getDigestInputStream()

Возвращает предварительно дайджестированный входной поток, если включено кеширование ссылок (кеширование ссылок). Это входные данные для операции дайджестирования во время операции проверки или подписания.

Возвращает:: входной поток, содержащий предварительно дайджестированные данные, или 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.xml.crypto/javax/xml/crypto/dsig/Reference.html