-
- すべてのスーパー・インタフェース:
XMLStructure
public interface KeyInfo extends XMLStructure
「W3C Recommendation for XML-Signature Syntax and Processing」で定義されているXMLKeyInfo
要素の表現。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<XMLStructure>
getContent()
キー情報を格納するunmodifiable list
を返します。String
getId()
このKeyInfo
のオプションのid属性を返します。KeyInfo
をほかのXML構造から参照する場合に有用です。void
marshal(XMLStructure parent, XMLCryptoContext context)
キー情報をXMLに整列化します。-
インタフェース javax.xml.crypto.XMLStructureで宣言されたメソッド
isFeatureSupported
-
-
-
-
メソッドの詳細
-
getContent
List<XMLStructure> getContent()
キー情報を格納するunmodifiable list
を返します。 リストのそれぞれのエントリは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
-parent
がnull
である場合
-
-