APIdia Launch Partner
Top Description Fields Constructors Methods
javax.xml.crypto.dsig.dom

public Class DOMValidateContext

extends DOMCryptoContext
implements XMLValidateContext
Class Inheritance
All Implemented Interfaces
javax.xml.crypto.dsig.XMLValidateContext, javax.xml.crypto.XMLCryptoContext
Imports
javax.xml.crypto.KeySelector, javax.xml.crypto.dom.DOMCryptoContext, javax.xml.crypto.dsig.XMLSignature, .XMLSignatureFactory, .XMLValidateContext, java.security.Key, .Provider, org.w3c.dom.Node

A DOM-specific XMLValidateContext. This class contains additional methods to specify the location in a DOM tree where an XMLSignature is to be unmarshalled and validated from.

Note that the behavior of an unmarshalled XMLSignature is undefined if the contents of the underlying DOM tree are modified by the caller after the XMLSignature is created.

Also, note that DOMValidateContext instances can contain information and state specific to the XML signature structure it is used with. The results are unpredictable if a DOMValidateContext is used with different signature structures (for example, you should not use the same DOMValidateContext instance to validate two different XMLSignature objects).

Implementation Note

The JDK implementation supports the following properties that can be set using the setProperty method.

Authors
Sean Mullan, JSR 105 Expert Group
Since
1.6
See Also
XMLSignatureFactory#unmarshalXMLSignature(XMLValidateContext)

Field Summary

Modifier and TypeField and Description
private Node

Constructor Summary

AccessConstructor and Description
public
DOMValidateContext(KeySelector
a key selector for finding a validation key
ks
,
Node
the node
node
)

Creates a DOMValidateContext containing the specified key selector and node.

public
DOMValidateContext(Key
the validating key
validatingKey
,
Node
the node
node
)

Creates a DOMValidateContext containing the specified key and node.

Method Summary

Modifier and TypeMethod and Description
public Node

Returns:

the node (never null)
getNode
()

Returns the node.

private void
init(Node node, KeySelector ks)

public void
setNode(Node
the node
node
)

Sets the node.

Inherited from javax.xml.crypto.dom.DOMCryptoContext:
getgetBaseURIgetDefaultNamespacePrefixgetElementByIdgetKeySelectorgetNamespacePrefixgetPropertygetURIDereferenceriteratorputputNamespacePrefixsetBaseURIsetDefaultNamespacePrefixsetIdAttributeNSsetKeySelectorsetPropertysetURIDereferencer

Field Detail

nodeback to summary
private Node node

Constructor Detail

DOMValidateContextback to summary
public DOMValidateContext(KeySelector ks, Node node)

Creates a DOMValidateContext containing the specified key selector and node.

Parameters
ks:KeySelector

a key selector for finding a validation key

node:Node

the node

Exceptions
NullPointerException:
if ks or node is null
DOMValidateContextback to summary
public DOMValidateContext(Key validatingKey, Node node)

Creates a DOMValidateContext containing the specified key and node. The validating key will be stored in a singleton KeySelector that is returned when the getKeySelector method is called.

Parameters
validatingKey:Key

the validating key

node:Node

the node

Exceptions
NullPointerException:
if validatingKey or node is null

Method Detail

getNodeback to summary
public Node getNode()

Returns the node.

Returns:Node

the node (never null)

See Also
setNode(Node)
initback to summary
private void init(Node node, KeySelector ks)
setNodeback to summary
public void setNode(Node node)

Sets the node.

Parameters
node:Node

the node

Exceptions
NullPointerException:
if node is null
See Also
getNode