org.xmlcml.xml

Class XMLUtil

java.lang.Object

org.xmlcml.xml.XMLUtil

All Implemented Interfaces:

EuclidConstants, XMLConstants

public abstract class XMLUtil
extends Object
implements XMLConstants

static utilities to help manage common constructs.

Version:

5.0

Author:

Peter Murray-Rust

Field Summary

Fields

Modifier and Type	Field and Description
static String	DTD

Fields inherited from interface org.xmlcml.xml.XMLConstants

ATTRIBUTES, AUTOGENERATED_DONOTEDIT_S, BANNER_S, CATALOG_XML, CML_SIUNITS, CML_UNITS, ELEMENTS, FPX_REAL, JAVA_ARRAY, JAVA_BOOL, JAVA_BOOLEAN, JAVA_DOUB, JAVA_DOUBLE, JAVA_INT, JAVA_INTEGER, JAVA_STRING, PATTERN_ANYURI, PATTERN_QNAME, SVG_NS, SVG_NS_BASE, SVG_XPATH, TYPES, U_ANGSTROM, U_CELSIUS, U_DEGREE, U_KCAL, WARNING_S, X_OR, XHTML_NS, XLINK_NS, XLINK_PREFIX, XML_SUFF, XMLNS, XPATH_XSD, XSD_ANNOTATION, XSD_ANYURI, XSD_ATTRIBUTE, XSD_ATTRIBUTE_GROUP, XSD_BOOLEAN, XSD_COMPLEX_TYPE, XSD_DATE, XSD_DOCUMENTATION, XSD_DOUBLE, XSD_ELEMENT, XSD_ENUMERATION, XSD_EXTENSION, XSD_FLOAT, XSD_INTEGER, XSD_LENGTH, XSD_LIST, XSD_MAXEXCLUSIVE, XSD_MAXINCLUSIVE, XSD_MINEXCLUSIVE, XSD_MININCLUSIVE, XSD_NONNEGATIVEINTEGER, XSD_NS, XSD_PATTERN, XSD_POSITIVE_NUMBER, XSD_POSITIVEINTEGER, XSD_PREFIX, XSD_QNAME, XSD_RESTRICTION, XSD_SIMPLE_CONTENT, XSD_SIMPLE_TYPE, XSD_STRING, XSD_SUFF, XSD_UNION, XSD_XMLNS

Fields inherited from interface org.xmlcml.euclid.EuclidConstants

C_AMP, C_APOS, C_ATSIGN, C_BACKSLASH, C_BACKSPACE, C_CARET, C_COLON, C_COMMA, C_DEL, C_DOLLAR, C_EQUALS, C_FORMFEED, C_HASH, C_LANGLE, C_LBRAK, C_LCURLY, C_LSQUARE, C_MINUS, C_NBSP, C_NEWLINE, C_NL, C_PERCENT, C_PERIOD, C_PIPE, C_PLUS, C_POUND, C_QUERY, C_QUOT, C_RANGLE, C_RBRAK, C_RCURLY, C_RETURN, C_RSQUARE, C_SEMICOLON, C_SHRIEK, C_SLASH, C_SPACE, C_STAR, C_TAB, C_TILDE, C_UNDER, EPS, F_S, NONWHITEPUNC, NONWHITEPUNC0, NONWHITEPUNC0REGEX, ONE_THIRD, PUNC, S_AMP, S_APOS, S_ATSIGN, S_BACKSLASH, S_CARET, S_COLON, S_COMMA, S_DOLLAR, S_EMPTY, S_EQUALS, S_FORMFEED, S_HASH, S_LANGLE, S_LBRAK, S_LCURLY, S_LSQUARE, S_MINUS, S_NEWLINE, S_NL, S_PERCENT, S_PERIOD, S_PIPE, S_PLUS, S_POUND, S_QUERY, S_QUOT, S_RANGLE, S_RBRAK, S_RCURLY, S_RETURN, S_RSQUARE, S_SEMICOLON, S_SHRIEK, S_SLASH, S_SPACE, S_STAR, S_TAB, S_TILDE, S_UNDER, S_WHITEREGEX, TWO_THIRDS, U_S, WHITESPACE

Constructor Summary

Constructors

Constructor and Description
XMLUtil()

Method Summary

Modifier and Type	Method and Description
static String	addMissingEndTags(String s, String tag) adds missing end tag crude - adds /> and then deletes any />(/tag)
static void	BUG(String message) bug report.
static String	capitalize(String name) capitalize name e.g.
static void	checkAttributeNames(nu.xom.Element element, List<String> allowedAttributeNames) checks that attribute names are in allowed list.
static void	checkChildElementNames(nu.xom.Element element, List<String> allowedChildNodeNames) checks that childNode names are in allowed list.
static void	checkPrefixedName(String name) checks that name is QName.
static String	compareAttributesCanonically(nu.xom.Element refNode, nu.xom.Element testNode, String xpath) compare attributes on two elements.
static String	compareChildNodesCanonically(nu.xom.Element refNode, nu.xom.Element testNode, String xpath) compare child nodes recursively
static String	compareNamespacesCanonically(nu.xom.Element refNode, nu.xom.Element testNode, String xpath) compare namespaces on two elements
static String	compareNonElementNodesCanonically(nu.xom.Node refNode, nu.xom.Node testNode, String xpath) compare non-element nodes.
static void	copyAttributes(nu.xom.Element from, nu.xom.Element to) copies attributes of 'from' to 'to'
static void	copyAttributesFromTo(nu.xom.Element from, nu.xom.Element to) copies attributes of 'from' to 'to'
static void	debug(nu.xom.Element el) Deprecated. use debug(el, message) instead
static void	debug(nu.xom.Element el, File file, int indent)
static void	debug(nu.xom.Element el, OutputStream os, int indent) debug an element.
static void	debug(nu.xom.Element el, String message) debug an element.
static void	debugPreserveWhitespace(nu.xom.Element element)
static void	debugToErr(nu.xom.Element el) debug an element.
static void	deleteAttribute(nu.xom.Element element, String attName) it attribute exists detach it.
static void	detach(nu.xom.Element element)
static nu.xom.Document	ensureDocument(nu.xom.Element element) gets Document for element.
static String	equalsCanonically(nu.xom.Element refElement, nu.xom.Element testElement, boolean stripWhite) tests 2 XML objects for equality using recursive descent.
static String	equalsCanonically(nu.xom.Element refElement, nu.xom.Element testElement, boolean stripWhite, String xpath) tests 2 XML objects for equality using recursive descent.
static String	equalsCanonically(File refFile, nu.xom.Element testElement, boolean stripWhite) compares XML element against reference file for equality using recursive descent.
static String	equalsCanonically(File refFile, File testFile, boolean stripWhite) compares two XML files for equality using recursive descent.
static String	equalsCanonically(String refNodeXML, nu.xom.Element testElement, boolean stripWhite) tests 2 XML objects for equality using recursive descent.
static String	getCanonicalString(nu.xom.Node node) get XOM default canonical string.
static List<nu.xom.Node>	getChildNodes(nu.xom.Element el) convenience routine to get child nodes (iterating through getChild(i) is fragile if children are removed)
static String	getCommonLeadingString(String s1, String s2)
static nu.xom.Text	getFirstTextDescendant(nu.xom.Node node) gets first text descendant of element.
static String	getFirstValue(nu.xom.Element element, String xpath, nu.xom.XPathContext xPathContext) convenience method to extract value of the first of one-or-more nodes.
static nu.xom.Node	getFollowingSibling(nu.xom.Node current) get next sibling.
static nu.xom.Text	getLastTextDescendant(nu.xom.Node node) gets last text descendant of element.
static String	getLocalName(String s) get localName from qualified name.
static nu.xom.Node	getPrecedingSibling(nu.xom.Node current) get previous sibling.
static String	getPrefix(String s) get prefix from qualified name.
static List<nu.xom.Element>	getQueryElements(nu.xom.Node node, String xpath) convenience routine to get query Elements returns empty list if ANY nodes are not elements
static List<nu.xom.Element>	getQueryElements(nu.xom.Node node, String xpath, nu.xom.XPathContext context) convenience routine to get query Elements returns empty list if ANY nodes are not elements
static List<nu.xom.Node>	getQueryNodes(nu.xom.Node node, String xpath) convenience routine to get query nodes (iterating through get(i) is fragile if nodes are removed)
static List<nu.xom.Node>	getQueryNodes(nu.xom.Node node, String xpath, nu.xom.XPathContext context) convenience routine to get query nodes (iterating thorugh get(i) is fragile if nodes are removed)
static nu.xom.Element	getSingleElement(nu.xom.Element element, String xpath)
static nu.xom.Element	getSingleElement(nu.xom.Element element, String xpath, nu.xom.XPathContext xPathContext) convenience method to get exactly one element.
static String	getSingleValue(nu.xom.Element element, String xpath) convenience method to extract value of exactly one node..
static String	getSingleValue(nu.xom.Element element, String xpath, nu.xom.XPathContext xPathContext) convenience method to extract value of exactly one node.
static String	getXMLContent(nu.xom.Element element) sets text content of element.
static nu.xom.Document	getXMLResource(String filename) convenience method to get resource from XMLFile.
static String	isXMLFile(File file) check file is existing file, not null or directory,
static String	makeAbstractName(String name) create local Abstract class name.
static String	makeId(String s) make id from string.
static String	normalizeSpace(String value)
static nu.xom.Element	normalizeWhitespaceInTextNodes(nu.xom.Element element)
static void	outputQuietly(nu.xom.Element elem, File file, int indent) convenience method to avoid trapping exception
static nu.xom.Document	parseQuietlyToDocument(File xmlFile)
static nu.xom.Document	parseQuietlyToDocument(InputStream is)
static nu.xom.Document	parseQuietlyToDocumentWithoutDTD(File file)
static nu.xom.Document	parseResourceQuietlyToDocument(String resource)
static nu.xom.Element	parseXML(String xmlString) parses XML string into element.
static String	removeScripts(String s)
static String	removeTags(String tag, String ss)
static void	removeWhitespaceNodes(nu.xom.Element element) remeoves all whitespace-only text nodes.
static void	setXMLContent(nu.xom.Element element, String s) sets text content of element.
static String	stripDTD(String s) Removes DOCTYPE DOCTYPE can cause problems by requiring to load DTD from URL which can take many seconds or, if offline, can cause failure to parse.
static nu.xom.Document	stripDTDAndOtherProblematicXMLHeadings(String s) Deprecated.
static nu.xom.Element	stripDTDAndParse(String s) Removes DOCTYPE and then parses DOCTYPE can cause problems by requiring to load DTD from URL which can take many seconds or, if offline, can cause failure to parse.
static void	stripTrailingWhitespaceinTexts(nu.xom.Element element) some formatted XML introduces spurious WS after text strings
static Object[]	toArray(nu.xom.Elements elements, Object[] obj) converts an Elements to a java array.
static String	toXMLString(nu.xom.Element element)
static void	transferChildren(nu.xom.Element from, nu.xom.Element to) transfers children of 'from' to 'to'.

Methods inherited from class java.lang.Object

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

Field Detail

DTD

public static final String DTD

See Also:

Constant Field Values

Constructor Detail

XMLUtil

public XMLUtil()

Method Detail

checkPrefixedName

public static final void checkPrefixedName(String name)

checks that name is QName.

Parameters:

name - of XMLName not colonized

getPrefix

public static String getPrefix(String s)

get prefix from qualified name.

Parameters:

s -

Returns:

prefix (or empty string)

getLocalName

public static String getLocalName(String s)

get localName from qualified name.

Parameters:

s -

Returns:

localName (or empty string)

getSingleValue

public static String getSingleValue(nu.xom.Element element,
                                    String xpath,
                                    nu.xom.XPathContext xPathContext)

convenience method to extract value of exactly one node. uses element.query(xpath, xPathContext);

Parameters:

element -

xpath -

xPathContext - defines prefix/namespace used in query

Returns:

value if exactly 1 node (0 or many returns null)

getSingleValue

public static String getSingleValue(nu.xom.Element element,
                                    String xpath)

convenience method to extract value of exactly one node.. uses element.query(xpath, xPathContext);

Parameters:

element -

xpath -

Returns:

value if exactly 1 node (0 or many returns null)

getFirstValue

public static String getFirstValue(nu.xom.Element element,
                                   String xpath,
                                   nu.xom.XPathContext xPathContext)

convenience method to extract value of the first of one-or-more nodes. uses element.query(xpath, xPathContext);

Parameters:

element -

xpath -

xPathContext - defines prefix/namespace used in query

Returns:

value if exactly 1 node (0 or many returns null)

getSingleElement

public static nu.xom.Element getSingleElement(nu.xom.Element element,
                                              String xpath,
                                              nu.xom.XPathContext xPathContext)

convenience method to get exactly one element. uses element.query(xpath, xPathContext);

Parameters:

element -

xpath -

xPathContext - defines prefix/namespace used in query

Returns:

value if exactly 1 element (0 or many returns null)

toArray

public static final Object[] toArray(nu.xom.Elements elements,
                                     Object[] obj)

converts an Elements to a java array. we might convert code to use Elements through later so this would be unneeded

Parameters:

elements -

obj - type of array (e.g. "new CMLAtom[0]"

Returns:

the java array 0f objects

debug

public static void debug(nu.xom.Element el)

Deprecated. use debug(el, message) instead

debug an element. outputs XML to sysout indent = 2

Parameters:

el - the element

debugToErr

public static void debugToErr(nu.xom.Element el)

debug an element. outputs XML to syserr

Parameters:

el - the element

debug

public static void debug(nu.xom.Element el,
                         String message)

debug an element.

Parameters:

el - the element

message -

debug

public static void debug(nu.xom.Element el,
                         OutputStream os,
                         int indent)
                  throws IOException

debug an element.

Parameters:

el - the element

os - output stream

indent - indentation

Throws:

IOException

debug

public static void debug(nu.xom.Element el,
                         File file,
                         int indent)
                  throws IOException

Throws:

IOException

outputQuietly

public static void outputQuietly(nu.xom.Element elem,
                                 File file,
                                 int indent)

convenience method to avoid trapping exception

Parameters:

elem -

file -

indent -

getXMLResource

public static nu.xom.Document getXMLResource(String filename)
                                      throws IOException

convenience method to get resource from XMLFile. the resource is packaged with the classes for distribution. typical filename is org/xmlcml/molutil/elementdata.xml for file elementdata.xml in class hierarchy org.xmlcml.molutil

Parameters:

filename - relative to current class hierarchy.

Returns:

document for resource

Throws:

IOException

getChildNodes

public static List<nu.xom.Node> getChildNodes(nu.xom.Element el)

convenience routine to get child nodes (iterating through getChild(i) is fragile if children are removed)

Parameters:

el - may be null

Returns:

list of children (immutable) - empty if none

parseXML

public static nu.xom.Element parseXML(String xmlString)
                               throws RuntimeException

parses XML string into element. convenience method to avoid trapping exceptions when string is known to be valid

Parameters:

xmlString -

Returns:

root element

Throws:

RuntimeException

getQueryNodes

public static List<nu.xom.Node> getQueryNodes(nu.xom.Node node,
                                              String xpath,
                                              nu.xom.XPathContext context)

convenience routine to get query nodes (iterating thorugh get(i) is fragile if nodes are removed)

Parameters:

node - (can be null)

xpath - xpath relative to node

context -

Returns:

list of nodes (immutable) - empty if none

getQueryNodes

public static List<nu.xom.Node> getQueryNodes(nu.xom.Node node,
                                              String xpath)

convenience routine to get query nodes (iterating through get(i) is fragile if nodes are removed)

Parameters:

node -

xpath -

Returns:

list of nodes (immutable) - empty if none or null node

getQueryElements

public static List<nu.xom.Element> getQueryElements(nu.xom.Node node,
                                                    String xpath)

convenience routine to get query Elements returns empty list if ANY nodes are not elements

Parameters:

node -

xpath -

Returns:

list of nodes (immutable) - empty if none or null node

getQueryElements

public static List<nu.xom.Element> getQueryElements(nu.xom.Node node,
                                                    String xpath,
                                                    nu.xom.XPathContext context)

convenience routine to get query Elements returns empty list if ANY nodes are not elements

Parameters:

node -

xpath -

Returns:

list of nodes (immutable) - empty if none or null node

getFollowingSibling

public static nu.xom.Node getFollowingSibling(nu.xom.Node current)

get next sibling.

Parameters:

current - may be null

Returns:

following sibling or null

getPrecedingSibling

public static nu.xom.Node getPrecedingSibling(nu.xom.Node current)

get previous sibling.

Parameters:

current -

Returns:

previous sibling

getLastTextDescendant

public static nu.xom.Text getLastTextDescendant(nu.xom.Node node)

gets last text descendant of element. this might be referenced from the following-sibling and will therefore be the immediately preceding chunk of text in document order if the node is a text node returns itself

Parameters:

node -

Returns:

Text node or null

getFirstTextDescendant

public static nu.xom.Text getFirstTextDescendant(nu.xom.Node node)

gets first text descendant of element. this might be referenced from the preceding-sibling and will therefore be the immediately following chunk of text in document order if the node is a text node returns itself

Parameters:

node -

Returns:

Text node or null

transferChildren

public static void transferChildren(nu.xom.Element from,
                                    nu.xom.Element to)

transfers children of 'from' to 'to'.

Parameters:

from - (will be left with no children)

to - (will gain 'from' children appended after any existing children

copyAttributes

public static void copyAttributes(nu.xom.Element from,
                                  nu.xom.Element to)
                           throws IllegalArgumentException

copies attributes of 'from' to 'to'

Parameters:

from -

to -

Throws:

IllegalArgumentException - null arguments

getCanonicalString

public static String getCanonicalString(nu.xom.Node node)
                                 throws IllegalArgumentException

get XOM default canonical string.

Parameters:

node -

Returns:

the string

Throws:

IllegalArgumentException

removeWhitespaceNodes

public static void removeWhitespaceNodes(nu.xom.Element element)

remeoves all whitespace-only text nodes.

Parameters:

element - to strip whitespace from

setXMLContent

public static void setXMLContent(nu.xom.Element element,
                                 String s)

sets text content of element. Does not support mixed content.

Parameters:

element -

s -

Throws:

RuntimeException - if element already has element content

getXMLContent

public static String getXMLContent(nu.xom.Element element)

sets text content of element. Does not support mixed content.

Parameters:

element -

Returns:

text value

Throws:

RuntimeException - if element already has element content

toXMLString

public static String toXMLString(nu.xom.Element element)

BUG

public static void BUG(String message)

bug report.

Parameters:

message -

makeId

public static String makeId(String s)

make id from string. convert to lowercase and replace space by underscore

Parameters:

s -

Returns:

new id (null if s is null)

makeAbstractName

public static String makeAbstractName(String name)

create local Abstract class name. e.g. AbstractFooBar from fooBar

Parameters:

name -

Returns:

name

capitalize

public static String capitalize(String name)

capitalize name e.g. FooBar from fooBar

Parameters:

name -

Returns:

name

equalsCanonically

public static String equalsCanonically(String refNodeXML,
                                       nu.xom.Element testElement,
                                       boolean stripWhite)

tests 2 XML objects for equality using recursive descent. includes namespace testing

Parameters:

refNodeXML - xml serialization of first Element

testElement - second Element

stripWhite - if true remove w/s nodes

Returns:

message of where elements differ (null if identical)

equalsCanonically

public static String equalsCanonically(nu.xom.Element refElement,
                                       nu.xom.Element testElement,
                                       boolean stripWhite)

tests 2 XML objects for equality using recursive descent. includes namespace testing

Parameters:

refElement - first node

testElement - second node

stripWhite - if true remove w/s nodes

Returns:

message of where elements differ (null if identical)

equalsCanonically

public static String equalsCanonically(nu.xom.Element refElement,
                                       nu.xom.Element testElement,
                                       boolean stripWhite,
                                       String xpath)

tests 2 XML objects for equality using recursive descent. includes namespace testing

Parameters:

refElement - first node

testElement - second node

stripWhite - if true remove w/s nodes

Returns:

message of where elements differ (null if identical)

equalsCanonically

public static String equalsCanonically(File refFile,
                                       File testFile,
                                       boolean stripWhite)

compares two XML files for equality using recursive descent.

Parameters:

refFile -

testFile -

stripWhite -

Returns:

null if identical; else a message about errors in files, XML, etc.

equalsCanonically

public static String equalsCanonically(File refFile,
                                       nu.xom.Element testElement,
                                       boolean stripWhite)

compares XML element against reference file for equality using recursive descent.

Parameters:

refFile -

testElement -

stripWhite -

Returns:

null if identical; else a message about errors in files, XML, etc.

isXMLFile

public static String isXMLFile(File file)

check file is existing file, not null or directory,

Parameters:

file - to check

Returns:

null if no problems else message

getCommonLeadingString

public static String getCommonLeadingString(String s1,
                                            String s2)

compareNamespacesCanonically

public static String compareNamespacesCanonically(nu.xom.Element refNode,
                                                  nu.xom.Element testNode,
                                                  String xpath)

compare namespaces on two elements

Parameters:

refNode -

testNode -

xpath - current ancestry of refNode

Returns:

compareAttributesCanonically

public static String compareAttributesCanonically(nu.xom.Element refNode,
                                                  nu.xom.Element testNode,
                                                  String xpath)

compare attributes on two elements. includes normalizing attribute values

Parameters:

refNode -

testNode -

xpath - current ancestry of refNode

Returns:

normalizeSpace

public static String normalizeSpace(String value)

compareChildNodesCanonically

public static String compareChildNodesCanonically(nu.xom.Element refNode,
                                                  nu.xom.Element testNode,
                                                  String xpath)

compare child nodes recursively

Parameters:

refNode -

testNode -

xpath - current ancestry of refNode

Returns:

compareNonElementNodesCanonically

public static String compareNonElementNodesCanonically(nu.xom.Node refNode,
                                                       nu.xom.Node testNode,
                                                       String xpath)

compare non-element nodes. not yet tuned for normalizing adjacent CDATA and other horrors

Parameters:

refNode -

testNode -

xpath - current ancestry of refNode

Returns:

stripTrailingWhitespaceinTexts

public static void stripTrailingWhitespaceinTexts(nu.xom.Element element)

some formatted XML introduces spurious WS after text strings

Parameters:

element -

getSingleElement

public static nu.xom.Element getSingleElement(nu.xom.Element element,
                                              String xpath)

detach

public static void detach(nu.xom.Element element)

ensureDocument

public static nu.xom.Document ensureDocument(nu.xom.Element element)

gets Document for element.

if none exists, creates one. Note that if the element already has ancestry a Document is created for the rootElement. That may mean that XOM.Serializer writes the whole document.

Parameters:

element -

Returns:

parseQuietlyToDocument

public static nu.xom.Document parseQuietlyToDocument(InputStream is)

parseResourceQuietlyToDocument

public static nu.xom.Document parseResourceQuietlyToDocument(String resource)

parseQuietlyToDocument

public static nu.xom.Document parseQuietlyToDocument(File xmlFile)

stripDTDAndOtherProblematicXMLHeadings

@Deprecated
public static nu.xom.Document stripDTDAndOtherProblematicXMLHeadings(String s)
                                                                          throws IOException

Deprecated.

<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN' 'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>

Parameters:

s -

Returns:

Throws:

IOException

stripDTD

public static String stripDTD(String s)

Removes DOCTYPE DOCTYPE can cause problems by requiring to load DTD from URL which can take many seconds or, if offline, can cause failure to parse. This is dangerous but so is the DOCTYPE:

 
 <!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
   'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
 

Parameters:

s -

Returns:

stripDTDAndParse

public static nu.xom.Element stripDTDAndParse(String s)

Removes DOCTYPE and then parses DOCTYPE can cause problems by requiring to load DTD from URL which can take many seconds or, if offline, can cause failure to parse. This is dangerous but so is the DOCTYPE:

 
 <!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
   'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
 

Parameters:

s -

Returns:

addMissingEndTags

public static String addMissingEndTags(String s,
                                       String tag)

adds missing end tag crude - adds /> and then deletes any />(/tag)

 String s = "<a><meta></a>";
 s = XMLUtil.addMissingEndTags(s, "meta");
 Assert.assertEquals("<a><meta/></a>", s);
 

Parameters:

s -

tag -

Returns:

removeScripts

public static String removeScripts(String s)

removeTags

public static String removeTags(String tag,
                                String ss)

debugPreserveWhitespace

public static void debugPreserveWhitespace(nu.xom.Element element)

normalizeWhitespaceInTextNodes

public static nu.xom.Element normalizeWhitespaceInTextNodes(nu.xom.Element element)

copyAttributesFromTo

public static void copyAttributesFromTo(nu.xom.Element from,
                                        nu.xom.Element to)

copies attributes of 'from' to 'to'

Parameters:

from -

to -

deleteAttribute

public static void deleteAttribute(nu.xom.Element element,
                                   String attName)

it attribute exists detach it.

Parameters:

element -

attName -

parseQuietlyToDocumentWithoutDTD

public static nu.xom.Document parseQuietlyToDocumentWithoutDTD(File file)

checkAttributeNames

public static void checkAttributeNames(nu.xom.Element element,
                                       List<String> allowedAttributeNames)

checks that attribute names are in allowed list.

Parameters:

element -

allowedAttributeNames -

Throws:

RuntimeException - if unknown attribute

checkChildElementNames

public static void checkChildElementNames(nu.xom.Element element,
                                          List<String> allowedChildNodeNames)

checks that childNode names are in allowed list.

Parameters:

element -

allowedChildNodeNames - can include element names, #text, - other node types are always allowed

Throws:

RuntimeException - if unknown childElement