org.xml.sax.ext

Class DefaultHandler2

Implemented Interfaces:
ContentHandler, DeclHandler, DTDHandler, EntityResolver, EntityResolver2, ErrorHandler, LexicalHandler

public class DefaultHandler2
extends DefaultHandler
implements LexicalHandler, DeclHandler, EntityResolver2

This class extends the SAX2 base handler class to support the SAX2 LexicalHandler, DeclHandler, and EntityResolver2 extensions. Except for overriding the original SAX1 resolveEntity() method the added handler methods just return. Subclassers may override everything on a method-by-method basis.
This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY.

Note: this class might yet learn that the ContentHandler.setDocumentLocator() call might be passed a Locator2 object, and that the ContentHandler.startElement() call might be passed a Attributes2 object.

Since:
SAX 2.0 (extensions 1.1 alpha)

Constructor Summary

DefaultHandler2()
Constructs a handler which ignores all parsing events.

Method Summary

void
attributeDecl(String eName, String aName, String type, String mode, String value)
void
comment(ch[] , int start, int length)
void
elementDecl(String name, String model)
void
endCDATA()
void
endDTD()
void
endEntity(String name)
void
externalEntityDecl(String name, String publicId, String systemId)
InputSource
getExternalSubset(String name, String baseURI)
Tells the parser that if no external subset has been declared in the document text, none should be used.
void
internalEntityDecl(String name, String value)
InputSource
resolveEntity(String publicId, String systemId)
Invokes EntityResolver2.resolveEntity() with null entity name and base URI.
InputSource
resolveEntity(String name, String publicId, String baseURI, String systemId)
Tells the parser to resolve the systemId against the baseURI and read the entity text from that resulting absolute URI.
void
startCDATA()
void
startDTD(String name, String publicId, String systemId)
void
startEntity(String name)

Methods inherited from class org.xml.sax.helpers.DefaultHandler

characters, endDocument, endElement, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping, unparsedEntityDecl, warning

Constructor Details

DefaultHandler2

public DefaultHandler2()
Constructs a handler which ignores all parsing events.

Method Details

attributeDecl

public void attributeDecl(String eName,
                          String aName,
                          String type,
                          String mode,
                          String value)
            throws SAXException
Specified by:
attributeDecl in interface DeclHandler


comment

public void comment(ch[] ,
                    int start,
                    int length)
            throws SAXException
Specified by:
comment in interface LexicalHandler


elementDecl

public void elementDecl(String name,
                        String model)
            throws SAXException
Specified by:
elementDecl in interface DeclHandler


endCDATA

public void endCDATA()
            throws SAXException
Specified by:
endCDATA in interface LexicalHandler


endDTD

public void endDTD()
            throws SAXException
Specified by:
endDTD in interface LexicalHandler


endEntity

public void endEntity(String name)
            throws SAXException
Specified by:
endEntity in interface LexicalHandler


externalEntityDecl

public void externalEntityDecl(String name,
                               String publicId,
                               String systemId)
            throws SAXException
Specified by:
externalEntityDecl in interface DeclHandler


getExternalSubset

public InputSource getExternalSubset(String name,
                                     String baseURI)
            throws SAXException,
                   IOException
Tells the parser that if no external subset has been declared in the document text, none should be used.
Specified by:
getExternalSubset in interface EntityResolver2


internalEntityDecl

public void internalEntityDecl(String name,
                               String value)
            throws SAXException
Specified by:
internalEntityDecl in interface DeclHandler


resolveEntity

public InputSource resolveEntity(String publicId,
                                 String systemId)
            throws SAXException,
                   IOException
Invokes EntityResolver2.resolveEntity() with null entity name and base URI. You only need to override that method to use this class.
Specified by:
resolveEntity in interface EntityResolver
Overrides:
resolveEntity in interface DefaultHandler


resolveEntity

public InputSource resolveEntity(String name,
                                 String publicId,
                                 String baseURI,
                                 String systemId)
            throws SAXException,
                   IOException
Tells the parser to resolve the systemId against the baseURI and read the entity text from that resulting absolute URI. Note that because the older DefaultHandler.resolveEntity(), method is overridden to call this one, this method may sometimes be invoked with null name and baseURI, and with the systemId already absolutized.
Specified by:
resolveEntity in interface EntityResolver2


startCDATA

public void startCDATA()
            throws SAXException
Specified by:
startCDATA in interface LexicalHandler


startDTD

public void startDTD(String name,
                     String publicId,
                     String systemId)
            throws SAXException
Specified by:
startDTD in interface LexicalHandler


startEntity

public void startEntity(String name)
            throws SAXException
Specified by:
startEntity in interface LexicalHandler