Use a DOM node to create a new output target specifying the child node where the result nodes should be inserted before and
the specified System ID.
In practice, node
and nextSibling
should be
a Document
node,
a DocumentFragment
node, or a
Element
node.
In other words, a node that accepts children.
Use nextSibling
to specify the child node
where the result nodes should be inserted before.
If nextSibling
is not a sibling of node
,
then an IllegalArgumentException
is thrown.
If node
is null
and nextSibling
is not null
,
then an IllegalArgumentException
is thrown.
If nextSibling
is null
,
then the behavior is the same as calling DOMResult.DOMResult(Node node, String systemId)
,
i.e. append the result nodes as the last child of the specified node and use the specified System ID.
Parameters:
-
node - The DOM node that will contain the result tree.
-
nextSibling - The child node where the result nodes should be inserted before.
-
systemId - The system identifier which may be used in association with this node.
Throws:
-
IllegalArgumentException - If
nextSibling
is not a
sibling of
node
or
node
is
null
and
nextSibling
is not
null
.
Since:
1.5