org.exolab.castor.xml
Class DebugHandler

java.lang.Object
  org.exolab.castor.xml.DebugHandler

All Implemented Interfaces:

org.xml.sax.DocumentHandler

public class DebugHandler

extends java.lang.Object

implements org.xml.sax.DocumentHandler

A Simple SAX1 DocumentHandler that intercepts SAX events and prints them to the console. This class is not used during normal Castor operation, but exists so that during debugging one can replace a normal DocumentHandler with this one (which will proxy to the correct DocumentHandler).

FIXME: As Castor moves internally to the SAX2 interface, this class should also be updated for SAX2.

Version:

$Revision: 6784 $ $Date: 2003-03-03 00:05:44 -0700 (Mon, 03 Mar 2003) $

Author:

Keith Visco

Constructor Summary

DebugHandler(org.xml.sax.DocumentHandler handler)
Creates a new DebugHandler which forwards events to the given document handler.

DebugHandler(org.xml.sax.DocumentHandler handler, java.io.Writer out)
Creates a new DebugHandler which forwards events to the given document handler.

Method Summary

void	characters(char[] ch, int start, int length) Proxies the org.sax.xml.DocumentHandler#characters(char[], int, int) request to the proxy that is provided, printing debugging information before doing the proxy.
void	endDocument() Proxies the org.sax.xml.DocumentHandler#endDocument() request to the proxy that is provided, printing debugging information before doing the proxy.
void	endElement(java.lang.String name) Proxies the org.sax.xml.DocumentHandler#endElement(String) request to the proxy that is provided, printing debugging information before doing the proxy.
void	ignorableWhitespace(char[] ch, int start, int length) Proxies the org.sax.xml.DocumentHandler#ignorableWhitespace(char[], int, int) request to the proxy that is provided, printing debugging information before doing the proxy.
void	processingInstruction(java.lang.String target, java.lang.String data) Proxies the org.sax.xml.DocumentHandler#processingInstruction(String, String) request to the proxy that is provided, printing debugging information before doing the proxy.
void	setDocumentLocator(org.xml.sax.Locator locator) Proxies the org.sax.xml.DocumentHandler#setDocumentLocator(Locator) request to the proxy that is provided, printing debugging information before doing the proxy.
void	startDocument() Proxies the org.sax.xml.DocumentHandler#startDocument() request to the proxy that is provided, printing debugging information before doing the proxy.
void	startElement(java.lang.String name, org.xml.sax.AttributeList atts) Proxies the org.sax.xml.DocumentHandler#startElement(String, AttributeList) request to the proxy that is provided, printing debugging information before doing the proxy.

Methods inherited from class java.lang.Object

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

Constructor Detail

DebugHandler

public DebugHandler(org.xml.sax.DocumentHandler handler)

Creates a new DebugHandler which forwards events to the given document handler.

Parameters:

handler - the DocumentHandler to forward events to

DebugHandler

public DebugHandler(org.xml.sax.DocumentHandler handler,
                    java.io.Writer out)

Creates a new DebugHandler which forwards events to the given document handler.

Parameters:

handler - the DocumentHandler to forward events to

out - the Writer to print debug information to

Method Detail

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws org.xml.sax.SAXException

Proxies the org.sax.xml.DocumentHandler#characters(char[], int, int) request to the proxy that is provided, printing debugging information before doing the proxy.

Specified by:

characters in interface org.xml.sax.DocumentHandler

Throws:

org.xml.sax.SAXException

endDocument

public void endDocument()
                 throws org.xml.sax.SAXException

Proxies the org.sax.xml.DocumentHandler#endDocument() request to the proxy that is provided, printing debugging information before doing the proxy.

Specified by:

endDocument in interface org.xml.sax.DocumentHandler

Throws:

org.xml.sax.SAXException

endElement

public void endElement(java.lang.String name)
                throws org.xml.sax.SAXException

Proxies the org.sax.xml.DocumentHandler#endElement(String) request to the proxy that is provided, printing debugging information before doing the proxy.

Specified by:

endElement in interface org.xml.sax.DocumentHandler

Throws:

org.xml.sax.SAXException

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws org.xml.sax.SAXException

Proxies the org.sax.xml.DocumentHandler#ignorableWhitespace(char[], int, int) request to the proxy that is provided, printing debugging information before doing the proxy.

Specified by:

ignorableWhitespace in interface org.xml.sax.DocumentHandler

Throws:

org.xml.sax.SAXException

processingInstruction

public void processingInstruction(java.lang.String target,
                                  java.lang.String data)
                           throws org.xml.sax.SAXException

Proxies the org.sax.xml.DocumentHandler#processingInstruction(String, String) request to the proxy that is provided, printing debugging information before doing the proxy.

Specified by:

processingInstruction in interface org.xml.sax.DocumentHandler

Throws:

org.xml.sax.SAXException

setDocumentLocator

public void setDocumentLocator(org.xml.sax.Locator locator)

Proxies the org.sax.xml.DocumentHandler#setDocumentLocator(Locator) request to the proxy that is provided, printing debugging information before doing the proxy.

Specified by:

setDocumentLocator in interface org.xml.sax.DocumentHandler

startDocument

public void startDocument()
                   throws org.xml.sax.SAXException

Proxies the org.sax.xml.DocumentHandler#startDocument() request to the proxy that is provided, printing debugging information before doing the proxy.

Specified by:

startDocument in interface org.xml.sax.DocumentHandler

Throws:

org.xml.sax.SAXException

startElement

public void startElement(java.lang.String name,
                         org.xml.sax.AttributeList atts)
                  throws org.xml.sax.SAXException

Proxies the org.sax.xml.DocumentHandler#startElement(String, AttributeList) request to the proxy that is provided, printing debugging information before doing the proxy.

Specified by:

startElement in interface org.xml.sax.DocumentHandler

Throws:

org.xml.sax.SAXException