javax.xml.crypto.dsig

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

Все Суперинтерфейсы:

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>
 

A 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

См. Также:

XMLSignatureFactory.newReference(String, DigestMethod), XMLSignatureFactory.newReference(String, DigestMethod, List, String, String)

Сводка метода

Методы

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

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

getType, getURI

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

isFeatureSupported

Деталь метода

getTransforms

List getTransforms()

Возвраты unmodifiable list из Transforms, которые содержатся в этом Reference.

Возвраты:

неподдающийся изменению список Transforms (может быть пустым, но никогда null)

getDigestMethod

DigestMethod getDigestMethod()

Возвращает метод обзора этого Reference.

Возвраты:

метод обзора

getId

String getId()

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

Возвраты:

Id атрибут (может быть null если не определенный)

getDigestValue

byte[] getDigestValue()

Возвращает значение обзора этого Reference.

Возвраты:

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

getCalculatedDigestValue

byte[] getCalculatedDigestValue()

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

Возвраты:

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

проверить

boolean validate(XMLValidateContext validateContext)
                 throws XMLSignatureException

Проверяет этой ссылки. Этот метод проверяет обзор этой ссылки.

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

Параметры:

validateContext - контекст проверки допустимости

Возвраты:

true если эта ссылка была проверена успешно; false иначе

Броски:

NullPointerException - если validateContext null

XMLSignatureException - если неожиданное исключение происходит, проверяя ссылки

getDereferencedData

Data getDereferencedData()

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

Возвраты:

разыменованные данные, или null если ссылочное кэширование не включается, или эта ссылка не была сгенерирована или проверена

getDigestInputStream

InputStream getDigestInputStream()

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

Возвраты:

входной поток, содержащий предварительно переваренный ввод, или null если ссылочное кэширование не включается, или эта ссылка не была сгенерирована или проверена