tauzaman
Class XMLParser

java.lang.Object
  |
  +--tauzaman.XMLParser

public class XMLParser

extends java.lang.Object

XMLParser class parses a given url, which contains an XML file, and returns the root of resulting DOM. It uses DOM to parse the xml file. The classes, which utilize this class are;

• CalendricSystem
• Calendar
• Property
• FVTable

This class is basically an XML DOM Parser.

See Also:

CalendricSystem, Calendar, Property, FVTable

Status:

design complete, implementation complete

Field Summary

private javax.xml.parsers.DocumentBuilderFactory

factory

Constructor Summary

XMLParser()
Constructs an XMLParser object, which parses an xml file, which given url points to.

Method Summary

java.lang.String	getElementContent(org.w3c.dom.Element e) Returns content of a DOM Element node as a string.
java.util.Vector	locator(org.w3c.dom.Element parent, java.lang.String name) Locator.
org.w3c.dom.Element	parseFragment(java.lang.String source) Parses a given String XML fragment.
org.w3c.dom.Element	parseURL(java.net.URL url) Parses a given URL, which points to an xml file.

Methods inherited from class java.lang.Object

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

Field Detail

factory

private javax.xml.parsers.DocumentBuilderFactory factory

Constructor Detail

XMLParser

public XMLParser()

Constructs an XMLParser object, which parses an xml file, which given url points to.

Method Detail

parseURL

public org.w3c.dom.Element parseURL(java.net.URL url)
                             throws XMLParseException

Parses a given URL, which points to an xml file. Higher level exceptions will be handled in callees.

Parameters:

url - URL , which points to an xml file to be parsed

Returns:

a DOM Element object, which is the root element of parsed xml file

Throws:

XMLParseException - if any abnormal condition occurs when forming a DOM object

parseFragment

public org.w3c.dom.Element parseFragment(java.lang.String source)
                                  throws XMLParseException

Parses a given String XML fragment. Higher level exceptions will be handled in callees.

Parameters:

source - String XML fragment to be parsed

Returns:

a DOM Element object, which is the root element of parsed xml file

Throws:

XMLParseException - if any abnormal condition occurs when forming a DOM object

locator

public java.util.Vector locator(org.w3c.dom.Element parent,
                                java.lang.String name)

Locator. This method takes an element and returns all its "children" elements having given name as a Vector.

getElementContent

public java.lang.String getElementContent(org.w3c.dom.Element e)

Returns content of a DOM Element node as a string. It recursively traverses, Element, Text and Attributes and prints them as xml string.

Parameters:

e - Element, whose content will be returned

Returns:

a String, which represents recursive content of an Element