com.infoengine.object
Class XML2IeObject

java.lang.Object
  com.infoengine.object.XML2IeObject

All Implemented Interfaces:

DocumentHandler, DTDHandler, ErrorHandler, I_readIeObjectXML

public class XML2IeObject

extends Object

implements I_readIeObjectXML

Event handler class for SAX.

This handler simply reports all of the events that it receives. It is useful for testing and comparing SAX implementations, and for teaching or learning about SAX. This is also a demonstration of how one class can implement all four handler interfaces.

See Also:

EntityResolver, DTDHandler, DocumentHandler, ErrorHandler

Field Summary

private IeObject	answer
static String	ATT_TAG
private static int	ATTR
private Hashtable	attValues
static String	COLLECTION_TAG
private static int	DATUM
static String	DATUM_TAG Print a message for the start of an element.
private boolean	datumStarted
private boolean	DEBUG
private int	foundErrorLevel
static String	GROUP_TAG
static String	KEY_TAG
private int	lastObject
private static int	META
static String	META_TAG
private String	metaName
private static int	NA
static String	NC_TAG
private static int	NODE
static String	NODE_TAG
private Stack	objectStack
static String	REQUEST_TAG
private StringBuffer	returnData
private Stack	typeStack
static String	VALUE_TAG

Fields inherited from interface com.infoengine.object.I_readIeObjectXML

PARSE_CRITICAL_ERROR, PARSE_OK, PARSE_RECOVERABLE_ERROR, PARSE_WARNING

Constructor Summary

XML2IeObject()

Method Summary

void	characters(char[] ch, int start, int length) Print a message for character data.
private static void	display(String prefix, char[] ch, int start, int length) Display text, escaping some characters.
void	endDocument() Print a message for the end of the document.
void	endElement(String name) Print a message for the end of an element.
void	error(SAXParseException exception) Report all recoverable errors, and try to continue parsing.
void	fatalError(SAXParseException exception) Report all fatal errors, and try to continue parsing.
String	getElementKey(AttributeList atlist)
String	getElementName(AttributeList atlist) Fish through the passed AttributeList and find the 'NAME' attribute, and return it.
String	getElementType(AttributeList atlist)
String	getElementValue(AttributeList atlist)
int	getErrorLevel()
String	getErrorMessage()
IeObject	getIeObject()
IeObject	getOutput()
void	ignorableWhitespace(char[] ch, int start, int length) Print a message for ignorable whitespace.
void	notationDecl(String name, String publicId, String systemId) Display notation declarations as they are reported.
void	processingInstruction(String target, String data) Print a message for a processing instruction.
void	setDocumentLocator(Locator locator) Print a message when the parser provides a locator.
void	startDocument() Print a message at the start of the document.
void	startElement(String name, AttributeList attributes)
void	unparsedEntityDecl(String name, String publicId, String systemId, String notationName) Display unparsed entity declarations as they are reported.
void	warning(SAXParseException exception) Report all warnings, and continue parsing.

Methods inherited from class java.lang.Object

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

Field Detail

answer

private IeObject answer

attValues

private Hashtable attValues

datumStarted

private boolean datumStarted

metaName

private String metaName

objectStack

private Stack objectStack

typeStack

private Stack typeStack

returnData

private StringBuffer returnData

NODE

private static final int NODE

See Also:

Constant Field Values

META

private static final int META

See Also:

Constant Field Values

ATTR

private static final int ATTR

See Also:

Constant Field Values

DATUM

private static final int DATUM

See Also:

Constant Field Values

NA

private static final int NA

See Also:

Constant Field Values

lastObject

private int lastObject

foundErrorLevel

private int foundErrorLevel

DEBUG

private boolean DEBUG

DATUM_TAG

public static final String DATUM_TAG

Print a message for the start of an element.

Display all attributes on separate lines, indented.

See Also:

DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList), Constant Field Values

META_TAG

public static final String META_TAG

See Also:

Constant Field Values

REQUEST_TAG

public static final String REQUEST_TAG

See Also:

Constant Field Values

COLLECTION_TAG

public static final String COLLECTION_TAG

See Also:

Constant Field Values

GROUP_TAG

public static final String GROUP_TAG

See Also:

Constant Field Values

NODE_TAG

public static final String NODE_TAG

See Also:

Constant Field Values

ATT_TAG

public static final String ATT_TAG

See Also:

Constant Field Values

NC_TAG

public static final String NC_TAG

See Also:

Constant Field Values

KEY_TAG

public static final String KEY_TAG

See Also:

Constant Field Values

VALUE_TAG

public static final String VALUE_TAG

See Also:

Constant Field Values

Constructor Detail

XML2IeObject

public XML2IeObject()

Method Detail

notationDecl

public void notationDecl(String name,
                         String publicId,
                         String systemId)

Display notation declarations as they are reported.

Specified by:

notationDecl in interface DTDHandler

See Also:

DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)

unparsedEntityDecl

public void unparsedEntityDecl(String name,
                               String publicId,
                               String systemId,
                               String notationName)

Display unparsed entity declarations as they are reported.

Specified by:

unparsedEntityDecl in interface DTDHandler

See Also:

DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

getOutput

public IeObject getOutput()

Specified by:

getOutput in interface I_readIeObjectXML

getErrorLevel

public int getErrorLevel()

Specified by:

getErrorLevel in interface I_readIeObjectXML

getErrorMessage

public String getErrorMessage()

setDocumentLocator

public void setDocumentLocator(Locator locator)

Print a message when the parser provides a locator.

Not all SAX parsers will provide a locator object.

Specified by:

setDocumentLocator in interface DocumentHandler

See Also:

DocumentHandler.setDocumentLocator(org.xml.sax.Locator)

startDocument

public void startDocument()

Print a message at the start of the document.

Specified by:

startDocument in interface DocumentHandler

See Also:

DocumentHandler.startDocument()

endDocument

public void endDocument()

Print a message for the end of the document.

Specified by:

endDocument in interface DocumentHandler

See Also:

DocumentHandler.endDocument()

getIeObject

public IeObject getIeObject()

startElement

public void startElement(String name,
                         AttributeList attributes)

Specified by:

startElement in interface DocumentHandler

endElement

public void endElement(String name)

Print a message for the end of an element.

Specified by:

endElement in interface DocumentHandler

See Also:

DocumentHandler.endElement(java.lang.String)

characters

public void characters(char[] ch,
                       int start,
                       int length)

Print a message for character data.

Specified by:

characters in interface DocumentHandler

See Also:

DocumentHandler.characters(char[], int, int)

getElementName

public String getElementName(AttributeList atlist)

Fish through the passed AttributeList and find the 'NAME' attribute, and return it.

getElementValue

public String getElementValue(AttributeList atlist)

getElementKey

public String getElementKey(AttributeList atlist)

getElementType

public String getElementType(AttributeList atlist)

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)

Print a message for ignorable whitespace.

Specified by:

ignorableWhitespace in interface DocumentHandler

See Also:

DocumentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

public void processingInstruction(String target,
                                  String data)

Print a message for a processing instruction.

Specified by:

processingInstruction in interface DocumentHandler

See Also:

DocumentHandler.processingInstruction(java.lang.String, java.lang.String)

warning

public void warning(SAXParseException exception)

Report all warnings, and continue parsing.

Specified by:

warning in interface ErrorHandler

See Also:

ErrorHandler.warning(org.xml.sax.SAXParseException)

error

public void error(SAXParseException exception)

Report all recoverable errors, and try to continue parsing.

Specified by:

error in interface ErrorHandler

See Also:

ErrorHandler.error(org.xml.sax.SAXParseException)

fatalError

public void fatalError(SAXParseException exception)

Report all fatal errors, and try to continue parsing.

Note: results are no longer reliable once a fatal error has been reported.

Specified by:

fatalError in interface ErrorHandler

See Also:

ErrorHandler.fatalError(org.xml.sax.SAXParseException)

display

private static void display(String prefix,
                            char[] ch,
                            int start,
                            int length)

Display text, escaping some characters.