com.hfg.xml

Class XMLUtil

java.lang.Object

com.hfg.xml.XMLUtil

public class XMLUtil
extends Object

Helper class with static methods for XML tag constrution and some parser helper methods.

Field Summary

Fields

Modifier and Type	Field and Description
static String	BASE64
static String	COMPRESSION_ATT
static boolean	EMPTY_TAG Constant which can be used with composeStartTag().
static String	ENCODING_ATT
static String	GZIP
static boolean	NOT_EMPTY_TAG Constant which can be used with composeStartTag().
static Pattern	sEntityPattern2

Constructor Summary

Constructors

Constructor and Description
XMLUtil()

Method Summary

Modifier and Type	Method and Description
static void	checkXMLNameValidity(String inValue) Is the tag or element name valid?
static String	composeEndTag(String inName) Composes an xml end tag (ex: "</inName>").
static String	composeStartTag(String inName) Composes an xml start tag (ex: "<inName>").
static String	composeStartTag(String inName, Attributes inAttributes) Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>").
static String	composeStartTag(String inName, Attributes inAttributes, boolean isEmptyTag) Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>").
static String	composeStartTag(String inName, Collection<XMLAttribute> inAttributes) Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>").
static String	composeStartTag(String inName, Collection<XMLAttribute> inAttributes, boolean isEmptyTag) Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>").
static String	composeStartTag(String inName, Map<String,Object> inAttributes) Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>").
static String	composeStartTag(String inName, Map<String,Object> inAttributes, boolean isEmptyTag) Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>").
static String	convertCharacterEntitiesToNumeric(String inContent)
static String	convertCharacterEntitiesToUnicode(String inContent)
static String	escapeAmp(String inAttributeValue)
static String	escapeApos(String inAttributeValue)
static String	escapeAttributeValue(String inAttributeValue)
static String	escapeContent(String inContent)
static String	escapeContentIfNecessary(String inContent) Makes the content XML safe by ensuring that all '<'s are all escaped and that all '&'s are part of an entity.
static String	escapeDoubleQuotedAttributeValue(String inAttributeValue)
static String	escapeQuote(String inAttributeValue)
static List<XMLNode>	findNodesByAttribute(XMLNode inRootNode, String inAttribute)
static List<XMLNode>	findNodesByAttribute(XMLNode inRootNode, XMLAttribute inAttribute)
static boolean	isWellFormedContentFragment(String inXML) Returns whether or not the content fragment is well-formed and if tags are present internal to the fragment, whether the tag section and preceding or trailing raw content is well-formed.
static boolean	isWellFormedFragment(String inXML)
static String	replaceUnicodeWithEntities(String inString)
static String	unescapeAttributeValue(String inAttributeValue)
static String	unescapeContent(String inContent)
static String	unescapeEntities(String inValue)
static void	useDoubleQuotes(boolean inValue) Set whether to use double quotes or single quotes for attribute values.

Methods inherited from class java.lang.Object

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

Field Detail

COMPRESSION_ATT

public static final String COMPRESSION_ATT

See Also:

Constant Field Values

GZIP

public static final String GZIP

See Also:

Constant Field Values

ENCODING_ATT

public static final String ENCODING_ATT

See Also:

Constant Field Values

BASE64

public static final String BASE64

See Also:

Constant Field Values

EMPTY_TAG

public static final boolean EMPTY_TAG

Constant which can be used with composeStartTag().

See Also:

Constant Field Values

NOT_EMPTY_TAG

public static final boolean NOT_EMPTY_TAG

Constant which can be used with composeStartTag().

See Also:

Constant Field Values

sEntityPattern2

public static Pattern sEntityPattern2

Constructor Detail

XMLUtil

public XMLUtil()

Method Detail

useDoubleQuotes

public static void useDoubleQuotes(boolean inValue)

Set whether to use double quotes or single quotes for attribute values. Single quotes are used by default.

composeStartTag

public static String composeStartTag(String inName)

Composes an xml start tag (ex: "<inName>").

composeStartTag

public static String composeStartTag(String inName,
                                     Attributes inAttributes)

Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>"). Attributes appear in alphabetical order for consistency.

composeStartTag

public static String composeStartTag(String inName,
                                     Attributes inAttributes,
                                     boolean isEmptyTag)

Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>"). Attributes appear in alphabetical order for consistency.

composeStartTag

public static String composeStartTag(String inName,
                                     Collection<XMLAttribute> inAttributes)

Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>"). Attributes appear in alphabetical order for consistency.

composeStartTag

public static String composeStartTag(String inName,
                                     Collection<XMLAttribute> inAttributes,
                                     boolean isEmptyTag)

Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>"). If the isEmptyTag parameter is true, the output tag will end with "/>". ex: "<inName att1='value1' att2='value2'/>". Attributes appear in alphabetical order for consistency.

Parameters:

inName - the tag name

inAttributes - a List of XMLAttribute objects

isEmptyTag - whether or not the tag has any content or subtags

composeStartTag

public static String composeStartTag(String inName,
                                     Map<String,Object> inAttributes)

Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>"). Attributes appear in alphabetical order for consistency.

composeStartTag

public static String composeStartTag(String inName,
                                     Map<String,Object> inAttributes,
                                     boolean isEmptyTag)

Composes an xml start tag (ex: "<inName att1='value1' att2='value2'>"). If the isEmptyTag parameter is true, the output tag will end with "/>". ex: "<inName att1='value1' att2='value2'/>". Attributes appear in alphabetical order for consistency.

composeEndTag

public static String composeEndTag(String inName)

Composes an xml end tag (ex: "</inName>").

isWellFormedFragment

public static boolean isWellFormedFragment(String inXML)

isWellFormedContentFragment

public static boolean isWellFormedContentFragment(String inXML)

Returns whether or not the content fragment is well-formed and if tags are present internal to the fragment, whether the tag section and preceding or trailing raw content is well-formed.

    Examples of valid content fragments:  '<foo />', 'foo &amp; bar', 'foo', 'foo <bar>1</bar> one'
    Examples of invalid content fragments:  '<foo>', 'foo & bar', 'foo <bar>1</zoot> one'
    

convertCharacterEntitiesToNumeric

public static String convertCharacterEntitiesToNumeric(String inContent)

convertCharacterEntitiesToUnicode

public static String convertCharacterEntitiesToUnicode(String inContent)

escapeContentIfNecessary

public static String escapeContentIfNecessary(String inContent)

Makes the content XML safe by ensuring that all '<'s are all escaped and that all '&'s are part of an entity. Avoids double escaping.

Parameters:

inContent -

Returns:

XML-safe content string

escapeContent

public static String escapeContent(String inContent)

unescapeContent

public static String unescapeContent(String inContent)

escapeAttributeValue

public static String escapeAttributeValue(String inAttributeValue)

unescapeAttributeValue

public static String unescapeAttributeValue(String inAttributeValue)

escapeApos

public static String escapeApos(String inAttributeValue)

escapeQuote

public static String escapeQuote(String inAttributeValue)

escapeAmp

public static String escapeAmp(String inAttributeValue)

unescapeEntities

public static String unescapeEntities(String inValue)

checkXMLNameValidity

public static void checkXMLNameValidity(String inValue)
                                 throws com.hfg.xml.InvalidXMLNameException

Is the tag or element name valid?

Throws:

com.hfg.xml.InvalidXMLNameException

findNodesByAttribute

public static List<XMLNode> findNodesByAttribute(XMLNode inRootNode,
                                                 XMLAttribute inAttribute)

findNodesByAttribute

public static List<XMLNode> findNodesByAttribute(XMLNode inRootNode,
                                                 String inAttribute)

escapeDoubleQuotedAttributeValue

public static String escapeDoubleQuotedAttributeValue(String inAttributeValue)

replaceUnicodeWithEntities

public static String replaceUnicodeWithEntities(String inString)