Package com.deltaxml.pipe

Class XMLPushFilterAdapter

java.lang.Object

com.deltaxml.pipe.XMLPushFilterAdapter

All Implemented Interfaces:

XMLPushFilter, ContentHandler, DTDHandler, DeclHandler, LexicalHandler

public class XMLPushFilterAdapter
extends Object
implements XMLPushFilter

Used to convert an XMLFilter object into an XMLPushFilter object. This enables it to be used logically 'after' the triggered element in a JAXP pipeline. In the PipelinedComparator, any Java filters to be used as output filters must be compatible with XMLPushFilter. This class is used for that purpose.

Author:

Nigel Whitaker

Constructor Summary

Constructors

Constructor	Description
XMLPushFilterAdapter(XMLFilterImpl filter)	Cannot support LexicalHandler events such as comments.

Method Summary

Modifier and Type	Method	Description
void	attributeDecl(String eName, String aName, String type, String mode, String value)	An implementation of the DeclHandler attributeDecl method.
final void	characters(char[] ch, int start, int length)	An implementation of the ContentHandler characters method.
void	comment(char[] ch, int start, int length)	An implementation of the LexicalHandler comment method.
void	elementDecl(String name, String model)	An implementation of the DeclHandler elementDecl method.
void	endCDATA()	An implementation of the LexicalHandler endCDATA method.
final void	endDocument()	An implementation of the ContentHandler endDocument method.
void	endDTD()	An implementation of the LexicalHandler endDTD method.
final void	endElement(String uri, String localName, String qName)	An implementation of the ContentHandler endElement method.
void	endEntity(String name)	An implementation of the LexicalHandler endEntity method.
final void	endPrefixMapping(String prefix)	An implementation of the ContentHandler endPrefixMapping method.
void	externalEntityDecl(String name, String publicId, String systemId)	An implementation of the DeclHandler externalEntityDecl method.
XMLFilterImpl	getUnderlyingFilter()	Returns the underlying filter that was used to create this instance.
final void	ignorableWhitespace(char[] ch, int start, int length)	An implementation of the ContentHandler ignorableWhitespace method.
void	internalEntityDecl(String name, String value)	An implementation of the DeclHandler internalEntityDecl method.
final void	notationDecl(String name, String publicId, String systemId)	An implementation of the DTDHandler notationDecl method.
final void	processingInstruction(String target, String data)	An implementation of the ContentHandler processingInstruction method.
final void	setDocumentLocator(Locator locator)	An implementation of the ContentHandler setDocumentLocator method.
void	setResult(Result result)	Enables the user to set the Result of the transformation.
final void	skippedEntity(String name)	An implementation of the ContentHandler skippedEntity method.
void	startCDATA()	An implementation of the LexicalHandler startCDATA method.
final void	startDocument()	An implementation of the ContentHandler startDocument method.
void	startDTD(String name, String publicId, String systemId)	An implementation of the LexicalHandler startDTD method.
final void	startElement(String uri, String localName, String qName, Attributes atts)	An implementation of the ContentHandler startElement method.
void	startEntity(String name)	An implementation of the LexicalHandler startEntity method.
final void	startPrefixMapping(String prefix, String uri)	An implementation of the ContentHandler startPrefixMapping method.
final void	unparsedEntityDecl(String name, String publicId, String systemId, String notationName)	An implementation of the DTDHandler unparsedEntityDecl method.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.xml.sax.ContentHandler

declaration

Constructor Details

XMLPushFilterAdapter

public XMLPushFilterAdapter(XMLFilterImpl filter)

Cannot support LexicalHandler events such as comments.

Parameters:

filter - the XMLFilterImpl to use as an XMLPushFilter

Method Details

getUnderlyingFilter

public XMLFilterImpl getUnderlyingFilter()

Returns the underlying filter that was used to create this instance.

Returns:

the underlying XMLFilter implementation

setResult

public void setResult(Result result)
               throws IllegalArgumentException

Enables the user to set the Result of the transformation.

Specified by:

setResult in interface XMLPushFilter

Parameters:

result - the Result instance to which the output from this filter should be sent

Throws:

IllegalArgumentException - if result is null

See Also:

• XMLPushFilter.setResult(Result)

setDocumentLocator

public final void setDocumentLocator(Locator locator)

An implementation of the ContentHandler setDocumentLocator method.

Specified by:

setDocumentLocator in interface ContentHandler

Parameters:

locator - to pass through to the underlying filter

See Also:

• ContentHandler.setDocumentLocator(org.xml.sax.Locator)

startDocument

public final void startDocument()
                         throws SAXException

An implementation of the ContentHandler startDocument method.

Specified by:

startDocument in interface ContentHandler

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• ContentHandler.startDocument()

endDocument

public final void endDocument()
                       throws SAXException

An implementation of the ContentHandler endDocument method.

Specified by:

endDocument in interface ContentHandler

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• ContentHandler.endDocument()

startPrefixMapping

public final void startPrefixMapping(String prefix,
 String uri)
                              throws SAXException

An implementation of the ContentHandler startPrefixMapping method.

Specified by:

startPrefixMapping in interface ContentHandler

Parameters:

prefix - to pass through to the underlying filter

uri - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• ContentHandler.startPrefixMapping(java.lang.String, java.lang.String)

endPrefixMapping

public final void endPrefixMapping(String prefix)
                            throws SAXException

An implementation of the ContentHandler endPrefixMapping method.

Specified by:

endPrefixMapping in interface ContentHandler

Parameters:

prefix - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• ContentHandler.endPrefixMapping(java.lang.String)

startElement

public final void startElement(String uri,
 String localName,
 String qName,
 Attributes atts)
                        throws SAXException

An implementation of the ContentHandler startElement method.

Specified by:

startElement in interface ContentHandler

Parameters:

uri - to pass through to the underlying filter

localName - to pass through to the underlying filter

qName - to pass through to the underlying filter

atts - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• ContentHandler.startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)

endElement

public final void endElement(String uri,
 String localName,
 String qName)
                      throws SAXException

An implementation of the ContentHandler endElement method.

Specified by:

endElement in interface ContentHandler

Parameters:

uri - to pass through to the underlying filter

localName - to pass through to the underlying filter

qName - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)

characters

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

An implementation of the ContentHandler characters method.

Specified by:

characters in interface ContentHandler

Parameters:

ch - to pass through to the underlying filter

start - to pass through to the underlying filter

length - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• ContentHandler.characters(char[], int, int)

ignorableWhitespace

public final void ignorableWhitespace(char[] ch,
 int start,
 int length)
                               throws SAXException

An implementation of the ContentHandler ignorableWhitespace method.

Specified by:

ignorableWhitespace in interface ContentHandler

Parameters:

ch - to pass through to the underlying filter

start - to pass through to the underlying filter

length - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• ContentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

public final void processingInstruction(String target,
 String data)
                                 throws SAXException

An implementation of the ContentHandler processingInstruction method.

Specified by:

processingInstruction in interface ContentHandler

Parameters:

target - to pass through to the underlying filter

data - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• ContentHandler.processingInstruction(java.lang.String, java.lang.String)

skippedEntity

public final void skippedEntity(String name)
                         throws SAXException

An implementation of the ContentHandler skippedEntity method.

Specified by:

skippedEntity in interface ContentHandler

Parameters:

name - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• ContentHandler.skippedEntity(java.lang.String)

comment

public void comment(char[] ch,
 int start,
 int length)
             throws SAXException

An implementation of the LexicalHandler comment method.

Specified by:

comment in interface LexicalHandler

Parameters:

ch - to pass through to the underlying filter

start - to pass through to the underlying filter

length - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• LexicalHandler.comment(char[], int, int)

startDTD

public void startDTD(String name,
 String publicId,
 String systemId)
              throws SAXException

An implementation of the LexicalHandler startDTD method.

Specified by:

startDTD in interface LexicalHandler

Parameters:

name - to pass through to the underlying filter

publicId - to pass through to the underlying filter

systemId - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• LexicalHandler.startDTD(java.lang.String, java.lang.String, java.lang.String)

endDTD

public void endDTD()
            throws SAXException

An implementation of the LexicalHandler endDTD method.

Specified by:

endDTD in interface LexicalHandler

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• LexicalHandler.endDTD()

startEntity

public void startEntity(String name)
                 throws SAXException

An implementation of the LexicalHandler startEntity method.

Specified by:

startEntity in interface LexicalHandler

Parameters:

name - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• LexicalHandler.startEntity(java.lang.String)

endEntity

public void endEntity(String name)
               throws SAXException

An implementation of the LexicalHandler endEntity method.

Specified by:

endEntity in interface LexicalHandler

Parameters:

name - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• LexicalHandler.endEntity(java.lang.String)

startCDATA

public void startCDATA()
                throws SAXException

An implementation of the LexicalHandler startCDATA method.

Specified by:

startCDATA in interface LexicalHandler

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• LexicalHandler.startCDATA()

endCDATA

public void endCDATA()
              throws SAXException

An implementation of the LexicalHandler endCDATA method.

Specified by:

endCDATA in interface LexicalHandler

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• LexicalHandler.endCDATA()

notationDecl

public final void notationDecl(String name,
 String publicId,
 String systemId)
                        throws SAXException

An implementation of the DTDHandler notationDecl method.

Specified by:

notationDecl in interface DTDHandler

Parameters:

name - to pass through to the underlying filter

publicId - to pass through to the underlying filter

systemId - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)

unparsedEntityDecl

public final void unparsedEntityDecl(String name,
 String publicId,
 String systemId,
 String notationName)
                              throws SAXException

An implementation of the DTDHandler unparsedEntityDecl method.

Specified by:

unparsedEntityDecl in interface DTDHandler

Parameters:

name - to pass through to the underlying filter

publicId - to pass through to the underlying filter

systemId - to pass through to the underlying filter

notationName - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

attributeDecl

public void attributeDecl(String eName,
 String aName,
 String type,
 String mode,
 String value)
                   throws SAXException

An implementation of the DeclHandler attributeDecl method.

Specified by:

attributeDecl in interface DeclHandler

Parameters:

eName - to pass through to the underlying filter

aName - to pass through to the underlying filter

type - to pass through to the underlying filter

mode - to pass through to the underlying filter

value - to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• DeclHandler.attributeDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)

elementDecl

public void elementDecl(String name,
 String model)
                 throws SAXException

An implementation of the DeclHandler elementDecl method.

Specified by:

elementDecl in interface DeclHandler

Parameters:

name - the name to pass through to the underlying filter

model - the model to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• DeclHandler.elementDecl(java.lang.String, java.lang.String)

externalEntityDecl

public void externalEntityDecl(String name,
 String publicId,
 String systemId)
                        throws SAXException

An implementation of the DeclHandler externalEntityDecl method.

Specified by:

externalEntityDecl in interface DeclHandler

Parameters:

name - the name to pass through to the underlying filter

publicId - the publicId to pass through to the underlying filter

systemId - the systemId to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• DeclHandler.externalEntityDecl(java.lang.String, java.lang.String, java.lang.String)

internalEntityDecl

public void internalEntityDecl(String name,
 String value)
                        throws SAXException

An implementation of the DeclHandler internalEntityDecl method.

Specified by:

internalEntityDecl in interface DeclHandler

Parameters:

name - the name to pass through to the underlying filter

value - the value to pass through to the underlying filter

Throws:

SAXException - if the underlying filter throws a SAXException

See Also:

• DeclHandler.internalEntityDecl(java.lang.String, java.lang.String)