RetrievalMethod - Java 11中文版 - API参考文档

API Reference Document

All Superinterfaces:

URIReference ， XMLStructure
```
public interface RetrievalMethod
extends URIReference, XMLStructure
```
在XML的表示RetrievalMethod元件中的定义， W3C Recommendation for XML-Signature Syntax and Processing 。甲RetrievalMethod对象用于传达到参考KeyInfo存储在另一个位置信息。 XML模式定义定义为：
```
  <element name="RetrievalMethod" type="ds:RetrievalMethodType"/>
   <complexType name="RetrievalMethodType">
     <sequence>
       <element name="Transforms" type="ds:TransformsType" minOccurs="0"/>
     </sequence>
     <attribute name="URI" type="anyURI"/>
     <attribute name="Type" type="anyURI" use="optional"/>
   </complexType> 
```
可以通过调用KeyInfoFactory类的newRetrievalMethod方法之一来创建RetrievalMethod实例，并向其传递标识KeyInfo位置的URI，标识KeyInfo类型的可选类型URI以及可选的列表Transform ; 例如：
```
  KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");
   RetrievalMethod rm = factory.newRetrievalMethod
      ("#KeyValue-1", KeyValue.DSA_TYPE, Collections.singletonList(Transform.BASE64)); 
```
从以下版本开始：

1.6

另请参见：

KeyInfoFactory.newRetrievalMethod(String) ， KeyInfoFactory.newRetrievalMethod(String, String, List)

方法摘要

所有方法实例方法抽象方法
变量和类型	方法	描述
`Data`	`dereference(XMLCryptoContext context)`	取消引用 `KeyInfo` this引用信息 `RetrievalMethod`和应用指定 `Transform`秒。
`List<Transform>`	`getTransforms()`	返回`unmodifiable list` of `Transform` s of `RetrievalMethod` 。
`String`	`getURI()`	返回引用的 `KeyInfo`信息的URI。

声明方法的接口 javax.xml.crypto.URIReference
getType

声明方法的接口 javax.xml.crypto.XMLStructure
isFeatureSupported

- 方法详细信息
  - getTransforms
```
List<Transform> getTransforms()
```
    返回unmodifiable list of Transform s of RetrievalMethod 。
    
    结果
    
    Transform对象的不可修改列表（可能为空但从不为 null ）。
  - getURI
```
String getURI()
```
    返回引用的 KeyInfo信息的URI。
    
    Specified by:
    
    getURI接口 URIReference
    
    结果
    
    RFC 2396格式中引用的 KeyInfo信息的URI（从不 null ）
  - dereference
```
Data dereference(XMLCryptoContext context)
          throws URIReferenceException
```
    取消引用 KeyInfo this引用信息 RetrievalMethod和应用指定 Transform秒。
    
    参数
    
    context - XMLCryptoContext ，可能包含用于解除引用URI的其他有用信息。上下文的baseURI和dereferencer参数（如果指定）用于解析和取消引用此RetrievalMethod
    
    结果
    
    表示此RetrievalMethod引用的KeyInfo信息的原始内容的Data对象。调用者有责任将返回的数据转换为适当的KeyInfo对象。
    
    异常
    
    NullPointerException - 如果 context是 null
    
    URIReferenceException - 如果解除引用时出错