クラスDOMValidateContext

java.lang.Object

javax.xml.crypto.dom.DOMCryptoContext

javax.xml.crypto.dsig.dom.DOMValidateContext

すべての実装されたインタフェース:

XMLValidateContext, XMLCryptoContext

public class DOMValidateContext extends DOMCryptoContext implements XMLValidateContext

DOM固有のXMLValidateContext。 このクラスには、XMLSignatureが非整列化され検証されるDOMツリーでの位置を指定する追加のメソッドが格納されます。

XMLSignatureの作成後に、基本となるDOMツリーのコンテンツが呼出し側によって変更された場合、非整列化されたXMLSignatureの動作は定義されていません。

また、DOMValidateContextインスタンスには、ともに使用されるXML署名構造に固有の情報および状態を格納できます。 DOMValidateContextが異なる署名構造(たとえば、同じDOMValidateContextインスタンスを使用して2つの異なるXMLSignatureオブジェクトに署名すべきでない)とともに使用された場合、予想外の結果となります。

実装上のノート:

JDK実装では、setPropertyメソッドを使用して設定できる次のプロパティがサポートされます。

• org.jcp.xml.dsig.secureValidation: 値はBooleanである必要があります。 有効にすると、XMLシグネチャの検証は、jdk.xml.dsig.secureValidationPolicyセキュリティ・プロパティで指定されたアルゴリズムおよびその他の制約をより厳格にチェックします。 指定しない場合のデフォルト値はBoolean.TRUEです。 モードを無効にするには、プロパティをBoolean.FALSEに設定します。 モードは、org.jcp.xml.dsig.secureValidationシステム・プロパティを"true"または"false"に設定して有効または無効にすることもできます。 システム・プロパティのその他の値は、"false"としても処理されます。 システム・プロパティが設定されている場合は、DOMValidateContextプロパティ値よりも優先されます。
• org.jcp.xml.dsig.validateManifests: 値はBooleanである必要があります。 有効にすると、署名の検証中にマニフェスト要素内の参照(存在する場合)が検証されます。 指定されない場合のデフォルト値は、Boolean.FALSEです。
• org.jcp.xml.dsig.internal.dom.SignatureProvider: 値はProviderである必要があります。 指定すると、基礎となるSignatureがこのプロバイダからインスタンス化されます。

導入されたバージョン:

1.6

関連項目:

• XMLSignatureFactory.unmarshalXMLSignature(XMLValidateContext)

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
DOMValidateContext(Key validatingKey, Node node)	指定したキーおよびノードを格納するDOMValidateContextを作成します。
DOMValidateContext(KeySelector ks, Node node)	指定したキー・セレクタおよびノードを格納するDOMValidateContextを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
Node	getNode()	ノードを返します。
void	setNode(Node node)	ノードを設定します。

クラスで宣言されたメソッド DOMCryptoContext

get, getBaseURI, getDefaultNamespacePrefix, getElementById, getKeySelector, getNamespacePrefix, getProperty, getURIDereferencer, iterator, put, putNamespacePrefix, setBaseURI, setDefaultNamespacePrefix, setIdAttributeNS, setKeySelector, setProperty, setURIDereferencer

修飾子と型	メソッド	説明
Object	get(Object key)	この実装は内部HashMapを使用して、指定したキーがマッピングするオブジェクトを取得します。
String	getBaseURI()	ベースURIを返します。
String	getDefaultNamespacePrefix()	デフォルトの名前空間接頭辞を返します。
Element	getElementById(String idValue)	指定されたID属性値を含むElementを返します。
KeySelector	getKeySelector()	キーの検索用のキー・セレクタを返します。
String	getNamespacePrefix(String namespaceURI, String defaultPrefix)	この実装は内部HashMapを使用して、指定したURIがマッピングする接頭辞を取得します。
Object	getProperty(String name)	この実装は内部HashMapを使用して、指定した名前がマッピングするオブジェクトを取得します。
URIDereferencer	getURIDereferencer()	URIReferenceの間接参照に使用されるURIDereferencerを返します。
Iterator<Map.Entry<String,Element>>	iterator()	このDOMCryptoContextの識別子/要素マッピングのセットに対する、読込み専用イテレータを返します。
Object	put(Object key, Object value)	この実装は内部HashMapを使用して、キーを指定したオブジェクトにマッピングします。
String	putNamespacePrefix(String namespaceURI, String prefix)	この実装は内部HashMapを使用して、URIを指定した接頭辞にマッピングします。
void	setBaseURI(String baseURI)	ベースURIを設定します。
void	setDefaultNamespacePrefix(String defaultPrefix)	デフォルトの名前空間接頭辞を設定します。
void	setIdAttributeNS(Element element, String namespaceURI, String localName)	名前空間URIおよび型IDとなるローカル名によって指定される要素の属性を登録します。
void	setKeySelector(KeySelector ks)	キーの検索用のキー・セレクタを設定します。
Object	setProperty(String name, Object value)	この実装は内部HashMapを使用して、名前を指定したオブジェクトにマッピングします。
void	setURIDereferencer(URIDereferencer dereferencer)	URIReferenceの間接参照に使用されるURIDereferencerを設定します。

クラスオブジェクトで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

修飾子と型	メソッド	説明
protected Object	clone()	このオブジェクトのコピーを作成して、返します。
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

コンストラクタの詳細

DOMValidateContext

public DOMValidateContext(KeySelector ks, Node node)

指定したキー・セレクタおよびノードを格納するDOMValidateContextを作成します。

パラメータ:

ks - 検証キーを検索するためのキー・セレクタ

node - ノード

スロー:

NullPointerException - ksまたはnodeがnullの場合

DOMValidateContext

public DOMValidateContext(Key validatingKey, Node node)

指定したキーおよびノードを格納するDOMValidateContextを作成します。 検証キーは、getKeySelectorメソッドが呼び出されたときに返されるsingleton KeySelectorに格納されます。

パラメータ:

validatingKey - 検証キー

node - ノード

スロー:

NullPointerException - validatingKeyまたはnodeがnullの場合

メソッドの詳細

setNode

public void setNode(Node node)

ノードを設定します。

パラメータ:

node - ノード

スロー:

NullPointerException - nodeがnullである場合

関連項目:

• getNode()

getNode

public Node getNode()

ノードを返します。

戻り値:

ノード。nullにはならない

関連項目:

• setNode(Node)