This is the only package in the NanoXML library. This version has only two classes: XMLElement and XMLParseException. XMLElement represents an XML document and its content. XMLParseException is the exception that is thrown when a parse error occurs; for example, when a document that is not well-formed is encountered. Let's look at each of these classes in detail.

Class XMLElement
nanoxml

public class XMLElement

XMLElement is a representation of an XML document. In addition to being able to parse XML documents, this serializable class contains all the methods needed to get/set elements, subelements, attributes, and text in a document. It derives from java.lang.Object.

Constructors

public XMLElement()
public XMLElement(Properties conversionTable)
public XMLElement(boolean skipLeadingWhitespace)
public XMLElement(Properties conversionTable, 
boolean skipLeadingWhitespace)
public XMLElement(Properties conversionTable, 
boolean skipLeadingWhitespace, 
boolean ignoreCase)

The XMLElement constructor can only take a few different arguments. Each constructor makes use of a conversion table. A conversion table is simply a Properties object, which is used to map entities to their conversion values. When an entity is found in a parsed document, it is used as a key into the Properties object to find the replacement value.

The default constructor creates a new XMLElement object with a Properties map that converts the following predefined entities:

Arguments	Type	Effect
string	String	XML source content is contained within a string
reader	java.io. Reader	XML source content is contained within a java.io.Reader
chrAry	char[]	XML source content is contained within a character array
offset	int	Marks where parsing should begin, counting from the first character
End	int	Marks where parsing should end
startingLineNr	int	Marks from which line the parser should begin parsing

Usage and Examples

To direct NanoXML to parse an XML file, we would write code like this:

BufferedReader br = null;
try {
br = new BufferedReader(new
FileReader("request.xml"));
}
catch (java.io.FileNotFoundException e) {
e.printStackTrace();
System.exit(0);
}
XMLElement elem = new XMLElement();
try {
elem.parseFromReader(br);
}
catch (java.io.IOException e) { 
e.printStackTrace();
}