- すべてのスーパー・インタフェース:
URIReference
,XMLStructure
public interface RetrievalMethod extends URIReference, XMLStructure
「W3C Recommendation for XML-Signature Syntax and Processing」で定義されているXML
RetrievalMethod
要素の表現。 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>
RetrievalMethod
インスタンスは、KeyInfoFactory
クラスのnewRetrievalMethod
メソッドの1つを呼び出し、KeyInfoの位置を識別するURI、オプションのKeyInfoの型を識別する型URI、およびオプションのTransform
のリストを渡すことによって作成されます。次に例を示します。
KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM"); RetrievalMethod rm = factory.newRetrievalMethod ("#KeyValue-1", KeyValue.DSA_TYPE, Collections.singletonList(Transform.BASE64));
-
メソッドのサマリー
修飾子と型メソッド説明dereference
(XMLCryptoContext context) このRetrievalMethod
によって参照されるKeyInfo
情報を間接参照し、指定したTransform
を適用します。このRetrievalMethod
のTransform
のunmodifiable list
を返します。getURI()
参照されたKeyInfo
情報のURIを返します。インタフェース javax.xml.crypto.URIReferenceで宣言されたメソッド
getType
インタフェース javax.xml.crypto.XMLStructureで宣言されたメソッド
isFeatureSupported
-
メソッドの詳細
-
getTransforms
このRetrievalMethod
のTransform
のunmodifiable list
を返します。- 戻り値:
Transform
オブジェクトの変更不可能なリスト。空の場合もあるがnull
になることはない。
-
getURI
String getURI()参照されたKeyInfo
情報のURIを返します。- 定義:
getURI
、インタフェース:URIReference
- 戻り値:
- RFC 2396形式の、参照された
KeyInfo
情報のURI。null
になることはない
-
dereference
このRetrievalMethod
によって参照されるKeyInfo
情報を間接参照し、指定したTransform
を適用します。- パラメータ:
context
- URIの間接参照に役立つ追加情報が含まれている場合のあるXMLCryptoContext
。 コンテキストのbaseURI
およびdereferencer
パラメータ(指定されている場合)は、このRetrievalMethod
の解決と間接参照に使用される- 戻り値:
- この
RetrievalMethod
によって参照されるKeyInfo
情報のrawコンテンツを表すData
オブジェクト。 呼出し側で、返されたデータを適切なKeyInfo
オブジェクトに変換する必要がある。 - 例外:
NullPointerException
-context
がnull
である場合URIReferenceException
- 間接参照の間にエラーが発生した場合
-