nu.xom.converters

Class SAXConverter

Object
  extended by nu.xom.converters.SAXConverter

public class SAXConverter
extends Object

Feeds a XOM Document into a SAX2 ContentHandler.

Version:
1.1b2
Author:
Elliotte Rusty Harold

Constructor Summary
SAXConverter(org.xml.sax.ContentHandler handler)

           Creates a new SAXConverter.
 
Method Summary
 voidconvert(Document doc)

           Feed a document through this converter.
 voidconvert(Nodes nodes)

           Converts a Nodes list into SAX by firing events into the registered handlers.
 org.xml.sax.ContentHandlergetContentHandler()

           Returns the content handler.
 org.xml.sax.ext.LexicalHandlergetLexicalHandler()

           Returns the LexicalHandler for this converter.
 voidsetContentHandler(org.xml.sax.ContentHandler handler)

           Set the content handler for this converter.
 voidsetLexicalHandler(org.xml.sax.ext.LexicalHandler handler)

           Sets the optional lexical handler for this converter.
 
Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SAXConverter

public SAXConverter(org.xml.sax.ContentHandler handler)

Creates a new SAXConverter.

Parameters:
handler - the SAX2 content handler that receives the data
Throws:
NullPointerException - if handler is null
Method Detail

setContentHandler

public void setContentHandler(org.xml.sax.ContentHandler handler)

Set the content handler for this converter.

Parameters:
handler - SAX2 content handler that receives the data
Throws:
NullPointerException - if handler is null

getContentHandler

public org.xml.sax.ContentHandler getContentHandler()

Returns the content handler.

Returns:
SAX2 content handler that receives the data

setLexicalHandler

public void setLexicalHandler(org.xml.sax.ext.LexicalHandler handler)

Sets the optional lexical handler for this converter. The only lexical events the converter supplies are comments.

Parameters:
handler - the lexical handler; may be null to turn off lexical events

getLexicalHandler

public org.xml.sax.ext.LexicalHandler getLexicalHandler()

Returns the LexicalHandler for this converter. This is only used for comments.

Returns:
SAX2 lexical handler that receives lexical events

convert

public void convert(Document doc)
             throws org.xml.sax.SAXException

Feed a document through this converter.

Parameters:
doc - the document to pass to SAX
Throws:
org.xml.sax.SAXException - if the content handler or lexical handler throws an exception

convert

public void convert(Nodes nodes)
             throws org.xml.sax.SAXException

Converts a Nodes list into SAX by firing events into the registered handlers. This method calls startDocument before processing the list of nodes, and calls endDocument after processing all of them.

Parameters:
nodes - the nodes to pass to SAX
Throws:
org.xml.sax.SAXException - if the content handler or lexical handler throws an exception


Copyright 2002-2010 Elliotte Rusty Harold

elharo@ibiblio.org