compact3

javax.xml.crypto.dsig

Interface Reference

All Superinterfaces:

URIReference， XMLStructure

public interface Reference
extends URIReference, XMLStructure

一个代表性的 Reference元在 W3C Recommendation for XML-Signature Syntax and Processing定义。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实例可以通过调用一个类的方法创建XMLSignatureFactory newReference；例如：

xmlsignaturefactory厂= xmlsignaturefactory getInstance（DOM）；引用ref = factory.newreference（“HTTP：/ / www.ietf。org / RFC / rfc3275 .txt”，工厂。newdigestmethod（digestmethod.sha1，null））；

从以下版本开始：

一点六

另请参见：

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

方法摘要

Modifier and Type	Method and Description
byte[]	getCalculatedDigestValue() 收益计算的摘要值这个 Reference经过验证的操作。
Data	getDereferencedData() 返回引用数据，如果 reference caching启用。
InputStream	getDigestInputStream() 返回预消化的输入流，如果 reference caching启用。
DigestMethod	getDigestMethod() 返回该 Reference消化法。
byte[]	getDigestValue() 返回该 Reference摘要值。
String	getId() 返回该 Reference可选 Id属性，允许这是从其他地方引用参考。
List	getTransforms() 返回 Transforms，都包含在这一个 unmodifiable list Reference。
boolean	validate(XMLValidateContext validateContext) 验证此参考。

Methods inherited from interface javax.xml.crypto.URIReference

getType, getURI

Methods inherited from interface javax.xml.crypto.XMLStructure

isFeatureSupported

方法详细信息

getTransforms

List getTransforms()

返回 Transforms，都包含在这一个 unmodifiable list Reference。

结果

Transforms的一个不可修改的列表（可能为空而不 null）

getDigestMethod

DigestMethod getDigestMethod()

返回该 Reference消化法。

结果

消化法

getId

String getId()

返回该 Reference可选 Id属性，允许这是从其他地方引用参考。

结果

的 Id属性（可能是 null如果不指定）

getDigestValue

byte[] getDigestValue()

返回该 Reference摘要值。

结果

原摘要值，或 null如果引用尚未消化呢。此方法的每次调用返回一个新的克隆，以防止后续的修改。

getCalculatedDigestValue

byte[] getCalculatedDigestValue()

收益计算的摘要值这个 Reference经过验证的操作。此方法是有用的，如果参考失败，以验证调试。

结果

计算的摘要值，或 null如果引用尚未验证。此方法的每次调用返回一个新的克隆，以防止后续的修改。

validate

boolean validate(XMLValidateContext validateContext)
          throws XMLSignatureException

验证此参考。此方法验证了此引用的摘要。

此方法只在调用它时验证引用的第一次。在随后的调用，它返回一个缓存的结果。

参数

validateContext -验证的上下文

结果

true如果引用成功地进行了验证； false否则

异常

如果是 null validateContext NullPointerException

XMLSignatureException如果发生意外的异常在验证参考

getDereferencedData

Data getDereferencedData()

返回引用数据，如果 reference caching启用。这是由于引用参考的URI中验证或代运营。

结果

的引用数据，或 null如果参考缓存未启用或参考尚未生成或验证

getDigestInputStream

InputStream getDigestInputStream()

返回预消化的输入流，如果 reference caching启用。这是一个在验证或签名操作期间输入到摘要操作的过程。

结果

包含预先消化输入输入流、或 null如果参考缓存未启用或参考尚未生成或验证