JavaTM Platform
Standard Ed. 6

javax.xml.crypto.dsig.keyinfo
インタフェース KeyInfo

すべてのスーパーインタフェース:
XMLStructure

public interface KeyInfo
extends XMLStructure

W3C Recommendation for XML-Signature Syntax and Processing」で定義されている XML KeyInfo 要素の表現。KeyInfo には、XMLStructure のリストが含まれています。それぞれの XMLStructure には、XML 署名を検証するために必要な鍵を受信者が取得できるようにする情報が格納されています。XML スキーマ定義は、次のように定義されます。

 <element name="KeyInfo" type="ds:KeyInfoType"/> 
 <complexType name="KeyInfoType" mixed="true">
   <choice maxOccurs="unbounded">     
     <element ref="ds:KeyName"/> 
     <element ref="ds:KeyValue"/> 
     <element ref="ds:RetrievalMethod"/>
     <element ref="ds:X509Data"/>
     <element ref="ds:PGPData"/>
     <element ref="ds:SPKIData"/>
     <element ref="ds:MgmtData"/>
     <any processContents="lax" namespace="##other"/>
     <!-- (1,1) elements from (0,unbounded) namespaces -->
   </choice>
   <attribute name="Id" type="ID" use="optional"/> 
 </complexType>
 
KeyInfo インスタンスは、KeyInfoFactory クラスの newKeyInfo メソッドの 1 つを呼び出し、それに 1 つ以上の XMLStructure および省略可能な id パラメータのリストを渡すことによって作成されます。次に例を示します。
   KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");
   KeyInfo keyInfo = factory.newKeyInfo
        (Collections.singletonList(factory.newKeyName("Alice"), "keyinfo-1"));
 
 

KeyInfo オブジェクトは、marshal メソッドを呼び出すことによっても XML に整列化できます。

導入されたバージョン:
1.6
関連項目:
KeyInfoFactory.newKeyInfo(List), KeyInfoFactory.newKeyInfo(List, String)

メソッドの概要
 List getContent()
          鍵情報を格納する変更不可能なリストを返します。
 String getId()
          この KeyInfo の省略可能な id 属性を返します。
 void marshal(XMLStructure parent, XMLCryptoContext context)
          鍵情報を XML に整列化します。
 
インタフェース javax.xml.crypto.XMLStructure から継承されたメソッド
isFeatureSupported
 

メソッドの詳細

getContent

List getContent()
鍵情報を格納する変更不可能なリストを返します。リストのそれぞれのエントリは、XMLStructure です。  

XMLStructure の型を表現する public サブクラスがある場合、そのクラスのインスタンスとして返されます。たとえば、X509Data 要素は X509Data のインスタンスとして返されます。

戻り値:
この KeyInfo 内の 1 つ以上の XMLStructure の変更不可能なリスト。null または 空のリストが返されることはない。

getId

String getId()
この KeyInfo の省略可能な id 属性を返します。KeyInfo をほかの XML 構造から参照する場合に有用です。

戻り値:
この KeyInfo の id 属性。 指定されない場合は、null も可

marshal

void marshal(XMLStructure parent,
             XMLCryptoContext context)
             throws MarshalException
鍵情報を XML に整列化します。

パラメータ:
parent - 整列化された鍵情報が追加される 親ノードを格納する、機構固有の構造
context - 追加のコンテキストを格納する XMLCryptoContext。 適用不可の場合は、null も可
例外:
ClassCastException - parent の型または context が、この鍵情報と互換性がない場合
MarshalException - 鍵情報を整列化できない場合
NullPointerException - parentnull の場合

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。