DebugHandler (Castor JavaDoc)

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

Constructors
Constructor	Description
`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

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`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

Class DebugHandler

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

DebugHandler

DebugHandler

Method Detail

characters

endDocument

endElement

ignorableWhitespace

processingInstruction

setDocumentLocator

startDocument

startElement