com.novell.afw.util
Class EboXmlUtil

java.lang.Object
 |
 +--com.novell.afw.util.EboXmlUtil

public final class EboXmlUtil

extends Object

Utilities for dealing with XML

Since:

v.5.0

Constructor Summary

EboXmlUtil()

Method Summary

static void	addDirectiveToXSL(org.w3c.dom.Document xslDom, String directiveName, String attributeName, String attributeValue) Add an xsl:import or xsl:include etc.
static org.w3c.dom.Node	addNodeAfterSibling(org.w3c.dom.Node siblingNode, String nodeName, org.w3c.dom.Node content) create a new Element with nodeName and insert it after the siblingNode (same level); if the node name is null, insert the content node after the sibling node; both Nodes need to be part of the same document
static org.w3c.dom.Node	addNodeAfterSibling(org.w3c.dom.Node siblingNode, String nodeName, org.w3c.dom.Node content, boolean contentIsLocal) create a new Element with nodeName and insert it after the siblingNode (same level); if the node name is null, insert the content node after the sibling node
static org.w3c.dom.Node	addNodeBeforeSibling(org.w3c.dom.Node siblingNode, String nodeName, org.w3c.dom.Node content) create a new Element with nodeName and insert it before the siblingNode (same level)
static org.w3c.dom.Node	addNodeBeforeSibling(org.w3c.dom.Node siblingNode, String nodeName, org.w3c.dom.Node content, boolean contentIsLocal) create a new Element with nodeName and insert it before the siblingNode (same level); if the node name is null, insert the content node before the sibling node
static org.w3c.dom.Node	appendChildNode(org.w3c.dom.Node parentNode, org.w3c.dom.Node contentNode) import a node into the current document directly under the passed parent Node
static org.w3c.dom.Node	appendChildNode(org.w3c.dom.Node parentNode, org.w3c.dom.Node contentNode, boolean contentIsLocal) import a node into the current document directly under the passed parent Node
static org.w3c.dom.Attr	createAttribute(org.w3c.dom.Document doc, String attributeName, String attributeValue) create an attribute standalone (not added to any node)
static org.w3c.dom.Attr	createAttribute(org.w3c.dom.Element el, String attributeName, String attributeValue) create an attribute and add it to the Node provided
static org.w3c.dom.Node	createCDATANode(org.w3c.dom.Node parentNode, String nodeName, String content) create a CDATA section as a child to the provided parentNode
static org.w3c.dom.Node	createChildNode(org.w3c.dom.Node parentNode, String nodeName) Create a child node and append it to the provided parent node
static org.w3c.dom.Node	createChildNode(org.w3c.dom.Node parentNode, String nodeName, org.w3c.dom.Node contentNode) create a child node (to parentNode) and populate it with the delivered content (if != null)
static org.w3c.dom.Node	createChildNode(org.w3c.dom.Node parentNode, String nodeName, org.w3c.dom.Node contentNode, boolean contentIsLocal) create a child node (to parentNode) and populate it with the delivered content (if != null)
static org.w3c.dom.Document	createDocument() create a new org.w3c.dom.Document with validation turned off and name space awareness turned on
static org.w3c.dom.Document	createDocument(org.xml.sax.InputSource inputSrc, boolean isValidating, boolean isNamespaceAware, org.xml.sax.ErrorHandler errorHandler, org.xml.sax.EntityResolver entityResolver) Creates a new Document from an InputSource allowing the validation, namespace, error handler and entity resolver to be set.
static org.w3c.dom.Document	createDocument(InputStream stream) create a Document from a String representation (reading the stream with UTF-8, with name space awareness on and validation off)
static org.w3c.dom.Document	createDocument(InputStream stream, String encoding, boolean validation, boolean namespace) create a Document from a stream representation of the XML content use the requested char-set encoding, validation and name space awareness
static org.w3c.dom.Document	createDocument(Reader reader, boolean validation, boolean namespace) create a Document from a reader representation of the XML content use the requested validation and name space awareness
static org.w3c.dom.Document	createDocument(String strDoc) Creates a Document from a String representing a valid XML document (no validation, but name space aware)
static org.w3c.dom.Document	createDocument(URL documentURL) create a Document from a URL (get the content from the URL); name space aware, but no validation
static org.w3c.dom.Node	createDocumentRootNode(org.w3c.dom.Document parentDocument, String nodeName, org.w3c.dom.Node contentNode) create a child node (to parentDocument) and populate it with the delivered content (if != null)
static org.w3c.dom.Node	createDocumentRootNode(org.w3c.dom.Document parentDocument, String nodeName, org.w3c.dom.Node contentNode, boolean contentIsLocal) create a child node (to parentDocument) and populate it with the delivered content (if != null)
static org.w3c.dom.Node	createNode(org.w3c.dom.Document document, String nodeName, org.w3c.dom.Node contentNode) create a Node standalone (not added to any parent)
static org.w3c.dom.Node	createNode(org.w3c.dom.Document document, String nodeName, org.w3c.dom.Node contentNode, boolean contentIsLocal) create a Node standalone (not added to any parent)
static org.w3c.dom.Node	createTextNode(org.w3c.dom.Document doc, org.w3c.dom.Node parentNode, String nodeName, String content) create a text node
static org.w3c.dom.Node	createTextNode(org.w3c.dom.Node parentNode, String nodeName, String content) create a text node
static org.w3c.dom.Attr	getAttribute(String attributeName, org.w3c.dom.Node node) get an attribute of a node (if present)
static String	getAttributeValue(String attributeName, org.w3c.dom.Node node) get the value of an attribute of a node (if present)
static javax.xml.parsers.DocumentBuilder	getBuilder() get a javax.xml.parsers.DocumentBuilder from the javax.xml.parsers.DocumentBuilderFactory validation turned off and name space awareness turned on if you need a DocumentBuilder with different features, use the getBuilder(boolean validation, boolean nameSpaceAware) method (this method will cache the DocumentBuilder after the fist hit
static javax.xml.parsers.DocumentBuilder	getBuilder(boolean validation, boolean nameSpaceAware) get a javax.xml.parsers.DocumentBuilder from the javax.xml.parsers.DocumentBuilderFactory
static javax.xml.transform.Templates	getTemplates(javax.xml.transform.Source source) compile the provided style sheet into templates
static javax.xml.transform.Transformer	getTransformer() get a new Transformer from the TransformerFactory with indent turned on
static javax.xml.transform.Transformer	getTransformer(org.w3c.dom.Document doc) get a new Transformer for the passed Document (the xsl) from the TransformerFactory with indent turned on
static javax.xml.transform.Transformer	getTransformer(Properties transProps) get a new Transformer from the TransformerFactory with the passed output properties
static javax.xml.transform.Transformer	getTransformer(javax.xml.transform.Source strSource) get a new Transformer for the passed Source (the xsl) from the TransformerFactory with indent turned on
static javax.xml.transform.Transformer	getTransformer(javax.xml.transform.Templates templates) get a new Transformer for the passed compiled xsl template (with indent turned on)
static String	serialize(org.w3c.dom.Node doc) serialize a Document to String (using a Transformer)
static void	serialize(org.w3c.dom.Node doc, OutputStream output) serialize a Document to the provided OutputStream (using a Transformer)
static void	serialize(org.w3c.dom.Node doc, OutputStream output, javax.xml.transform.Transformer transformer) serialize a Document to the provided OutputStream (using the passed Transformer)
static String	serialize(org.w3c.dom.Node doc, javax.xml.transform.Transformer transformer) serialize a Document to String (using the passed Transformer)
static void	serialize(org.w3c.dom.Node doc, Writer writer) serialize a Document to the provided Writer (using a Transformer)
static void	serialize(org.w3c.dom.Node doc, Writer writer, javax.xml.transform.Transformer transformer) serialize a Document to the provided Writer (using a Transformer)
static void	xslTransform(org.w3c.dom.Document contentDom, org.w3c.dom.Document styleDom, Writer out) Transforms an xml with the provided xsl document and writes it to the writer.
static void	xslTransform(org.w3c.dom.Document contentDom, javax.xml.transform.Transformer transformer, OutputStream out) Transforms an xml document with the provided xsl style (compiled version) and write it to the provided writer

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EboXmlUtil

public EboXmlUtil()

Method Detail

getBuilder

public static javax.xml.parsers.DocumentBuilder getBuilder()
                                                    throws javax.xml.parsers.ParserConfigurationException

get a javax.xml.parsers.DocumentBuilder from the javax.xml.parsers.DocumentBuilderFactory validation turned off and name space awareness turned on if you need a DocumentBuilder with different features, use the getBuilder(boolean validation, boolean nameSpaceAware) method (this method will cache the DocumentBuilder after the fist hit

Returns:

javax.xml.parsers.DocumentBuilder

Throws:

javax.xml.parsers.ParserConfigurationException -

Since:

v.5.0

getBuilder

public static javax.xml.parsers.DocumentBuilder getBuilder(boolean validation,
                                                           boolean nameSpaceAware)
                                                    throws javax.xml.parsers.ParserConfigurationException

get a javax.xml.parsers.DocumentBuilder from the javax.xml.parsers.DocumentBuilderFactory

Parameters:

validation - true if validation should be turned on, otherwise use false

nameSpaceAware - true if name space awareness should be turned on, otherwise use false

Returns:

a DocumentBuilder to create Documents

Throws:

javax.xml.parsers.ParserConfigurationException - if the underlying parser does

Since:

v.5.0

createDocument

public static org.w3c.dom.Document createDocument()
                                           throws javax.xml.parsers.ParserConfigurationException

create a new org.w3c.dom.Document with validation turned off and name space awareness turned on

Returns:

the created org.w3c.dom.Document

Throws:

javax.xml.parsers.ParserConfigurationException - if the underlying parser does

Since:

v.5.0

createDocument

public static org.w3c.dom.Document createDocument(String strDoc)
                                           throws org.w3c.dom.DOMException,
                                                  IOException,
                                                  org.xml.sax.SAXException,
                                                  javax.xml.parsers.ParserConfigurationException

Creates a Document from a String representing a valid XML document (no validation, but name space aware)

Parameters:

strDoc - the string representing the xml

Returns:

the created Document

Throws:

org.w3c.dom.DOMException - if the provided string does not represent a valid xml document

IOException -

org.xml.sax.SAXException -

javax.xml.parsers.ParserConfigurationException - if the underlying parser does

IllegalArgumentException - if the passed string is null

Since:

v.5.0

createDocument

public static org.w3c.dom.Document createDocument(InputStream stream)
                                           throws org.w3c.dom.DOMException,
                                                  IOException,
                                                  org.xml.sax.SAXException,
                                                  javax.xml.parsers.ParserConfigurationException

create a Document from a String representation (reading the stream with UTF-8, with name space awareness on and validation off)

Parameters:

stream - the InputStream that represents the XML Content

Returns:

a Document representing the same content

Throws:

org.w3c.dom.DOMException - if the InputSource does not represent a valid XML document

IOException -

org.xml.sax.SAXException -

javax.xml.parsers.ParserConfigurationException - if the underlying parser does

IllegalArgumentException - if the provided InputSource is null

Since:

v.5.0

createDocument

public static org.w3c.dom.Document createDocument(InputStream stream,
                                                  String encoding,
                                                  boolean validation,
                                                  boolean namespace)
                                           throws org.w3c.dom.DOMException,
                                                  IOException,
                                                  org.xml.sax.SAXException,
                                                  javax.xml.parsers.ParserConfigurationException

create a Document from a stream representation of the XML content use the requested char-set encoding, validation and name space awareness

Parameters:

stream - the stream (InputStream,...) to represent the XML

encoding - the Char encoding that should be used to read from the stream

namespace - use namespace awareness (true) , or not (false)

validation - use validation (true), or not (false)

Returns:

a Document representing the same XML content in form of a DOM

Throws:

org.w3c.dom.DOMException -

IOException -

org.xml.sax.SAXException -

javax.xml.parsers.ParserConfigurationException - if the underlying parser does

IllegalArgumentException - if the provided InputSource or encoding is null

Since:

v.5.0

createDocument

public static org.w3c.dom.Document createDocument(Reader reader,
                                                  boolean validation,
                                                  boolean namespace)
                                           throws org.w3c.dom.DOMException,
                                                  IOException,
                                                  org.xml.sax.SAXException,
                                                  javax.xml.parsers.ParserConfigurationException

create a Document from a reader representation of the XML content use the requested validation and name space awareness

Parameters:

reader - the reader pointing to the 'raw' xml

namespace - use namespace awareness (true) , or not (false)

validation - use validation (true), or not (false)

Returns:

a Document representing the same XML content in form of a DOM

Throws:

org.w3c.dom.DOMException -

IOException - if the reader doesn't allow successfull access

org.xml.sax.SAXException -

javax.xml.parsers.ParserConfigurationException - if the underlying parser does

Since:

v.5.0

createDocument

public static org.w3c.dom.Document createDocument(URL documentURL)
                                           throws IOException,
                                                  org.xml.sax.SAXException,
                                                  javax.xml.parsers.ParserConfigurationException

create a Document from a URL (get the content from the URL); name space aware, but no validation

Parameters:

documentURL - the URL pointing to the Document

Returns:

a Document representing the document content

Throws:

IOException -

org.xml.sax.SAXException -

javax.xml.parsers.ParserConfigurationException - if the underlying parser does

IllegalArgumentException - if the provided URL is null

Since:

v.5.0

createDocument

public static org.w3c.dom.Document createDocument(org.xml.sax.InputSource inputSrc,
                                                  boolean isValidating,
                                                  boolean isNamespaceAware,
                                                  org.xml.sax.ErrorHandler errorHandler,
                                                  org.xml.sax.EntityResolver entityResolver)
                                           throws org.w3c.dom.DOMException,
                                                  IOException,
                                                  org.xml.sax.SAXException,
                                                  javax.xml.parsers.ParserConfigurationException

Creates a new Document from an InputSource allowing the validation, namespace, error handler and entity resolver to be set.

Parameters:

inputSrc - the InputSource representing the xml

isValidating - the boolean determining if validating is used against the xml

isNamespaceAware - the boolean determining if the NameSpaceAware feature is set

errorHandler - the ErrorHandler to be used if supplied

entityResolver - the entityResolver to be used if supplied

Returns:

a Document

Throws:

org.w3c.dom.DOMException -

IOException -

org.xml.sax.SAXException -

javax.xml.parsers.ParserConfigurationException - if the underlying parser does

IllegalArgumentException - if the provided InputSource is null

Since:

v.5.0

createDocumentRootNode

public static org.w3c.dom.Node createDocumentRootNode(org.w3c.dom.Document parentDocument,
                                                      String nodeName,
                                                      org.w3c.dom.Node contentNode)

create a child node (to parentDocument) and populate it with the delivered content (if != null)

Parameters:

parentDocument - the Document that will receive the new Element and the content

nodeName - the name of the Element to create

contentNode - the Node that will be appended as a child to the created Element

Returns:

the created Node

Throws:

IllegalArgumentException - if the document or the node name is null

Since:

v.5.0

createDocumentRootNode

public static org.w3c.dom.Node createDocumentRootNode(org.w3c.dom.Document parentDocument,
                                                      String nodeName,
                                                      org.w3c.dom.Node contentNode,
                                                      boolean contentIsLocal)

create a child node (to parentDocument) and populate it with the delivered content (if != null)

Parameters:

parentDocument - the Document that will receive the new Element and the content

nodeName - the name of the Element to create

contentNode - the Node that will be imported (if external) or appended (if local) as a child to the created Element (incl. subtree)

contentIsLocal - a boolean indicating wether the contentNode is external to the document and has to be imported (false), or if it can be appended (true)

Returns:

the created Element

Throws:

IllegalArgumentException - if the document or the node name is null

Since:

v.5.0

createNode

public static org.w3c.dom.Node createNode(org.w3c.dom.Document document,
                                          String nodeName,
                                          org.w3c.dom.Node contentNode)

create a Node standalone (not added to any parent)

Parameters:

document - Document used to create the Element (not null!)

nodeName - name of the node to be created (not null!)

contentNode - content in form of a Node to be appended as child (if not null) ; including the subtree

Returns:

the newly created Node

Throws:

IllegalArgumentException - if the document or the node name is null

Since:

v.5.0

createNode

public static org.w3c.dom.Node createNode(org.w3c.dom.Document document,
                                          String nodeName,
                                          org.w3c.dom.Node contentNode,
                                          boolean contentIsLocal)

create a Node standalone (not added to any parent)

Parameters:

document - Document used to create the Element (not null!)

nodeName - name of the node to be created (not null!)

contentNode - content in form of a Node to be imported or appended as child (if not null)

contentIsLocal - a boolean indicating wether the contentNode is external to the document and has to be imported (false), or if it can be appended (true)

Returns:

the newly created Node

Throws:

IllegalArgumentException - if the document or the node name is null

Since:

v.5.0

createChildNode

public static org.w3c.dom.Node createChildNode(org.w3c.dom.Node parentNode,
                                               String nodeName,
                                               org.w3c.dom.Node contentNode)

create a child node (to parentNode) and populate it with the delivered content (if != null)

Parameters:

parentNode - the parent Node (not null!)

nodeName - the name for the new Element (not null!)

contentNode - org.w3c.dom.Node that contains the content to be appended (incl. subtree) to the parent Document (or null)

Returns:

the newly created Node

Throws:

IllegalArgumentException - if the parent node or the node name is null

Since:

v.5.0

createChildNode

public static org.w3c.dom.Node createChildNode(org.w3c.dom.Node parentNode,
                                               String nodeName,
                                               org.w3c.dom.Node contentNode,
                                               boolean contentIsLocal)

create a child node (to parentNode) and populate it with the delivered content (if != null)

Parameters:

parentNode - the parent Node (not null!)

nodeName - the name for the new Element (not null!)

contentNode - org.w3c.dom.Node that contains the content to be imported (incl. subtree) or appended (if local) to the parent Document (or null)

contentIsLocal - a boolean indicating wether the contentNode is external to the document and has to be imported (false), or if it can be appended (true)

Returns:

the newly created Node

Throws:

IllegalArgumentException - if the parent node or the node name is null

Since:

v.5.0

createChildNode

public static org.w3c.dom.Node createChildNode(org.w3c.dom.Node parentNode,
                                               String nodeName)

Create a child node and append it to the provided parent node

Parameters:

nodeName - the name for the new node

parentNode - the parent org.w3c.dom.Node that will receive the child

Returns:

the newly created Node

Throws:

IllegalArgumentException - if the parent node or the node name is null

Since:

v.5.0

createTextNode

public static org.w3c.dom.Node createTextNode(org.w3c.dom.Document doc,
                                              org.w3c.dom.Node parentNode,
                                              String nodeName,
                                              String content)

create a text node

Parameters:

doc - the Document to contain the new text node (not null!)

parentNode - the Node under which the new text node should be placed (or null)

nodeName - the name of the new text node (not null!)

content - the text itself

Returns:

the newly created Node

Throws:

IllegalArgumentException - if either the document, or the node name and the parent node are null

Since:

v.5.0

createTextNode

public static org.w3c.dom.Node createTextNode(org.w3c.dom.Node parentNode,
                                              String nodeName,
                                              String content)

create a text node

Parameters:

parentNode - the Node under which the new text node should be placed (not null!)

nodeName - the name of the new text node (not null!)

content - the text itself

Returns:

the newly created Node

Throws:

IllegalArgumentException - if the parent node is null

Since:

v.5.0

createAttribute

public static org.w3c.dom.Attr createAttribute(org.w3c.dom.Element el,
                                               String attributeName,
                                               String attributeValue)

create an attribute and add it to the Node provided

Parameters:

el - the element that will receive the attribute (not null!)

attributeName - name of the attribute to be created (not null!)

attributeValue - value of the attribute to be created

Returns:

the created attribute as Attr

Throws:

IllegalArgumentException - if the element or the attribute name is null

Since:

v.5.0

createAttribute

public static org.w3c.dom.Attr createAttribute(org.w3c.dom.Document doc,
                                               String attributeName,
                                               String attributeValue)

create an attribute standalone (not added to any node)

Parameters:

doc - the Document used to create the attribute

attributeName - name of the attribute to be created

attributeValue - value of the attribute to be created

Returns:

the Attribute as org.w3c.dom.Attr

Throws:

IllegalArgumentException - if the document or the attribute name is null

Since:

v.5.0

getAttributeValue

public static String getAttributeValue(String attributeName,
                                       org.w3c.dom.Node node)

get the value of an attribute of a node (if present)

Parameters:

attributeName - the name of the attribute you want to get

node - the Node where the attribute lives

Returns:

the value of the attribute, or null if not present

Throws:

IllegalArgumentException - if the attribute name or the node is null

Since:

v.5.0

getAttribute

public static org.w3c.dom.Attr getAttribute(String attributeName,
                                            org.w3c.dom.Node node)

get an attribute of a node (if present)

Parameters:

attributeName - the name of the attribute you want to get

node - the Node where the attribute lives

Returns:

the attribute, or null if not present on the node

Throws:

IllegalArgumentException - if the attribute name or the node is null

Since:

v.5.0

createCDATANode

public static org.w3c.dom.Node createCDATANode(org.w3c.dom.Node parentNode,
                                               String nodeName,
                                               String content)

create a CDATA section as a child to the provided parentNode

Parameters:

parentNode - Node (parent) of the element to be created (not null!)

nodeName - the name you want to give your Node (or null if the textnode should be appended to the parent node directly)

content - the content of the node (the text)

Returns:

the org.w3c.dom.Node that was created

Throws:

IllegalArgumentException - if the parent node or the content is null

Since:

v.5.0

addNodeBeforeSibling

public static org.w3c.dom.Node addNodeBeforeSibling(org.w3c.dom.Node siblingNode,
                                                    String nodeName,
                                                    org.w3c.dom.Node content)

create a new Element with nodeName and insert it before the siblingNode (same level)

Parameters:

siblingNode - the node that will be used as reference; the new element will be inserted before this node

nodeName - the name of the element to create

content - any subtree that will be appended as child of the new element (if != null)

Returns:

the newly created element as a Node

Throws:

IllegalArgumentException - if the sibling node or the node name is null

Since:

v.5.0

addNodeBeforeSibling

public static org.w3c.dom.Node addNodeBeforeSibling(org.w3c.dom.Node siblingNode,
                                                    String nodeName,
                                                    org.w3c.dom.Node content,
                                                    boolean contentIsLocal)

create a new Element with nodeName and insert it before the siblingNode (same level); if the node name is null, insert the content node before the sibling node

Parameters:

siblingNode - the node that will be used as reference; the new element will be inserted before this node

nodeName - the name of the element to create (or null; if null, content needs to be not null!)

content - any subtree that will be imported or appended (if local) as child of the new element (if != null)

contentIsLocal - a boolean indicating wether the contentNode is external to the document and has to be imported (false), or if it can be appended (true)

Returns:

the newly created element as a Node

Throws:

IllegalArgumentException - if the sibling node is null or the node name and the content is null

Since:

v.5.0

addNodeAfterSibling

public static org.w3c.dom.Node addNodeAfterSibling(org.w3c.dom.Node siblingNode,
                                                   String nodeName,
                                                   org.w3c.dom.Node content)

create a new Element with nodeName and insert it after the siblingNode (same level); if the node name is null, insert the content node after the sibling node; both Nodes need to be part of the same document

Parameters:

siblingNode - the node that will be used as reference; the new element will be inserted after this node

nodeName - the name of the element to create (or null; if null, content needs to be not null!)

content - any subtree that will be imported or appended (if local) as child of the new element (if != null)

Returns:

the newly created element as a Node

Throws:

IllegalArgumentException - if the sibling node is null or the node name and the content is null

Since:

v.5.0

addNodeAfterSibling

public static org.w3c.dom.Node addNodeAfterSibling(org.w3c.dom.Node siblingNode,
                                                   String nodeName,
                                                   org.w3c.dom.Node content,
                                                   boolean contentIsLocal)

create a new Element with nodeName and insert it after the siblingNode (same level); if the node name is null, insert the content node after the sibling node

Parameters:

siblingNode - the node that will be used as reference; the new element will be inserted after this node

nodeName - the name of the element to create (or null; if null, content needs to be not null!)

content - any subtree that will be imported or appended (if local) as child of the new element (if != null)

contentIsLocal - a boolean indicating wether the contentNode is external to the document and has to be imported (false), or if it can be appended (true)

Returns:

the newly created element as a Node

Throws:

IllegalArgumentException - if the sibling node is null or the node name and the content is null

Since:

v.5.0

appendChildNode

public static org.w3c.dom.Node appendChildNode(org.w3c.dom.Node parentNode,
                                               org.w3c.dom.Node contentNode)

import a node into the current document directly under the passed parent Node

Parameters:

parentNode - the Node under which the content should be placed (not null!)

contentNode - the Node (not null!) that will be imported as a child to the created Node (incl. subtree)

Returns:

the Node representing the imported content in the current dom

Throws:

IllegalArgumentException - if the parent node or the content node is null

Since:

v.5.0

appendChildNode

public static org.w3c.dom.Node appendChildNode(org.w3c.dom.Node parentNode,
                                               org.w3c.dom.Node contentNode,
                                               boolean contentIsLocal)

import a node into the current document directly under the passed parent Node

Parameters:

parentNode - the Node under which the content should be placed (not null!)

contentNode - the Node (not null!) that will be imported as a child to the created Node (incl. subtree)

contentIsLocal - a boolean indicating wether the contentNode is external to the document and has to be imported (false), or if it can be appended (true)

Returns:

the Node representing the imported content in the current dom (or the passed in contentNode if it's local)

Throws:

IllegalArgumentException - if the parent node or the content node is null

Since:

v.5.0

serialize

public static void serialize(org.w3c.dom.Node doc,
                             OutputStream output)
                      throws IOException,
                             javax.xml.transform.TransformerConfigurationException,
                             javax.xml.transform.TransformerException

serialize a Document to the provided OutputStream (using a Transformer)

Parameters:

doc - Document (-fragment) to be serialized

output - the OutputStream to write to

Throws:

IOException -

javax.xml.transform.TransformerConfigurationException -

javax.xml.transform.TransformerException -

IllegalArgumentException - if the output stream or the document is null

Since:

v.5.0

serialize

public static void serialize(org.w3c.dom.Node doc,
                             OutputStream output,
                             javax.xml.transform.Transformer transformer)
                      throws IOException,
                             javax.xml.transform.TransformerConfigurationException,
                             javax.xml.transform.TransformerException

serialize a Document to the provided OutputStream (using the passed Transformer)

Parameters:

doc - Document (-fragment) to be serialized

output - the OutputStream to write to

transformer - the transformer to use

Throws:

IOException -

javax.xml.transform.TransformerConfigurationException -

javax.xml.transform.TransformerException -

IllegalArgumentException - if the output stream or the document or the transformer is null

Since:

v.5.0

serialize

public static void serialize(org.w3c.dom.Node doc,
                             Writer writer)
                      throws IOException,
                             javax.xml.transform.TransformerConfigurationException,
                             javax.xml.transform.TransformerException

serialize a Document to the provided Writer (using a Transformer)

Parameters:

doc - Document (-fragment) to be serialized

writer - the writer to write to

Throws:

IOException -

javax.xml.transform.TransformerConfigurationException -

javax.xml.transform.TransformerException -

IllegalArgumentException - if the document or the writer is null

Since:

v.5.0

serialize

public static void serialize(org.w3c.dom.Node doc,
                             Writer writer,
                             javax.xml.transform.Transformer transformer)
                      throws IOException,
                             javax.xml.transform.TransformerConfigurationException,
                             javax.xml.transform.TransformerException

serialize a Document to the provided Writer (using a Transformer)

Parameters:

doc - Document (-fragment) to be serialized

writer - the writer to write to

transformer - the transformer to use

Throws:

IOException -

javax.xml.transform.TransformerConfigurationException -

javax.xml.transform.TransformerException -

IllegalArgumentException - if the document or the writer or the transformer is null

Since:

v.5.0

serialize

public static String serialize(org.w3c.dom.Node doc)
                        throws IOException,
                               javax.xml.transform.TransformerConfigurationException,
                               javax.xml.transform.TransformerException

serialize a Document to String (using a Transformer)

Parameters:

doc - Document (-fragment) to be serialized

Returns:

the String representation of the Document

Throws:

IOException -

javax.xml.transform.TransformerConfigurationException -

javax.xml.transform.TransformerException -

IllegalArgumentException - if the document is null

Since:

v.5.0

serialize

public static String serialize(org.w3c.dom.Node doc,
                               javax.xml.transform.Transformer transformer)
                        throws IOException,
                               javax.xml.transform.TransformerConfigurationException,
                               javax.xml.transform.TransformerException

serialize a Document to String (using the passed Transformer)

Parameters:

doc - Document (-fragment) to be serialized

transformer - the transformer to use

Returns:

the String representation of the Document

Throws:

IOException -

javax.xml.transform.TransformerConfigurationException -

javax.xml.transform.TransformerException -

IllegalArgumentException - if the document or the transformer is null

Since:

v.5.0

addDirectiveToXSL

public static void addDirectiveToXSL(org.w3c.dom.Document xslDom,
                                     String directiveName,
                                     String attributeName,
                                     String attributeValue)
                              throws javax.xml.transform.TransformerException

Add an xsl:import or xsl:include etc. node to an existing xsl style sheet (represented as DOM)

Parameters:

xslDom - the DOM representation of the XSL style sheet

directiveName - the tag name (like xsl:import)

attributeName - the

attributeValue -

Throws:

javax.xml.transform.TransformerException -

IllegalArgumentException - if the document or the directive name is null, or if the document is not an xsl style sheet

Since:

v.5.0

xslTransform

public static void xslTransform(org.w3c.dom.Document contentDom,
                                org.w3c.dom.Document styleDom,
                                Writer out)
                         throws javax.xml.transform.TransformerException,
                                javax.xml.transform.TransformerConfigurationException,
                                FileNotFoundException,
                                IOException

Transforms an xml with the provided xsl document and writes it to the writer.

Parameters:

contentDom - the document to be transformed

styleDom - the style to apply to the content

out - the writer to write the result to

Throws:

javax.xml.transform.TransformerException -

javax.xml.transform.TransformerConfigurationException -

FileNotFoundException -

IOException -

IllegalArgumentException - if any of the arguments is null

Since:

v.5.0

xslTransform

public static void xslTransform(org.w3c.dom.Document contentDom,
                                javax.xml.transform.Transformer transformer,
                                OutputStream out)
                         throws javax.xml.transform.TransformerException,
                                javax.xml.transform.TransformerConfigurationException,
                                FileNotFoundException,
                                IOException

Transforms an xml document with the provided xsl style (compiled version) and write it to the provided writer

Parameters:

contentDom - the document to be transformed

transformer - the compiled xsl style sheet that will be applied to the content document

out - the OutputStream to write the result to

Throws:

javax.xml.transform.TransformerException -

javax.xml.transform.TransformerConfigurationException -

FileNotFoundException -

IOException -

IllegalArgumentException - if any of the arguments is null

Since:

v.5.0

getTransformer

public static javax.xml.transform.Transformer getTransformer()
                                                      throws javax.xml.transform.TransformerConfigurationException

get a new Transformer from the TransformerFactory with indent turned on

Returns:

the new Transformer

Throws:

javax.xml.transform.TransformerConfigurationException - if the underlying parser does

Since:

v.5.0

getTransformer

public static javax.xml.transform.Transformer getTransformer(Properties transProps)
                                                      throws javax.xml.transform.TransformerConfigurationException

get a new Transformer from the TransformerFactory with the passed output properties

Parameters:

transProps - a Porperties file containing the desired Output properties

Returns:

the new Transformer

Throws:

javax.xml.transform.TransformerConfigurationException - if the underlying parser does

Since:

v.5.0

getTransformer

public static javax.xml.transform.Transformer getTransformer(javax.xml.transform.Source strSource)
                                                      throws javax.xml.transform.TransformerConfigurationException

get a new Transformer for the passed Source (the xsl) from the TransformerFactory with indent turned on

Parameters:

strSource - a Source (StreamSource, DOMSource, SAXSource) representing the style we need the Transformer for

Returns:

the new Transformer

Throws:

javax.xml.transform.TransformerConfigurationException - if the underlying parser does

Since:

v.5.0

getTransformer

public static javax.xml.transform.Transformer getTransformer(javax.xml.transform.Templates templates)
                                                      throws javax.xml.transform.TransformerConfigurationException

get a new Transformer for the passed compiled xsl template (with indent turned on)

Parameters:

templates - the pre compile xsl style sheet

Returns:

the new Transformer

Throws:

javax.xml.transform.TransformerConfigurationException - if the underlying parser does

Since:

v.5.0

getTransformer

public static javax.xml.transform.Transformer getTransformer(org.w3c.dom.Document doc)
                                                      throws javax.xml.transform.TransformerException,
                                                             IOException

get a new Transformer for the passed Document (the xsl) from the TransformerFactory with indent turned on

Parameters:

doc - a document representing the style we need the Transformer for

Returns:

the new Transformer (compiled xsl style sheet)

Throws:

javax.xml.transform.TransformerException - if the underlying parser does

IOException - if converting the document to a stream source fails

Since:

v.5.0

getTemplates

public static javax.xml.transform.Templates getTemplates(javax.xml.transform.Source source)
                                                  throws javax.xml.transform.TransformerConfigurationException

compile the provided style sheet into templates

Parameters:

source - a StreamSource, DOMSource, ... that contains the xsl style sheet to compile

Returns:

the compiled style sheet (where you can get the Transformer from)

Throws:

javax.xml.transform.TransformerConfigurationException - if the underlying parser does

Since:

v.5.0