204 lines
10 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact3
</div>
<div class="subTitle">
javax.xml.crypto.dsig.keyinfo
</div>
<h2 class="title" title="Interface RetrievalMethod">Interface RetrievalMethod</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Superinterfaces:
</dt>
<dd>
<span><a href="../../../../../javax/xml/crypto/URIReference.html" title="javax.xml.crypto中的接口">URIReference</a> <a href="../../../../../javax/xml/crypto/XMLStructure.html" title="javax.xml.crypto中的接口">XMLStructure</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">RetrievalMethod</span>
extends <a href="../../../../../javax/xml/crypto/URIReference.html" title="interface in javax.xml.crypto">URIReference</a>, <a href="../../../../../javax/xml/crypto/XMLStructure.html" title="interface in javax.xml.crypto">XMLStructure</a></pre>
<div class="block">
<span>W3C Recommendation for XML-Signature Syntax and Processing中定义的XML <code>RetrievalMethod</code>元素的<a href="http://www.w3.org/TR/xmldsig-core/">表示</a></span>
<span><code>RetrievalMethod</code>对象用于传递存储在另一位置的<code>KeyInfo</code>引用。</span>
<span>XML模式定义定义为</span>
<pre> <span>&lt;element name="RetrievalMethod" type="ds:RetrievalMethodType"/&gt;
&lt;complexType name="RetrievalMethodType"&gt;
&lt;sequence&gt;
&lt;element name="Transforms" type="ds:TransformsType" minOccurs="0"/&gt;
&lt;/sequence&gt;
&lt;attribute name="URI" type="anyURI"/&gt;
&lt;attribute name="Type" type="anyURI" use="optional"/&gt;
&lt;/complexType&gt;</span> </pre>
<span>可以通过调用<a href="../../../../../javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.html" title="javax.xml.crypto.dsig.keyinfo中的类"><code>KeyInfoFactory</code></a>类的<a href="../../../../../javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.html#newRetrievalMethod-java.lang.String-"><code>newRetrievalMethod</code></a>方法之一来创建一个<code>RetrievalMethod</code>实例并将其标识KeyInfo的位置的URI一个标识KeyInfo类型的可选类型的URI以及一个可选的<a href="../../../../../javax/xml/crypto/dsig/Transform.html" title="javax.xml.crypto.dsig中的接口"><code>Transform</code></a>的列表;</span>
<span>例如:</span>
<pre> <span>KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");
RetrievalMethod rm = factory.newRetrievalMethod
("#KeyValue-1", KeyValue.DSA_TYPE, Collections.singletonList(Transform.BASE64));</span> </pre>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.6
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../../../javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.html#newRetrievalMethod-java.lang.String-"><code>KeyInfoFactory.newRetrievalMethod(String)</code></a>
<a href="../../../../../javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.html#newRetrievalMethod-java.lang.String-java.lang.String-java.util.List-"><code>KeyInfoFactory.newRetrievalMethod(String, String, List)</code></a>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code><a href="../../../../../javax/xml/crypto/Data.html" title="interface in javax.xml.crypto">Data</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/crypto/dsig/keyinfo/RetrievalMethod.html#dereference-javax.xml.crypto.XMLCryptoContext-">dereference</a></span>(<a href="../../../../../javax/xml/crypto/XMLCryptoContext.html" title="interface in javax.xml.crypto">XMLCryptoContext</a> context)</code>
<div class="block">
取消引用
<code>KeyInfo</code> this引用信息
<code>RetrievalMethod</code>和应用指定的
<code>Transform</code>秒。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../../../java/util/List.html" title="interface in java.util">List</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/crypto/dsig/keyinfo/RetrievalMethod.html#getTransforms--">getTransforms</a></span>()</code>
<div class="block">
<span>返回这<a href="../../../../../java/util/Collections.html#unmodifiableList-java.util.List-">RetrievalMethod</a><a href="../../../../../javax/xml/crypto/dsig/Transform.html" title="javax.xml.crypto.dsig中的接口"><code>Transform</code></a><code>RetrievalMethod</code></span>
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../javax/xml/crypto/dsig/keyinfo/RetrievalMethod.html#getURI--">getURI</a></span>()</code>
<div class="block">
返回引用的
<code>KeyInfo</code>信息的URI。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.xml.crypto.URIReference">
<!-- --> </a> <h3>Methods inherited from interface javax.xml.crypto.<a href="../../../../../javax/xml/crypto/URIReference.html" title="interface in javax.xml.crypto">URIReference</a></h3> <code><a href="../../../../../javax/xml/crypto/URIReference.html#getType--">getType</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.xml.crypto.XMLStructure">
<!-- --> </a> <h3>Methods inherited from interface javax.xml.crypto.<a href="../../../../../javax/xml/crypto/XMLStructure.html" title="interface in javax.xml.crypto">XMLStructure</a></h3> <code><a href="../../../../../javax/xml/crypto/XMLStructure.html#isFeatureSupported-java.lang.String-">isFeatureSupported</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getTransforms--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTransforms</h4> <pre><a href="../../../../../java/util/List.html" title="interface in java.util">List</a> getTransforms()</pre>
<div class="block">
<span>返回这<a href="../../../../../java/util/Collections.html#unmodifiableList-java.util.List-">RetrievalMethod</a><a href="../../../../../javax/xml/crypto/dsig/Transform.html" title="javax.xml.crypto.dsig中的接口"><code>Transform</code></a><code>RetrievalMethod</code></span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个不可修改的
<code>Transform</code>对象列表(可能为空,但不能为
<code>null</code> )。
</dd>
</dl> </li>
</ul> <a name="getURI--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getURI</h4> <pre><a href="../../../../../java/lang/String.html" title="class in java.lang">String</a> getURI()</pre>
<div class="block">
返回引用的
<code>KeyInfo</code>信息的URI。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../../javax/xml/crypto/URIReference.html#getURI--">getURI</a></code>在界面
<code><a href="../../../../../javax/xml/crypto/URIReference.html" title="interface in javax.xml.crypto">URIReference</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
RFC 2396格式的引用的
<code>KeyInfo</code>信息的URI从不
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="dereference-javax.xml.crypto.XMLCryptoContext-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>dereference</h4> <pre><a href="../../../../../javax/xml/crypto/Data.html" title="interface in javax.xml.crypto">Data</a> dereference(<a href="../../../../../javax/xml/crypto/XMLCryptoContext.html" title="interface in javax.xml.crypto">XMLCryptoContext</a> context)
throws <a href="../../../../../javax/xml/crypto/URIReferenceException.html" title="class in javax.xml.crypto">URIReferenceException</a></pre>
<div class="block">
取消引用
<code>KeyInfo</code> this引用信息
<code>RetrievalMethod</code>和应用指定的
<code>Transform</code>秒。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>context</code> - 一个<code>XMLCryptoContext</code> 可能包含用于取消引用URI的其他有用信息。</span>
<span>上下文的<code>baseURI</code><code>dereferencer</code>参数(如果指定)用于解析和取消引用此<code>RetrievalMethod</code></span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一个<code>Data</code>对象表示的原始内容<code>KeyInfo</code>由该参考信息<code>RetrievalMethod</code></span>
<span>调用者有责任将返回的数据转换为适当的<code>KeyInfo</code>对象。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果
<code>context</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../../../../javax/xml/crypto/URIReferenceException.html" title="class in javax.xml.crypto">URIReferenceException</a></code> - 如果在取消引用时出现错误
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>