ucar.unidata.xml

Class XmlUtil

java.lang.Object

ucar.unidata.xml.XmlUtil

Direct Known Subclasses:

XmlEncoder

public abstract class XmlUtil
extends java.lang.Object

A collection of utilities for xml.

Author:

IDV development team

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	XmlUtil.ElementListIterator _more_

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NULL_STRING Just so we don't have to do (String) null.
static java.lang.String	TAG_WILDCARD used for matching any tag
static java.lang.String	XML_HEADER The header to use when writing out xml

Constructor Summary

Constructors

Constructor and Description
XmlUtil() Dummy ctor for doclint.

Method Summary

Modifier and Type	Method and Description
static void	addChildren(org.w3c.dom.Element element, java.util.List children) Append the given list of children Elements to the given Element.
static void	appendCdata(java.lang.StringBuffer sb, java.lang.String s) _more_
static void	appendCdataBytes(java.lang.StringBuffer sb, byte[] bytes) _more_
static void	attr(java.lang.Appendable buff, java.lang.String name, java.lang.String value, java.lang.String tab) Append onto the given StringBuffer name="value" string encode the value.
static java.lang.String	attr(java.lang.String name, java.lang.String value) Return a String with name="value".
static java.lang.String	attrs(java.lang.String[] attrs) _more_
static java.lang.String	attrs(java.lang.String name, java.lang.String value) _more_
static java.lang.String	attrs(java.lang.String n1, java.lang.String v1, java.lang.String n2, java.lang.String v2) Return a String with n1="v1" n2="v2".
static java.lang.String	attrs(java.lang.String n1, java.lang.String v1, java.lang.String n2, java.lang.String v2, java.lang.String n3, java.lang.String v3) Return a String with n1="v1" n2="v2".
static java.lang.String	attrs(java.lang.String n1, java.lang.String v1, java.lang.String n2, java.lang.String v2, java.lang.String n3, java.lang.String v3, java.lang.String n4, java.lang.String v4) Return a String with n1="v1" n2="v2".
static java.lang.String	calculateRFC2104HMAC(java.lang.String data, java.lang.String key) Computes RFC 2104-compliant HMAC signature.
static java.lang.String	closeTag(java.lang.String name) Make a close tag
static java.lang.String	comment(java.lang.String value) Create and return an xml comment.
static org.w3c.dom.Element	create(org.w3c.dom.Document doc, java.lang.String tag) _more_
static org.w3c.dom.Element	create(org.w3c.dom.Document doc, java.lang.String tag, org.w3c.dom.Element parent) _more_
static org.w3c.dom.Element	create(org.w3c.dom.Document doc, java.lang.String tag, org.w3c.dom.Element parent, java.util.List attrs) _more_
static org.w3c.dom.Element	create(org.w3c.dom.Document doc, java.lang.String tag, org.w3c.dom.Element parent, java.lang.String text) _more_
static org.w3c.dom.Element	create(org.w3c.dom.Document doc, java.lang.String tag, org.w3c.dom.Element parent, java.lang.String[] attrs) _more_
static org.w3c.dom.Element	create(org.w3c.dom.Document doc, java.lang.String tag, org.w3c.dom.Element parent, java.lang.String text, java.lang.String[] attrs) _more_
static org.w3c.dom.Element	create(org.w3c.dom.Document doc, java.lang.String tag, java.lang.String[] attrs) _more_
static org.w3c.dom.Element	create(java.lang.String tag, org.w3c.dom.Element parent) _more_
static org.w3c.dom.Element	create(java.lang.String tag, org.w3c.dom.Element parent, java.util.List attrs) _more_
static org.w3c.dom.Element	create(java.lang.String tag, org.w3c.dom.Element parent, java.lang.String text) _more_
static org.w3c.dom.Element	create(java.lang.String tag, org.w3c.dom.Element parent, java.lang.String[] attrs) _more_
static org.w3c.dom.Element	create(java.lang.String tag, org.w3c.dom.Element parent, java.lang.String text, java.lang.String[] attrs) _more_
static void	createCDataNode(org.w3c.dom.Element parent, java.lang.String text) _more_
static byte[]	decodeBase64(java.lang.String s) Decode the given base64 String
static XmlUtil.ElementListIterator	elements(java.lang.String xmlFile, java.lang.String xPath) _more_
static java.lang.String	encodeBase64(byte[] b) Return the base64 encoded representation of the given byte array
static java.lang.String	encodeString(java.lang.String v) Do a simple conversion of special characters to their encoding.
static void	ensureAttributes(org.w3c.dom.Node element, java.lang.String[] attrs) Make sure that the given element contains the given attributes.
static org.w3c.dom.NodeList	eval(java.lang.String xmlFile, java.lang.String xPath) _more_
static javax.xml.xpath.XPathExpression	expr(java.lang.String xPath) _more_
static org.w3c.dom.Element	findAncestor(org.w3c.dom.Element child, java.lang.String tagName) Find the ancestor of the given node with the given tagname
static org.w3c.dom.Element	findChild(org.w3c.dom.Node parent, java.lang.String tag) Find the first child element of the given parent Node whose tag name.equals the given tag.
static org.w3c.dom.Element	findChildRecurseUp(org.w3c.dom.Node parent, java.lang.String tag) Find the first child element of the given parent Node whose tag name.equals the given tag.
static java.util.List	findChildren(org.w3c.dom.Node parent, java.lang.String tag) Find all of the children elements of the given parent Node whose tag name.equals the given tag.
static java.util.List	findChildrenRecurseUp(org.w3c.dom.Node parent, java.lang.String tag) Find all of the children elements of the given parent Node and all of its ancestors whose tag name.equals the given tag.
static org.w3c.dom.Element	findDescendant(org.w3c.dom.Node parent, java.lang.String tag) Find the first descendant element of the given parent Node whose tag name.equals the given tag.
static org.w3c.dom.Element	findDescendantFromPath(org.w3c.dom.Element parent, java.lang.String path) This method searches, starting at the given parent, for a descendant path.
static java.util.List	findDescendants(org.w3c.dom.Node parent, java.lang.String tag) Find all of the descendant elements of the given parent Node whose tag name.equals the given tag.
static java.util.List	findDescendantsFromPath(org.w3c.dom.Element parent, java.lang.String path) Like findDescendantFromPath, this method finds all descendants.
static org.w3c.dom.Element	findElement(org.w3c.dom.Element root, java.lang.String tag, java.lang.String attributeName, java.lang.String attributeValue) Find the Element under (recursively) the given root Element with the given tag name (if non-null) that contains an attribute of the given name and value.
static org.w3c.dom.Element	findElement(org.w3c.dom.NodeList elements, java.lang.String attributeName, java.lang.String attributeValue) Find the first Element in the given NodeList of Elements that has the given attribute with value .equals the given attributeValue.
static org.w3c.dom.Element	findRoot(org.w3c.dom.Element child) Find the root element of the given node.
static org.w3c.dom.Element	findUrlRefNode(org.w3c.dom.Element node) This method will return either the given node argument if it does not contain an attribute of name "url".
static org.w3c.dom.Element	findUrlRefNode(org.w3c.dom.Element node, java.lang.String urlAttr) This method will return either the given node argument if it does not contain an attribute of the given urlAttr.
static java.lang.String	getAttribute(org.w3c.dom.NamedNodeMap attrs, java.lang.String name) Get the given name-d attribute from the given attrs map.
static boolean	getAttribute(org.w3c.dom.NamedNodeMap attrs, java.lang.String name, boolean dflt) Get the given name-d attribute from the given attrs map.
static java.awt.Color	getAttribute(org.w3c.dom.NamedNodeMap attrs, java.lang.String name, java.awt.Color dflt) Get the given name-d attribute from the given attrs map.
static double	getAttribute(org.w3c.dom.NamedNodeMap attrs, java.lang.String name, double dflt) Get the given name-d attribute from the given attrs map.
static float	getAttribute(org.w3c.dom.NamedNodeMap attrs, java.lang.String name, float dflt) Get the given name-d attribute from the given attrs map.
static int	getAttribute(org.w3c.dom.NamedNodeMap attrs, java.lang.String name, int dflt) Get the given name-d attribute from the given attrs map.
static java.lang.String	getAttribute(org.w3c.dom.NamedNodeMap attrs, java.lang.String name, java.lang.String dflt) Get the given name-d attribute from the given attrs map.
static java.lang.String	getAttribute(org.w3c.dom.Node element, java.lang.String name) Get the given name attribute from the given element.
static boolean	getAttribute(org.w3c.dom.Node element, java.lang.String name, boolean dflt) Get the given name-d attribute from the given element.
static java.awt.Color	getAttribute(org.w3c.dom.Node element, java.lang.String name, java.awt.Color dflt) Get the given name-d attribute from the given element.
static double	getAttribute(org.w3c.dom.Node element, java.lang.String name, double dflt) Get the given name-d attribute from the given element.
static float	getAttribute(org.w3c.dom.Node element, java.lang.String name, float dflt) Get the given name-d attribute from the given element.
static int	getAttribute(org.w3c.dom.Node element, java.lang.String name, int dflt) Get the given name-d attribute from the given element.
static java.lang.String	getAttribute(org.w3c.dom.Node element, java.lang.String name, java.lang.String dflt) Get the given name-d attribute from the given element.
static java.lang.String	getAttributeFromTree(org.w3c.dom.Node element, java.lang.String name) Get the given named attribute from the given element.
static boolean	getAttributeFromTree(org.w3c.dom.Node element, java.lang.String name, boolean dflt) _more_
static int	getAttributeFromTree(org.w3c.dom.Node element, java.lang.String name, int dflt) Get the given named attribute from the given element.
static java.lang.String	getAttributeFromTree(org.w3c.dom.Node element, java.lang.String name, java.lang.String dflt) Get the given named attribute from the given element.
static java.util.List	getAttributesFromTree(org.w3c.dom.Node element, java.lang.String name, java.util.Hashtable tags) Get a list of attributes of the given name from the given element and all of its parent elements.
static java.util.List	getAttributesFromTree(org.w3c.dom.Node element, java.lang.String name, java.util.Hashtable tags, java.util.List listOfValues) Get a list of attributes of the given name from the given element and all of its parent elements.
static java.lang.String	getCdata(java.lang.String s) _more_
static java.lang.String	getChildText(org.w3c.dom.Node parent) Concatenates the node values (grom getNodeValue) of the children of the given parent Node.
static org.w3c.dom.Document	getDocument(java.io.InputStream stream) Create a Document object with the given xml.
static org.w3c.dom.Document	getDocument(java.lang.String xml) Create a Document object with the given xml.
static org.w3c.dom.Document	getDocument(java.lang.String filename, java.lang.Class originClass) Read in the xml contained in the given filename, parse it and return the root Element.
static org.w3c.dom.Element	getElement(org.w3c.dom.Element parent, java.lang.String tagName) Get the first Element children of the given parent Element with the given tagName.
static org.w3c.dom.NodeList	getElements(org.w3c.dom.Element parent) Get all children of the given parent Element who are instances of the Element class.
static XmlNodeList	getElements(org.w3c.dom.Element parent, java.lang.String tagName) Get all Element children of the given parent Element with the given tagName.
static org.w3c.dom.NodeList	getElements(org.w3c.dom.Element parent, XmlNodeList nodeList) Get all children of the given parent Element who are instances of the Element class.
static org.w3c.dom.Element	getFirstChild(org.w3c.dom.Element parent) Get the first Element child of the given parent Element.
static org.w3c.dom.NodeList	getGrandChildren(org.w3c.dom.Element parent) Get all grand children of the given parent Element who are instances of the Element class.
static java.lang.String	getGrandChildText(org.w3c.dom.Node parent, java.lang.String childTag) Finds the child node with the given tag name.
static java.lang.String	getGrandChildText(org.w3c.dom.Node parent, java.lang.String childTag, java.lang.String dflt) Finds the child node with the given tag name.
static double	getGrandChildValue(org.w3c.dom.Node parent, java.lang.String childTag, double dflt) _more_
static java.lang.String	getHeader() Return the default xml header.
static java.util.List	getListOfElements(org.w3c.dom.Element parent) Create and return a List of the Element children of the given parent node.
static java.lang.String	getLocalName(org.w3c.dom.Node element) Get the non qualified tag name
static java.lang.String	getNodeName(org.w3c.dom.Node node) Get the non qualified tag name
static org.w3c.dom.Element	getRoot(java.io.InputStream stream) Read in the xml contained in the given filename, parse it and return the root Element.
static org.w3c.dom.Element	getRoot(java.lang.String xml) Parse the given xml and return the root Element.
static org.w3c.dom.Element	getRoot(java.lang.String filename, java.lang.Class originClass) Read in the xml contained in the given filename, parse it and return the root Element.
static boolean	hasAttribute(org.w3c.dom.Node element, java.lang.String attributeName) Does the given node have the attribute
static boolean	isFullyQualified(java.lang.String tagName) _more_
static boolean	isTag(org.w3c.dom.Node node, java.lang.String name) Checks if the tag name of the given node matches the given name.
static org.w3c.dom.Document	loadXml(java.lang.String xmlFile) _more_
static void	main(java.lang.String[] args) A main for tests
static org.w3c.dom.CDATASection	makeCDataNode(org.w3c.dom.Document doc, java.lang.String text) _more_
static org.w3c.dom.CDATASection	makeCDataNode(org.w3c.dom.Document doc, java.lang.String text, boolean andEncode) _more_
static org.w3c.dom.Document	makeDocument() A utility to make an empty document
static void	mergeAttributes(org.w3c.dom.Element n1, org.w3c.dom.Element n2) Copy the attributes from n2 to n1.
static java.lang.String	openTag(java.lang.String name) Make an open tag
static java.lang.String	openTag(java.lang.String name, java.lang.String attrs) Return a String of the form: <name attrs />
static java.lang.String	quote(java.lang.String value) Wrap the given string value in quotes.
static void	removeChildren(org.w3c.dom.Element parent) Remove all children from the given parent Element.
static void	setAttribute(org.w3c.dom.Element node, java.lang.String name, java.awt.Color value) A utility to set the attribute on the given node as the String representation of the given color
static void	setAttributes(org.w3c.dom.Element node, java.lang.String[] attrs) The attrs parameter is an array of [name1, value1, name2, value2, etc].
static java.lang.String	tag(java.lang.String name, java.lang.String attrs) Return a String of the form: <name attrs />
static java.lang.String	tag(java.lang.String name, java.lang.String attrs, java.lang.String contents) Return a String of the form: <name attrs > contents </name>
static void	toHtml(java.lang.StringBuffer html, org.w3c.dom.Node node) _more_
static java.lang.String	toString(org.w3c.dom.Node node) Convert the DOM rooted at the given Node to an xml String representation.
static void	toString(org.w3c.dom.Node node, java.lang.Appendable appendable) _more_
static java.lang.String	toString(org.w3c.dom.Node node, boolean prettyPrint) Convert the DOM rooted at the given Node to an xml String representation.
static java.lang.String	toString(org.w3c.dom.Node node, java.lang.String tabSpacing, java.lang.String newLine) Convert the DOM rooted at the given Node to an xml representation.
static java.lang.String	toString(org.w3c.dom.Node node, java.lang.String tabSpacing, java.lang.String newLine, boolean recurse) Convert the DOM rooted at the given Node to an xml representation.
static java.lang.String	toStringNoChildren(org.w3c.dom.Node node) Convert the DOM rooted at the given Node to an xml String representation.
static java.lang.String	toStringWithHeader(org.w3c.dom.Node node) Convert the DOM rooted at the given Node to an xml String representation.
static java.lang.String	toStringWithHeader(org.w3c.dom.Node node, java.lang.String tabSpacing, java.lang.String newLine) Convert the DOM rooted at the given Node to an xml representation.
static java.lang.String	toStringWithHeader(org.w3c.dom.Node node, java.lang.String tabSpacing, java.lang.String newLine, boolean prettifyAttrs) Convert the xml to a string.

Methods inherited from class java.lang.Object

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

Field Detail

XML_HEADER

public static final java.lang.String XML_HEADER

The header to use when writing out xml

See Also:

Constant Field Values

TAG_WILDCARD

public static final java.lang.String TAG_WILDCARD

used for matching any tag

See Also:

Constant Field Values

NULL_STRING

public static final java.lang.String NULL_STRING

Just so we don't have to do (String) null.

Constructor Detail

XmlUtil

public XmlUtil()

Dummy ctor for doclint.

Method Detail

quote

public static java.lang.String quote(java.lang.String value)

Wrap the given string value in quotes.

Parameters:

value - the String to wrap in quotes.

Returns:

The given string argument in quotes.

encodeBase64

public static java.lang.String encodeBase64(byte[] b)

Return the base64 encoded representation of the given byte array

Parameters:

b - The bytes to encode

Returns:

The encoded string

decodeBase64

public static byte[] decodeBase64(java.lang.String s)

Decode the given base64 String

Parameters:

s - Holds the base64 encoded bytes

Returns:

The decoded bytes

comment

public static java.lang.String comment(java.lang.String value)

Create and return an xml comment.

Parameters:

value - The String to comment.

Returns:

The value argument wrapped in an xml comment.

attr

public static void attr(java.lang.Appendable buff,
                        java.lang.String name,
                        java.lang.String value,
                        java.lang.String tab)

Append onto the given StringBuffer name="value" string encode the value.

Parameters:

buff - The string buffer to append onto.

name - The attribute name.

value - The attribute value.

tab - The tab to prepend onto the result.

attr

public static java.lang.String attr(java.lang.String name,
                                    java.lang.String value)

Return a String with name="value". Encode the value.

Parameters:

name - The attribute name.

value - The attribute value.

Returns:

The string "name=value"

attrs

public static java.lang.String attrs(java.lang.String[] attrs)

_more_

Parameters:

attrs - _more_

Returns:

_more_

attrs

public static java.lang.String attrs(java.lang.String name,
                                     java.lang.String value)

_more_

Parameters:

name - _more_

value - _more_

Returns:

_more_

attrs

public static java.lang.String attrs(java.lang.String n1,
                                     java.lang.String v1,
                                     java.lang.String n2,
                                     java.lang.String v2)

Return a String with n1="v1" n2="v2".

Parameters:

n1 - The first attribute name.

v1 - The first attribute value.

n2 - The second attribute name.

v2 - The second attribute value.

Returns:

The attrbiute string.

attrs

public static java.lang.String attrs(java.lang.String n1,
                                     java.lang.String v1,
                                     java.lang.String n2,
                                     java.lang.String v2,
                                     java.lang.String n3,
                                     java.lang.String v3)

Return a String with n1="v1" n2="v2". n3="v3".

Parameters:

n1 - The first attribute name.

v1 - The first attribute value.

n2 - The second attribute name.

v2 - The second attribute value.

n3 - The third attribute name.

v3 - The third attribute value.

Returns:

The attrbiute string.

attrs

public static java.lang.String attrs(java.lang.String n1,
                                     java.lang.String v1,
                                     java.lang.String n2,
                                     java.lang.String v2,
                                     java.lang.String n3,
                                     java.lang.String v3,
                                     java.lang.String n4,
                                     java.lang.String v4)

Return a String with n1="v1" n2="v2". n3="v3". n4="v4".

Parameters:

n1 - The first attribute name.

v1 - The first attribute value.

n2 - The second attribute name.

v2 - The second attribute value.

n3 - The third attribute name.

v3 - The third attribute value.

n4 - The fourth attribute name.

v4 - The fourth attribute value.

Returns:

The attrbiute string.

tag

public static java.lang.String tag(java.lang.String name,
                                   java.lang.String attrs,
                                   java.lang.String contents)

Return a String of the form: <name attrs > contents </name>

Parameters:

name - The tag name.

attrs - The attribute section of the tag.

contents - The body of the tag

Returns:

The return xml.

tag

public static java.lang.String tag(java.lang.String name,
                                   java.lang.String attrs)

Return a String of the form: <name attrs />

Parameters:

name - The tag name.

attrs - The attribute section of the tag.

Returns:

The return xml.

openTag

public static java.lang.String openTag(java.lang.String name,
                                       java.lang.String attrs)

Return a String of the form: <name attrs />

Parameters:

name - The tag name.

attrs - The attribute section of the tag.

Returns:

The return xml.

openTag

public static java.lang.String openTag(java.lang.String name)

Make an open tag

Parameters:

name - tag name

Returns:

the open tag

closeTag

public static java.lang.String closeTag(java.lang.String name)

Make a close tag

Parameters:

name - tag name

Returns:

the tag

getAttributeFromTree

public static java.lang.String getAttributeFromTree(org.w3c.dom.Node element,
                                                    java.lang.String name)

Get the given named attribute from the given element. If not found then recursively look in the parent of the given element. If the attribute is finally not found then null is returned.

Parameters:

element - The xml node to look within.

name - The attribute name

Returns:

The value of the given attribute or null if not found.

getAttributeFromTree

public static java.lang.String getAttributeFromTree(org.w3c.dom.Node element,
                                                    java.lang.String name,
                                                    java.lang.String dflt)

Get the given named attribute from the given element. If not found then recursively look in the parent of the given element. If the attribute is finally not found then the dflt argument is returned.

Parameters:

element - The xml node to look within.

name - The attribute name.

dflt - The default value returned.

Returns:

The value of the given attribute or dflt if not found.

getAttributeFromTree

public static int getAttributeFromTree(org.w3c.dom.Node element,
                                       java.lang.String name,
                                       int dflt)

Get the given named attribute from the given element. If not found then recursively look in the parent of the given element. If the attribute is finally not found then the dflt argument is returned. If it is found then convert the string value to an integer.

Parameters:

element - The xml node to look within.

name - The attribute name.

dflt - The default value returned.

Returns:

The integer value of the attribute or the dflt if the attribute is not found.

getAttributeFromTree

public static boolean getAttributeFromTree(org.w3c.dom.Node element,
                                           java.lang.String name,
                                           boolean dflt)

_more_

Parameters:

element - _more_

name - _more_

dflt - _more_

Returns:

_more_

getAttributesFromTree

public static java.util.List getAttributesFromTree(org.w3c.dom.Node element,
                                                   java.lang.String name,
                                                   java.util.Hashtable tags)

Get a list of attributes of the given name from the given element and all of its parent elements.

Parameters:

element - The xml node to look within.

name - The attribute name.

tags - If non-null then only look at elements whose tag name is held by the tags hashtable. If the element we are looking at is not within the table then stop searching upwards.

Returns:

The list of attribute values.

getAttributesFromTree

public static java.util.List getAttributesFromTree(org.w3c.dom.Node element,
                                                   java.lang.String name,
                                                   java.util.Hashtable tags,
                                                   java.util.List listOfValues)

Get a list of attributes of the given name from the given element and all of its parent elements.

Parameters:

element - The xml node to look within.

name - The attribute name.

tags - If non-null then only look at elements whose tag name is held by the tags hashtable. If the element we are looking at is not within the table then stop searching upwards.

listOfValues - The list ot put the values in.

Returns:

The list of attribute values.

hasAttribute

public static boolean hasAttribute(org.w3c.dom.Node element,
                                   java.lang.String attributeName)

Does the given node have the attribute

Parameters:

element - node

attributeName - attribute

Returns:

has attribute

getAttribute

public static java.lang.String getAttribute(org.w3c.dom.Node element,
                                            java.lang.String name)

Get the given name attribute from the given element. If the attribute is not found this will throw an IllegalArgumentException

Parameters:

element - The xml element to look within.

name - The attribute name.

Returns:

The value of the attribute.

ensureAttributes

public static void ensureAttributes(org.w3c.dom.Node element,
                                    java.lang.String[] attrs)

Make sure that the given element contains the given attributes. If the element does not contain all of the given attribute names then an IllegalArgumentException is thrown.

Parameters:

element - The xml element to look within.

attrs - Array of attribute names.

getAttribute

public static java.lang.String getAttribute(org.w3c.dom.Node element,
                                            java.lang.String name,
                                            java.lang.String dflt)

Get the given name-d attribute from the given element. If not found return the dflt argument.

Parameters:

element - The xml element to look within.

name - The attribute name.

dflt - The default value.

Returns:

The attribute value or the dflt if not found.

getAttribute

public static boolean getAttribute(org.w3c.dom.Node element,
                                   java.lang.String name,
                                   boolean dflt)

Get the given name-d attribute from the given element. Convert it into a boolean. If not found return the dflt argument.

Parameters:

element - The xml element to look within.

name - The attribute name.

dflt - The default value.

Returns:

The boolean attribute value or the dflt if not found.

getAttribute

public static int getAttribute(org.w3c.dom.Node element,
                               java.lang.String name,
                               int dflt)

Get the given name-d attribute from the given element. Convert it into an int. If not found return the dflt argument.

Parameters:

element - The xml element to look within.

name - The attribute name.

dflt - The default value.

Returns:

The int attribute value or the dflt if not found.

getAttribute

public static float getAttribute(org.w3c.dom.Node element,
                                 java.lang.String name,
                                 float dflt)

Get the given name-d attribute from the given element. Convert it into a float. If not found return the dflt argument.

Parameters:

element - The xml element to look within.

name - The attribute name.

dflt - The default value.

Returns:

The float attribute value or the dflt if not found.

getAttribute

public static double getAttribute(org.w3c.dom.Node element,
                                  java.lang.String name,
                                  double dflt)

Get the given name-d attribute from the given element. Convert it into a double. If not found return the dflt argument.

Parameters:

element - The xml element to look within.

name - The attribute name.

dflt - The default value.

Returns:

The double attribute value or the dflt if not found.

getAttribute

public static java.awt.Color getAttribute(org.w3c.dom.Node element,
                                          java.lang.String name,
                                          java.awt.Color dflt)

Get the given name-d attribute from the given element. Convert it into a Color. If not found return the dflt argument.

Parameters:

element - The xml element to look within.

name - The attribute name.

dflt - The default value.

Returns:

The Color attribute value or the dflt if not found.

getAttribute

public static java.lang.String getAttribute(org.w3c.dom.NamedNodeMap attrs,
                                            java.lang.String name)

Get the given name-d attribute from the given attrs map. If not found then throw an IllegalArgumentException.

Parameters:

attrs - The xml attribute map.

name - The name of the attribute.

Returns:

The attribute value.

getAttribute

public static java.lang.String getAttribute(org.w3c.dom.NamedNodeMap attrs,
                                            java.lang.String name,
                                            java.lang.String dflt)

Get the given name-d attribute from the given attrs map. If not found then return the dflt argument.

Parameters:

attrs - The xml attribute map.

name - The name of the attribute.

dflt - The default value

Returns:

The attribute valueif found, else the dflt argument.

getAttribute

public static int getAttribute(org.w3c.dom.NamedNodeMap attrs,
                               java.lang.String name,
                               int dflt)

Get the given name-d attribute from the given attrs map. If found convert it to int. If not found then return the dflt argument.

Parameters:

attrs - The xml attribute map.

name - The name of the attribute.

dflt - The default value

Returns:

The attribute valueif found, else the dflt argument.

getAttribute

public static float getAttribute(org.w3c.dom.NamedNodeMap attrs,
                                 java.lang.String name,
                                 float dflt)

Get the given name-d attribute from the given attrs map. If found convert it to float. If not found then return the dflt argument.

Parameters:

attrs - The xml attribute map.

name - The name of the attribute.

dflt - The default value

Returns:

The attribute valueif found, else the dflt argument.

getAttribute

public static double getAttribute(org.w3c.dom.NamedNodeMap attrs,
                                  java.lang.String name,
                                  double dflt)

Get the given name-d attribute from the given attrs map. If found convert it to double. If not found then return the dflt argument.

Parameters:

attrs - The xml attribute map.

name - The name of the attribute.

dflt - The default value

Returns:

The attribute valueif found, else the dflt argument.

getAttribute

public static boolean getAttribute(org.w3c.dom.NamedNodeMap attrs,
                                   java.lang.String name,
                                   boolean dflt)

Get the given name-d attribute from the given attrs map. If found convert it to boolean. If not found then return the dflt argument.

Parameters:

attrs - The xml attribute map.

name - The name of the attribute.

dflt - The default value

Returns:

The attribute valueif found, else the dflt argument.

getAttribute

public static java.awt.Color getAttribute(org.w3c.dom.NamedNodeMap attrs,
                                          java.lang.String name,
                                          java.awt.Color dflt)

Get the given name-d attribute from the given attrs map. If found convert it to Color (GuiUtils.decodeColor(java.lang.String, java.awt.Color)). If not found then return the dflt argument.

Parameters:

attrs - The xml attribute map.

name - The name of the attribute.

dflt - The default value

Returns:

The attribute valueif found, else the dflt argument.

setAttribute

public static void setAttribute(org.w3c.dom.Element node,
                                java.lang.String name,
                                java.awt.Color value)

A utility to set the attribute on the given node as the String representation of the given color

Parameters:

node - The node

name - The attr name

value - The color

mergeAttributes

public static void mergeAttributes(org.w3c.dom.Element n1,
                                   org.w3c.dom.Element n2)

Copy the attributes from n2 to n1.

Parameters:

n1 - The source of the attributes.

n2 - What to copy into.

setAttributes

public static void setAttributes(org.w3c.dom.Element node,
                                 java.lang.String[] attrs)

The attrs parameter is an array of [name1, value1, name2, value2, etc]. Set these attributes on the given node.

Parameters:

node - The xml element to set attributes on.

attrs - The array of attribute name/value pairs.

findChild

public static org.w3c.dom.Element findChild(org.w3c.dom.Node parent,
                                            java.lang.String tag)

Find the first child element of the given parent Node whose tag name.equals the given tag. Return null if not found.

Parameters:

parent - The xml node to search for children.

tag - The tag name of the child xml element.

Returns:

The child found or null if not found.

findChildrenRecurseUp

public static java.util.List findChildrenRecurseUp(org.w3c.dom.Node parent,
                                                   java.lang.String tag)

Find all of the children elements of the given parent Node and all of its ancestors whose tag name.equals the given tag.

Parameters:

parent - The xml node to search for children.

tag - The tag name of the child xml element.

Returns:

The List of children

findChildRecurseUp

public static org.w3c.dom.Element findChildRecurseUp(org.w3c.dom.Node parent,
                                                     java.lang.String tag)

Find the first child element of the given parent Node whose tag name.equals the given tag. If not found then recursively search up the ancestors of the parent.

Parameters:

parent - The xml node to search for children.

tag - The tag name of the child xml element.

Returns:

The child found or null if not found.

findChildren

public static java.util.List findChildren(org.w3c.dom.Node parent,
                                          java.lang.String tag)

Find all of the children elements of the given parent Node whose tag name.equals the given tag. Return an empty list if none found.

Parameters:

parent - The xml node to search for children.

tag - The tag name of the child xml element.

Returns:

The list of children that match the given tag name.

addChildren

public static void addChildren(org.w3c.dom.Element element,
                               java.util.List children)

Append the given list of children Elements to the given Element.

Parameters:

element - The parent element.

children - The list of children.

findDescendant

public static org.w3c.dom.Element findDescendant(org.w3c.dom.Node parent,
                                                 java.lang.String tag)

Find the first descendant element of the given parent Node whose tag name.equals the given tag.

Parameters:

parent - The root of the xml dom tree to search.

tag - The tag name to match.

Returns:

The element foudn or null

findDescendants

public static java.util.List findDescendants(org.w3c.dom.Node parent,
                                             java.lang.String tag)

Find all of the descendant elements of the given parent Node whose tag name.equals the given tag.

Parameters:

parent - The root of the xml dom tree to search.

tag - The tag name to match.

Returns:

The list of descendants that match the given tag.

findDescendantFromPath

public static org.w3c.dom.Element findDescendantFromPath(org.w3c.dom.Element parent,
                                                         java.lang.String path)

This method searches, starting at the given parent, for a descendant path. The path is defined by the "." delimited path string. Each token in the path is a tag name.

So, given:

path=Alabama.Alaska.Arkansas

this method will try to find the Arkansas tag which is a child of Alaska, which is a child of Alabama, which is a child of the given parent parameter.

Parameters:

parent - The root of the xml dom tree to search.

path - The "." delimited string of tag names.

Returns:

The list of descendants that are under the given path.

findDescendantsFromPath

public static java.util.List findDescendantsFromPath(org.w3c.dom.Element parent,
                                                     java.lang.String path)

Like findDescendantFromPath, this method finds all descendants.

Parameters:

parent - The root of the xml dom tree to search.

path - The "." delimited string of tag names.

Returns:

The list of descendants that are under the given path.

getRoot

public static org.w3c.dom.Element getRoot(java.lang.String xml)
                                   throws java.lang.Exception

Parse the given xml and return the root Element.

Parameters:

xml - The xml.

Returns:

The root of the xml dom.

Throws:

java.lang.Exception - When something goes wrong.

create

public static org.w3c.dom.Element create(java.lang.String tag,
                                         org.w3c.dom.Element parent)
                                  throws java.lang.Exception

_more_

Parameters:

tag - _more_

parent - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(java.lang.String tag,
                                         org.w3c.dom.Element parent,
                                         java.util.List attrs)
                                  throws java.lang.Exception

_more_

Parameters:

tag - _more_

parent - _more_

attrs - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(org.w3c.dom.Document doc,
                                         java.lang.String tag)
                                  throws java.lang.Exception

_more_

Parameters:

doc - _more_

tag - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(org.w3c.dom.Document doc,
                                         java.lang.String tag,
                                         org.w3c.dom.Element parent)
                                  throws java.lang.Exception

_more_

Parameters:

doc - _more_

tag - _more_

parent - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(org.w3c.dom.Document doc,
                                         java.lang.String tag,
                                         org.w3c.dom.Element parent,
                                         java.util.List attrs)
                                  throws java.lang.Exception

_more_

Parameters:

doc - _more_

tag - _more_

parent - _more_

attrs - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(org.w3c.dom.Document doc,
                                         java.lang.String tag,
                                         java.lang.String[] attrs)
                                  throws java.lang.Exception

_more_

Parameters:

doc - _more_

tag - _more_

attrs - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(org.w3c.dom.Document doc,
                                         java.lang.String tag,
                                         org.w3c.dom.Element parent,
                                         java.lang.String[] attrs)
                                  throws java.lang.Exception

_more_

Parameters:

doc - _more_

tag - _more_

parent - _more_

attrs - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(org.w3c.dom.Document doc,
                                         java.lang.String tag,
                                         org.w3c.dom.Element parent,
                                         java.lang.String text,
                                         java.lang.String[] attrs)
                                  throws java.lang.Exception

_more_

Parameters:

doc - _more_

tag - _more_

parent - _more_

text - _more_

attrs - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(org.w3c.dom.Document doc,
                                         java.lang.String tag,
                                         org.w3c.dom.Element parent,
                                         java.lang.String text)
                                  throws java.lang.Exception

_more_

Parameters:

doc - _more_

tag - _more_

parent - _more_

text - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(java.lang.String tag,
                                         org.w3c.dom.Element parent,
                                         java.lang.String[] attrs)
                                  throws java.lang.Exception

_more_

Parameters:

tag - _more_

parent - _more_

attrs - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(java.lang.String tag,
                                         org.w3c.dom.Element parent,
                                         java.lang.String text,
                                         java.lang.String[] attrs)
                                  throws java.lang.Exception

_more_

Parameters:

tag - _more_

parent - _more_

text - _more_

attrs - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

create

public static org.w3c.dom.Element create(java.lang.String tag,
                                         org.w3c.dom.Element parent,
                                         java.lang.String text)
                                  throws java.lang.Exception

_more_

Parameters:

tag - _more_

parent - _more_

text - _more_

Returns:

_more_

Throws:

java.lang.Exception - _more_

getRoot

public static org.w3c.dom.Element getRoot(java.lang.String filename,
                                          java.lang.Class originClass)
                                   throws java.lang.Exception

Read in the xml contained in the given filename, parse it and return the root Element. If the filename cannot be found then return null

Parameters:

filename - The filename, url or resource path of the xml document.

originClass - Where to look for resources.

Returns:

The root of the xml dom.

Throws:

java.lang.Exception - When something goes wrong.

getRoot

public static org.w3c.dom.Element getRoot(java.io.InputStream stream)
                                   throws java.lang.Exception

Read in the xml contained in the given filename, parse it and return the root Element.

Parameters:

stream - _more_

Returns:

The root of the xml dom.

Throws:

java.lang.Exception - When something goes wrong.

getDocument

public static org.w3c.dom.Document getDocument(java.lang.String filename,
                                               java.lang.Class originClass)
                                        throws java.lang.Exception

Read in the xml contained in the given filename, parse it and return the root Element.

Parameters:

filename - The filename, url or resource path of the xml document.

originClass - Where to look for resources.

Returns:

The root of the xml dom.

Throws:

java.lang.Exception - When something goes wrong.

findRoot

public static org.w3c.dom.Element findRoot(org.w3c.dom.Element child)

Find the root element of the given node.

Parameters:

child - The xml element to serach for the root of.

Returns:

The root of the DOM tree that the given child exists in.

isTag

public static boolean isTag(org.w3c.dom.Node node,
                            java.lang.String name)

Checks if the tag name of the given node matches the given name. If the given name is fully qualified (e.g., namespace:tagname) then check if it matches the full name of the node. If the node name is fully qualified and the name isn't then strip off the namespace of the node and compare else just compare the 2

Parameters:

node - the xml node

name - name

Returns:

is non qualified tag name the same

getLocalName

public static java.lang.String getLocalName(org.w3c.dom.Node element)

Get the non qualified tag name

Parameters:

element - element

Returns:

tag name

isFullyQualified

public static boolean isFullyQualified(java.lang.String tagName)

_more_

Parameters:

tagName - _more_

Returns:

_more_

getNodeName

public static java.lang.String getNodeName(org.w3c.dom.Node node)

Get the non qualified tag name

Parameters:

node - node

Returns:

node name

findAncestor

public static org.w3c.dom.Element findAncestor(org.w3c.dom.Element child,
                                               java.lang.String tagName)

Find the ancestor of the given node with the given tagname

Parameters:

child - The xml element to serach for the root of.

tagName - The tag name to look for

Returns:

The ancestor

makeDocument

public static org.w3c.dom.Document makeDocument()

A utility to make an empty document

Returns:

An empty document.

getDocument

public static org.w3c.dom.Document getDocument(java.lang.String xml)
                                        throws java.lang.Exception

Create a Document object with the given xml.

Parameters:

xml - The xml.

Returns:

A new Document.

Throws:

java.lang.Exception - When something goes wrong.

getDocument

public static org.w3c.dom.Document getDocument(java.io.InputStream stream)
                                        throws java.lang.Exception

Create a Document object with the given xml.

Parameters:

stream - stream

Returns:

A new Document.

Throws:

java.lang.Exception - When something goes wrong.

getFirstChild

public static org.w3c.dom.Element getFirstChild(org.w3c.dom.Element parent)

Get the first Element child of the given parent Element.

Parameters:

parent - The xml node to search its chidlren.

Returns:

The first child of the given node or null if there are none.

getElements

public static org.w3c.dom.NodeList getElements(org.w3c.dom.Element parent)

Get all children of the given parent Element who are instances of the Element class.

Parameters:

parent - The xml node to search its chidlren.

Returns:

All Element children of the given parent.

getElements

public static org.w3c.dom.NodeList getElements(org.w3c.dom.Element parent,
                                               XmlNodeList nodeList)

Get all children of the given parent Element who are instances of the Element class.

Parameters:

parent - The xml node to search its chidlren.

nodeList - list to add to

Returns:

All Element children of the given parent.

getGrandChildren

public static org.w3c.dom.NodeList getGrandChildren(org.w3c.dom.Element parent)

Get all grand children of the given parent Element who are instances of the Element class.

Parameters:

parent - The xml node to search its chidlren.

Returns:

All Element children of the given parent.

getGrandChildText

public static java.lang.String getGrandChildText(org.w3c.dom.Node parent,
                                                 java.lang.String childTag,
                                                 java.lang.String dflt)

Finds the child node with the given tag name. Then gets the child text from that node if it is non-null.

Parameters:

parent - The xml node to search its chidlren.

childTag - _more_

dflt - _more_

Returns:

The text values contained by the children of the given parent.

getGrandChildValue

public static double getGrandChildValue(org.w3c.dom.Node parent,
                                        java.lang.String childTag,
                                        double dflt)

_more_

Parameters:

parent - _more_

childTag - _more_

dflt - _more_

Returns:

_more_

getGrandChildText

public static java.lang.String getGrandChildText(org.w3c.dom.Node parent,
                                                 java.lang.String childTag)

Finds the child node with the given tag name. Then gets the child text from that node if it is non-null.

Parameters:

parent - The xml node to search its chidlren.

childTag - _more_

Returns:

The text values contained by the children of the given parent.

appendCdataBytes

public static void appendCdataBytes(java.lang.StringBuffer sb,
                                    byte[] bytes)

_more_

Parameters:

sb - _more_

bytes - _more_

appendCdata

public static void appendCdata(java.lang.StringBuffer sb,
                               java.lang.String s)

_more_

Parameters:

sb - _more_

s - _more_

getCdata

public static java.lang.String getCdata(java.lang.String s)

_more_

Parameters:

s - _more_

Returns:

_more_

makeCDataNode

public static org.w3c.dom.CDATASection makeCDataNode(org.w3c.dom.Document doc,
                                                     java.lang.String text)

_more_

Parameters:

doc - _more_

text - _more_

Returns:

_more_

createCDataNode

public static void createCDataNode(org.w3c.dom.Element parent,
                                   java.lang.String text)

_more_

Parameters:

parent - _more_

text - _more_

makeCDataNode

public static org.w3c.dom.CDATASection makeCDataNode(org.w3c.dom.Document doc,
                                                     java.lang.String text,
                                                     boolean andEncode)

_more_

Parameters:

doc - _more_

text - _more_

andEncode - _more_

Returns:

_more_

getChildText

public static java.lang.String getChildText(org.w3c.dom.Node parent)

Concatenates the node values (grom getNodeValue) of the children of the given parent Node.

Parameters:

parent - The xml node to search its chidlren.

Returns:

The text values contained by the children of the given parent.

getElements

public static XmlNodeList getElements(org.w3c.dom.Element parent,
                                      java.lang.String tagName)

Get all Element children of the given parent Element with the given tagName.

Parameters:

parent - The xml node to search its children.

tagName - The tag to match.

Returns:

The Element children of the given parent node whose tags match the given tagName.

getElement

public static org.w3c.dom.Element getElement(org.w3c.dom.Element parent,
                                             java.lang.String tagName)

Get the first Element children of the given parent Element with the given tagName.

Parameters:

parent - The xml node to search its children.

tagName - The tag to match.

Returns:

The first Element child that matches the given tag name.

getListOfElements

public static java.util.List getListOfElements(org.w3c.dom.Element parent)

Create and return a List of the Element children of the given parent node.

Parameters:

parent - The xml node to find its children.

Returns:

List of children Elements.

getHeader

public static java.lang.String getHeader()

Return the default xml header.

Returns:

The default xml document header.

toString

public static java.lang.String toString(org.w3c.dom.Node node)

Convert the DOM rooted at the given Node to an xml String representation.

Parameters:

node - The xml node to convert its tree.

Returns:

The String representation of the node's tree.

toStringNoChildren

public static java.lang.String toStringNoChildren(org.w3c.dom.Node node)

Convert the DOM rooted at the given Node to an xml String representation.

Parameters:

node - The xml node to convert its tree.

Returns:

The String representation of the node's tree.

toStringWithHeader

public static java.lang.String toStringWithHeader(org.w3c.dom.Node node)

Convert the DOM rooted at the given Node to an xml String representation. Prepend the xml header.

Parameters:

node - The xml node to convert its tree.

Returns:

The String representation of the node's tree.

toString

public static java.lang.String toString(org.w3c.dom.Node node,
                                        boolean prettyPrint)

Convert the DOM rooted at the given Node to an xml String representation.

Parameters:

node - The xml node to convert its tree.

prettyPrint - Should the string be formatted with tabs and new lines

Returns:

The String representation of the node's tree.

toString

public static java.lang.String toString(org.w3c.dom.Node node,
                                        java.lang.String tabSpacing,
                                        java.lang.String newLine)

Convert the DOM rooted at the given Node to an xml representation. Use the given tabSpacing to include spacing within the hierarchy.

Parameters:

node - The xml tree root.

tabSpacing - The spacing to put into the result string before each tag.

newLine - The new line to output after each tag.

Returns:

The String representation of the node's tree.

toString

public static java.lang.String toString(org.w3c.dom.Node node,
                                        java.lang.String tabSpacing,
                                        java.lang.String newLine,
                                        boolean recurse)

Convert the DOM rooted at the given Node to an xml representation. Use the given tabSpacing to include spacing within the hierarchy.

Parameters:

node - The xml tree root.

tabSpacing - The spacing to put into the result string before each tag.

newLine - The new line to output after each tag.

recurse - _more_

Returns:

The String representation of the node's tree.

toStringWithHeader

public static java.lang.String toStringWithHeader(org.w3c.dom.Node node,
                                                  java.lang.String tabSpacing,
                                                  java.lang.String newLine)

Convert the DOM rooted at the given Node to an xml representation. Use the given tabSpacing to include spacing within the hierarchy. Prepend the xml header to the text.

Parameters:

node - The xml tree root.

tabSpacing - The spacing to put into the result string before each tag.

newLine - The new line to output after each tag.

Returns:

The String representation of the node's tree.

toString

public static void toString(org.w3c.dom.Node node,
                            java.lang.Appendable appendable)

_more_

Parameters:

node - _more_

appendable - _more_

toStringWithHeader

public static java.lang.String toStringWithHeader(org.w3c.dom.Node node,
                                                  java.lang.String tabSpacing,
                                                  java.lang.String newLine,
                                                  boolean prettifyAttrs)

Convert the xml to a string. Add the xml header

Parameters:

node - xml root

tabSpacing - tab

newLine - new line

prettifyAttrs - If true then layout attributes

Returns:

String representation of the given xml node

toHtml

public static void toHtml(java.lang.StringBuffer html,
                          org.w3c.dom.Node node)

_more_

Parameters:

html - _more_

node - _more_

encodeString

public static java.lang.String encodeString(java.lang.String v)

Do a simple conversion of special characters to their encoding.

Parameters:

v - The source string.

Returns:

The encoded String.

findElement

public static org.w3c.dom.Element findElement(org.w3c.dom.NodeList elements,
                                              java.lang.String attributeName,
                                              java.lang.String attributeValue)

Find the first Element in the given NodeList of Elements that has the given attribute with value .equals the given attributeValue.

Parameters:

elements - The Elements to search.

attributeName - The attribute name to look for.

attributeValue - The value to match.

Returns:

The Element in the elements list that has an attribute of the given name with the given value.

findElement

public static org.w3c.dom.Element findElement(org.w3c.dom.Element root,
                                              java.lang.String tag,
                                              java.lang.String attributeName,
                                              java.lang.String attributeValue)

Find the Element under (recursively) the given root Element with the given tag name (if non-null) that contains an attribute of the given name and value.

Parameters:

root - The Element to seatrch under.

tag - The tag name of the descendant Element to match.

attributeName - The attribute name to look for.

attributeValue - The value to match.

Returns:

The descendant Element that has an attribute of the given name with the given value.

removeChildren

public static void removeChildren(org.w3c.dom.Element parent)

Remove all children from the given parent Element.

Parameters:

parent - The xml element to remove children from.

findUrlRefNode

public static org.w3c.dom.Element findUrlRefNode(org.w3c.dom.Element node,
                                                 java.lang.String urlAttr)

This method will return either the given node argument if it does not contain an attribute of the given urlAttr. Or it will return the parsed document specified by the value of the urlAttr contained by node.

Parameters:

node - The node to look at.

urlAttr - The attribute name that holds the url.

Returns:

The root of the new document or the given node argument if no url ref found.

findUrlRefNode

public static org.w3c.dom.Element findUrlRefNode(org.w3c.dom.Element node)

This method will return either the given node argument if it does not contain an attribute of name "url". Or it will return the parsed document specified by the value of the urlAttr contained by node.

Parameters:

node - The node to look at.

Returns:

The root of the new document or the given node argument if no url ref found.

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

A main for tests

Parameters:

args - Command line arguments

Throws:

java.lang.Exception - _more_

calculateRFC2104HMAC

public static java.lang.String calculateRFC2104HMAC(java.lang.String data,
                                                    java.lang.String key)
                                             throws java.security.SignatureException

Computes RFC 2104-compliant HMAC signature.

Parameters:

data - The data to be signed.

key - The signing key.

Returns:

The base64-encoded RFC 2104-compliant HMAC signature.

Throws:

java.security.SignatureException - when signature generation fails

elements

public static XmlUtil.ElementListIterator elements(java.lang.String xmlFile,
                                                   java.lang.String xPath)

_more_

Parameters:

xmlFile - _more_

xPath - _more_

eval

public static org.w3c.dom.NodeList eval(java.lang.String xmlFile,
                                        java.lang.String xPath)

_more_

Parameters:

xmlFile - _more_

xPath - _more_

loadXml

public static org.w3c.dom.Document loadXml(java.lang.String xmlFile)

_more_

Parameters:

xmlFile - _more_

expr

public static javax.xml.xpath.XPathExpression expr(java.lang.String xPath)

_more_

Parameters:

xPath - _more_