/*
* Copyright 2006 Sun Microsystems, Inc. All rights reserved.
*/
/*
* $Id: DOMStructure.java,v 1.6 2005/05/09 18:33:26 mullan Exp $
*/
package javax.xml.crypto.dom;
import org.w3c.dom.Node;
import javax.xml.crypto.XMLStructure;
import javax.xml.crypto.dsig.XMLSignature;
/**
* A DOM-specific {@link XMLStructure}. The purpose of this class is to
* allow a DOM node to be used to represent extensible content (any elements
* or mixed content) in XML Signature structures.
*
* <p>If a sequence of nodes is needed, the node contained in the
* <code>DOMStructure</code> is the first node of the sequence and successive
* nodes can be accessed by invoking {@link Node#getNextSibling}.
*
* <p>If the owner document of the <code>DOMStructure</code> is different than
* the target document of an <code>XMLSignature</code>, the
* {@link XMLSignature#sign(XMLSignContext)} method imports the node into the
* target document before generating the signature.
*
* @author Sean Mullan
* @author JSR 105 Expert Group
* @since 1.6
*/
public class DOMStructure implements XMLStructure {
private final Node node;
/**
* Creates a <code>DOMStructure</code> containing the specified node.
*
* @param node the node
* @throws NullPointerException if <code>node</code> is <code>null</code>
*/
public DOMStructure(Node node) {
if (node == null) {
throw new NullPointerException("node cannot be null");
}
this.node = node;
}
/**
* Returns the node contained in this <code>DOMStructure</code>.
*
* @return the node
*/
public Node getNode() {
return node;
}
/**
* @throws NullPointerException {@inheritDoc}
*/
public boolean isFeatureSupported(String feature) {
if (feature == null) {
throw new NullPointerException();
} else {
return false;
}
}
}