- java.lang.Object
-
- javax.xml.crypto.dom.DOMCryptoContext
-
- javax.xml.crypto.dsig.dom.DOMValidateContext
-
- All Implemented Interfaces:
XMLValidateContext
,XMLCryptoContext
public class DOMValidateContext extends DOMCryptoContext implements XMLValidateContext
A DOM-specificXMLValidateContext
. This class contains additional methods to specify the location in a DOM tree where anXMLSignature
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 theXMLSignature
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 aDOMValidateContext
is used with different signature structures (for example, you should not use the sameDOMValidateContext
instance to validate two differentXMLSignature
objects).- Implementation Note:
- The JDK implementation supports a secure validation mode which can be
enabled by setting the
org.jcp.xml.dsig.secureValidation
property toBoolean.TRUE
(see thesetProperty
method). When enabled, validation of XML signatures are subject to stricter checking of algorithms and other constraints as specified by thejdk.xml.dsig.secureValidationPolicy
security property. The mode can be disabled by setting the property toBoolean.FALSE
. The mode can also be enabled or disabled by setting the org.jcp.xml.dsig.secureValidation system property to "true" or "false". Any other value for the system property is also treated as "false". If the system property is set, it supersedes theDOMValidateContext
property value. The secure validation mode is enabled by default if you are running code with a SecurityManager, otherwise it is disabled by default. - Since:
- 1.6
- See Also:
XMLSignatureFactory.unmarshalXMLSignature(XMLValidateContext)
-
-
Constructor Summary
Constructors Constructor Description DOMValidateContext(Key validatingKey, Node node)
Creates aDOMValidateContext
containing the specified key and node.DOMValidateContext(KeySelector ks, Node node)
Creates aDOMValidateContext
containing the specified key selector and node.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Node
getNode()
Returns the node.void
setNode(Node node)
Sets the node.-
Methods declared in class javax.xml.crypto.dom.DOMCryptoContext
get, getElementById, getNamespacePrefix, getProperty, iterator, put, putNamespacePrefix, setBaseURI, setIdAttributeNS, setProperty
-
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods declared in interface javax.xml.crypto.XMLCryptoContext
get, getBaseURI, getDefaultNamespacePrefix, getKeySelector, getNamespacePrefix, getProperty, getURIDereferencer, put, putNamespacePrefix, setBaseURI, setDefaultNamespacePrefix, setKeySelector, setProperty, setURIDereferencer
-
-
-
-
Constructor Detail
-
DOMValidateContext
public DOMValidateContext(KeySelector ks, Node node)
Creates aDOMValidateContext
containing the specified key selector and node.- Parameters:
ks
- a key selector for finding a validation keynode
- the node- Throws:
NullPointerException
- ifks
ornode
isnull
-
DOMValidateContext
public DOMValidateContext(Key validatingKey, Node node)
Creates aDOMValidateContext
containing the specified key and node. The validating key will be stored in asingleton KeySelector
that is returned when thegetKeySelector
method is called.- Parameters:
validatingKey
- the validating keynode
- the node- Throws:
NullPointerException
- ifvalidatingKey
ornode
isnull
-
-
Method Detail
-
setNode
public void setNode(Node node)
Sets the node.- Parameters:
node
- the node- Throws:
NullPointerException
- ifnode
isnull
- See Also:
getNode()
-
getNode
public Node getNode()
Returns the node.- Returns:
- the node (never
null
) - See Also:
setNode(Node)
-
-