Package eu.bandm.tools.util

Class SaxDumper

java.lang.Object

eu.bandm.tools.util.SaxDumper

All Implemented Interfaces:

ContentHandler

public class SaxDumper
extends Object
implements ContentHandler

A ContentHandler which dumps all sax events for debugging purpose.

Field Summary

Fields

Modifier and Type	Field	Description
protected final PrintStream	out	The target of the print output.

Constructor Summary

Constructors

Constructor	Description
SaxDumper()	Constructor which sets the target of the print output to System.errx.
SaxDumper(@Opt PrintStream out)	Constructor which sets the target of the print output or takes System.err in case of null.

Method Summary

Modifier and Type	Method	Description
void	characters(char[] ch, int start, int length)
static String	dumpAttributes(Attributes atts)	Delivers a string representation of a Sax attribute object.
void	endDocument()
void	endElement(String uri, String localName, String qName)
void	endPrefixMapping(String prefix)
void	ignorableWhitespace(char[] ch, int start, int end)
protected void	PRL(String s)	Aux method which makes a line feed and flushes the output, for ease of debugging in multi-thread contexts.
void	processingInstruction(String target, String data)
void	setDocumentLocator(Locator locator)
void	skippedEntity(String name)
void	startDocument()
void	startElement(String uri, String localName, String qName, Attributes attrs)
void	startPrefixMapping(String prefix, String uri)
protected void	x_chars(String header, char[] ch, int start, int length)	Aux method which prints the given chars framed by >>..<< and linefeeds and flushes the output.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.xml.sax.ContentHandler

declaration

Field Details

out

protected final PrintStream out

The target of the print output.

Constructor Details

SaxDumper

public SaxDumper(@Opt
 @Opt PrintStream out)

Constructor which sets the target of the print output or takes System.err in case of null.

SaxDumper

public SaxDumper()

Constructor which sets the target of the print output to System.errx.

Method Details

dumpAttributes

public static String dumpAttributes(Attributes atts)

Delivers a string representation of a Sax attribute object. Each entry gets one text line (separated by PrintWriter_limited.LS) with form
{uri!=null}name:type:value or
name:type:value
where name=getQName(i) if not empty, otherwise getLocalName(),
type = getType(i) and value=getValue(i).

A SAX "Attributes" is a mere technical device with no mathematical "set" semantics: The SAX specification does not forbid that these are de-normalized and do not represent a valid XML data model.

PRL

protected void PRL(String s)

Aux method which makes a line feed and flushes the output, for ease of debugging in multi-thread contexts.

x_chars

protected void x_chars(String header,
 char[] ch,
 int start,
 int length)

Aux method which prints the given chars framed by >>..<< and linefeeds and flushes the output.

characters

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

Specified by:

characters in interface ContentHandler

endDocument

public void endDocument()
                 throws SAXException

Specified by:

endDocument in interface ContentHandler

Throws:

SAXException

endElement

public void endElement(String uri,
 String localName,
 String qName)

Specified by:

endElement in interface ContentHandler

endPrefixMapping

public void endPrefixMapping(String prefix)

Specified by:

endPrefixMapping in interface ContentHandler

ignorableWhitespace

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

Specified by:

ignorableWhitespace in interface ContentHandler

processingInstruction

public void processingInstruction(String target,
 String data)

Specified by:

processingInstruction in interface ContentHandler

setDocumentLocator

public void setDocumentLocator(Locator locator)

Specified by:

setDocumentLocator in interface ContentHandler

skippedEntity

public void skippedEntity(String name)

Specified by:

skippedEntity in interface ContentHandler

startDocument

public void startDocument()

Specified by:

startDocument in interface ContentHandler

startElement

public void startElement(String uri,
 String localName,
 String qName,
 Attributes attrs)

Specified by:

startElement in interface ContentHandler

startPrefixMapping

public void startPrefixMapping(String prefix,
 String uri)

Specified by:

startPrefixMapping in interface ContentHandler