public interface Reference extends URIReference, XMLStructure
Reference
элемент как определено в
<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
class; например:
XMLSignatureFactory factory = XMLSignatureFactory.getInstance("DOM"); Reference ref = factory.newReference ("http://www.ietf.org/rfc/rfc3275.txt", factory.newDigestMethod(DigestMethod.SHA1, null));
Модификатор и Тип | Метод и Описание |
---|---|
byte[] |
getCalculatedDigestValue()
Возвращает расчетное значение обзора этого
Reference после работы проверки допустимости. |
Данные |
getDereferencedData()
Возвращает разыменованные данные, если ссылочное кэширование включается.
|
InputStream |
getDigestInputStream()
Возвращает предварительно переваренный входной поток, если ссылочное кэширование включается.
|
DigestMethod |
getDigestMethod()
Возвращает метод обзора этого
Reference . |
byte[] |
getDigestValue()
Возвращает значение обзора этого
Reference . |
Строка |
getId()
Возвращает дополнительное
Id атрибут этого Reference , который разрешает этой ссылке ссылаться откуда-либо. |
Список |
getTransforms()
|
boolean |
validate(XMLValidateContext validateContext)
Проверяет этой ссылки.
|
getType, getURI
isFeatureSupported
List getTransforms()
Transform
s (может быть пустым, но никогда null
)DigestMethod getDigestMethod()
Reference
.String getId()
Id
атрибут этого Reference
, который разрешает этой ссылке ссылаться откуда-либо.Id
атрибут (может быть null
если не определенный)byte[] getDigestValue()
Reference
.null
если эта ссылка еще не была переварена. Каждый вызов этого метода возвращает нового клона, чтобы защитить от последующей модификации.byte[] getCalculatedDigestValue()
Reference
после работы проверки допустимости. Этот метод полезен для отладки, если ссылка не в состоянии проверить.null
если эта ссылка еще не была проверена. Каждый вызов этого метода возвращает нового клона, чтобы защитить от последующей модификации.boolean validate(XMLValidateContext validateContext) throws XMLSignatureException
Этот метод только проверяет ссылки в первый раз, когда это вызывается. На последующих вызовах это возвращает кэшируемый результат.
validateContext
- контекст проверки допустимостиtrue
если эта ссылка была проверена успешно; false
иначеNullPointerException
- если validateContext
null
XMLSignatureException
- если неожиданное исключение происходит, проверяя ссылкиData getDereferencedData()
null
если ссылочное кэширование не включается, или эта ссылка не была сгенерирована или проверенаInputStream getDigestInputStream()
null
если ссылочное кэширование не включается, или эта ссылка не была сгенерирована или проверена
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92