de.uni_hildesheim.sse.monitoring.runtime.utils.xml

Class QdParser

java.lang.Object

de.uni_hildesheim.sse.monitoring.runtime.utils.xml.QdParser

public class QdParser
extends java.lang.Object

A Quick and Dirty XML parser. This class is not thread-safe. Use this class as follows: Reader reader = new FileReader(...); XmlQdParser parser = new XmlQdParser(); parser.parse(handler, reader, false); for informing handler about XML events in the file represented by reader and to avoid messages on XML text nodes (false as last parameter of parse).

Since:

1.00

Version:

1.00

Author:

Nicolas De Loof (taken from http://www.koders.com/java), Holger Eichelberger (adapted to this project)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	QdParser.Mode Defines some parsing modes (to be stored into the mode stack, avoids additional Integer objects).

Field Summary

Fields

Modifier and Type	Field and Description
private HashMap<java.lang.String,java.lang.String>	attrs Stores current element attributes.
private int	col Stores the column position within line in the document.
private int	depth Depth in nested XML elements.
private boolean	eol End of line?
private java.lang.StringBuilder	etag Stores the current end tag name.
private int	line Stores the line position in the document.
private java.lang.String	lvalue Stores the left value of an XML attribute.
private QdParser.Mode	mode Parsing mode.
private int	quotec Quote char (" or ').
private java.lang.String	rvalue Stores the right value of an XML attribute.
private java.lang.StringBuilder	sb Stores the current element being parsed.
private Stack<QdParser.Mode>	st Parsed elements stack.
private java.lang.String	tagName Stores the current tag name.

Constructor Summary

Constructors

Constructor and Description
QdParser()

Method Summary

Modifier and Type	Method and Description
private void	attributeEquals(int ch) "=" between attribute name and quoted value.
private void	attributeName(int ch) Part of the attribute name.
private void	attributeValue(int ch) Part of the attribute value.
private void	beforeRoot(int ch) Before parsing the XML root element.
private void	cdataSection(DocHandler doc, int ch) Inside a [CDATA] section.
private void	closeTag(DocHandler doc, int ch) XML Element closing tag.
private void	comment(int ch) XML comment.
private void	doctype(int ch) XML Doctype.
private void	entityRef(int ch) Reference to an XML Entity.
private void	exc(java.lang.String msg) Throws an exception with parse location.
static void	main(java.lang.String[] args) Just testing.
private void	openTag(DocHandler doc, int ch) Inside an open tag (XML element started).
void	parse(DocHandler doc, java.io.InputStream in, boolean notifyText) Parse a document.
void	parse(DocHandler doc, java.io.Reader reader, boolean notifyText) Parse a document.
private static QdParser.Mode	popMode(Stack<QdParser.Mode> st) Pop element from stack.
private void	quotedValue(int ch) Part of a quoted value.
private void	startTag(int ch) XML Element start tag.
private void	tagContent(DocHandler doc, int ch) Content off an XML element.
private void	textNode(DocHandler doc, int ch, boolean notify) Text node.

Methods inherited from class java.lang.Object

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

Field Detail

st

private Stack<QdParser.Mode> st

Parsed elements stack.

depth

private int depth

Depth in nested XML elements.

mode

private QdParser.Mode mode

Parsing mode.

quotec

private int quotec

Quote char (" or ').

line

private int line

Stores the line position in the document.

col

private int col

Stores the column position within line in the document.

eol

private boolean eol

End of line?

sb

private java.lang.StringBuilder sb

Stores the current element being parsed.

etag

private java.lang.StringBuilder etag

Stores the current end tag name.

tagName

private java.lang.String tagName

Stores the current tag name.

lvalue

private java.lang.String lvalue

Stores the left value of an XML attribute.

rvalue

private java.lang.String rvalue

Stores the right value of an XML attribute.

attrs

private HashMap<java.lang.String,java.lang.String> attrs

Stores current element attributes.

Constructor Detail

QdParser

public QdParser()

Method Detail

popMode

private static QdParser.Mode popMode(Stack<QdParser.Mode> st)

Pop element from stack.

Parameters:

st - stack

Returns:

element type

parse

public void parse(DocHandler doc,
                  java.io.InputStream in,
                  boolean notifyText)
           throws QdParserException,
                  java.io.IOException

Parse a document.

Parameters:

doc - handler for document

in - the input stream containing the document

notifyText - notify doc about text nodes at all

Throws:

QdParserException - parse error

java.io.IOException - in case that reading errors occur

parse

public void parse(DocHandler doc,
                  java.io.Reader reader,
                  boolean notifyText)
           throws QdParserException,
                  java.io.IOException

Parse a document.

Parameters:

doc - handler for document

reader - input reader containing the document

notifyText - notify doc about text nodes at all

Throws:

QdParserException - parse error

java.io.IOException - in case that reading errors occur

tagContent

private void tagContent(DocHandler doc,
                        int ch)
                 throws QdParserException

Content off an XML element.

Parameters:

doc - document content handler

ch - current char

Throws:

QdParserException - parse error

attributeEquals

private void attributeEquals(int ch)
                      throws QdParserException

"=" between attribute name and quoted value.

Parameters:

ch - current char

Throws:

QdParserException - parse error

attributeName

private void attributeName(int ch)

Part of the attribute name.

Parameters:

ch - current char

attributeValue

private void attributeValue(int ch)
                     throws QdParserException

Part of the attribute value.

Parameters:

ch - current char

Throws:

QdParserException - parse error

quotedValue

private void quotedValue(int ch)

Part of a quoted value.

Parameters:

ch - current char

openTag

private void openTag(DocHandler doc,
                     int ch)
              throws QdParserException

Inside an open tag (XML element started).

Parameters:

doc - document content handler

ch - current char

Throws:

QdParserException - parse error

entityRef

private void entityRef(int ch)
                throws QdParserException

Reference to an XML Entity.

Parameters:

ch - current char

Throws:

QdParserException - parse error

startTag

private void startTag(int ch)

XML Element start tag.

Parameters:

ch - current char

doctype

private void doctype(int ch)

XML Doctype.

Parameters:

ch - current char

beforeRoot

private void beforeRoot(int ch)

Before parsing the XML root element.

Parameters:

ch - current char

comment

private void comment(int ch)

XML comment.

Parameters:

ch - current char

cdataSection

private void cdataSection(DocHandler doc,
                          int ch)
                   throws QdParserException

Inside a [CDATA] section.

Parameters:

doc - document content handler

ch - current char

Throws:

QdParserException - parse error

closeTag

private void closeTag(DocHandler doc,
                      int ch)
               throws QdParserException

XML Element closing tag.

Parameters:

doc - document content handler

ch - current char

Throws:

QdParserException - parse error

textNode

private void textNode(DocHandler doc,
                      int ch,
                      boolean notify)
               throws QdParserException

Text node.

Parameters:

doc - document content handler

ch - current char

notify - notify doc or not

Throws:

QdParserException - parse error

exc

private void exc(java.lang.String msg)
          throws QdParserException

Throws an exception with parse location.

Parameters:

msg - message

Throws:

QdParserException - formatted exception

main

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

Just testing.

Parameters:

args - ignored

Since:

1.00