Java Node.DOCUMENT_POSITION_CONTAINED_BY属性代码示例

/**
 * <p>Use a DOM node to create a new output target specifying the child node where the result nodes should be inserted before.</p>
 *
 * <p>In practice, <code>node</code> and <code>nextSibling</code> should be
 * a {@link org.w3c.dom.Document} node,
 * a {@link org.w3c.dom.DocumentFragment} node, or
 * a {@link org.w3c.dom.Element} node.
 * In other words, a node that accepts children.</p>
 *
 * <p>Use <code>nextSibling</code> to specify the child node
 * where the result nodes should be inserted before.
 * If <code>nextSibling</code> is not a sibling of <code>node</code>,
 * then an <code>IllegalArgumentException</code> is thrown.
 * If <code>node</code> is <code>null</code> and <code>nextSibling</code> is not <code>null</code>,
 * then an <code>IllegalArgumentException</code> is thrown.
 * If <code>nextSibling</code> is <code>null</code>,
 * then the behavior is the same as calling {@link #DOMResult(Node node)},
 * i.e. append the result nodes as the last child of the specified <code>node</code>.</p>
 *
 * <p><code>systemId</code> will be set to <code>null</code>.</p>
 *
 * @param node The DOM node that will contain the result tree.
 * @param nextSibling The child node where the result nodes should be inserted before.
 *
 * @throws IllegalArgumentException If <code>nextSibling</code> is not a sibling of <code>node</code> or
 *   <code>node</code> is <code>null</code> and <code>nextSibling</code>
 *   is not <code>null</code>.
 *
 * @since 1.5
 */
public DOMResult(Node node, Node nextSibling) {

    // does the corrent parent/child relationship exist?
    if (nextSibling != null) {
        // cannot be a sibling of a null node
        if (node == null) {
            throw new IllegalArgumentException("Cannot create a DOMResult when the nextSibling is contained by the \"null\" node.");
        }

        // nextSibling contained by node?
        if ((node.compareDocumentPosition(nextSibling)&Node.DOCUMENT_POSITION_CONTAINED_BY)==0) {
            throw new IllegalArgumentException("Cannot create a DOMResult when the nextSibling is not contained by the node.");
        }
    }

    setNode(node);
    setNextSibling(nextSibling);
    setSystemId(null);
}
 

/**
 * <p>Set the node that will contain the result DOM tree.<p>
 *
 * <p>In practice, the node should be
 * a {@link org.w3c.dom.Document} node,
 * a {@link org.w3c.dom.DocumentFragment} node, or
 * a {@link org.w3c.dom.Element} node.
 * In other words, a node that accepts children.</p>
 *
 * <p>An <code>IllegalStateException</code> is thrown if
 * <code>nextSibling</code> is not <code>null</code> and
 * <code>node</code> is not a parent of <code>nextSibling</code>.
 * An <code>IllegalStateException</code> is thrown if <code>node</code> is <code>null</code> and
 * <code>nextSibling</code> is not <code>null</code>.</p>
 *
 * @param node The node to which the transformation will be appended.
 *
 * @throws IllegalStateException If <code>nextSibling</code> is not
 *   <code>null</code> and
 *   <code>nextSibling</code> is not a child of <code>node</code> or
 *   <code>node</code> is <code>null</code> and
 *   <code>nextSibling</code> is not <code>null</code>.
 */
public void setNode(Node node) {
    // does the corrent parent/child relationship exist?
    if (nextSibling != null) {
        // cannot be a sibling of a null node
        if (node == null) {
            throw new IllegalStateException("Cannot create a DOMResult when the nextSibling is contained by the \"null\" node.");
        }

        // nextSibling contained by node?
        if ((node.compareDocumentPosition(nextSibling)&Node.DOCUMENT_POSITION_CONTAINED_BY)==0) {
            throw new IllegalArgumentException("Cannot create a DOMResult when the nextSibling is not contained by the node.");
        }
    }

    this.node = node;
}
 

/**
 * <p>Set the child node before which the result nodes will be inserted.</p>
 *
 * <p>Use <code>nextSibling</code> to specify the child node
 * before which the result nodes should be inserted.
 * If <code>nextSibling</code> is not a descendant of <code>node</code>,
 * then an <code>IllegalArgumentException</code> is thrown.
 * If <code>node</code> is <code>null</code> and <code>nextSibling</code> is not <code>null</code>,
 * then an <code>IllegalStateException</code> is thrown.
 * If <code>nextSibling</code> is <code>null</code>,
 * then the behavior is the same as calling {@link #DOMResult(Node node)},
 * i.e. append the result nodes as the last child of the specified <code>node</code>.</p>
 *
 * @param nextSibling The child node before which the result nodes will be inserted.
 *
 * @throws IllegalArgumentException If <code>nextSibling</code> is not a
 *   descendant of <code>node</code>.
 * @throws IllegalStateException If <code>node</code> is <code>null</code>
 *   and <code>nextSibling</code> is not <code>null</code>.
 *
 * @since 1.5
 */
public void setNextSibling(Node nextSibling) {

    // does the corrent parent/child relationship exist?
    if (nextSibling != null) {
        // cannot be a sibling of a null node
        if (node == null) {
            throw new IllegalStateException("Cannot create a DOMResult when the nextSibling is contained by the \"null\" node.");
        }

        // nextSibling contained by node?
        if ((node.compareDocumentPosition(nextSibling)&Node.DOCUMENT_POSITION_CONTAINED_BY)==0) {
            throw new IllegalArgumentException("Cannot create a DOMResult when the nextSibling is not contained by the node.");
        }
    }

    this.nextSibling = nextSibling;
}