All Implemented Interfaces:

ContentHandler, ErrorHandler

public class DefaultHandler
extends Object
implements ContentHandler, ErrorHandler 

Version:

3.1, March 11, 2005

Author:

David Megginson, Jean-Marie Dautelle

• Constructor Summary

  Constructors

  Constructor and Description
  DefaultHandler ()

• Method Summary

  Methods

  Modifier and Type	Method and Description
  void	characters (char[] ch, int start, int length) Receives notification of character data.
  void	endDocument () Receives notification of the end of a document.
  void	endElement (CharArray namespaceURI, CharArray localName, CharArray qName) Receives notification of the end of an element.
  void	endPrefixMapping (CharArray prefix) Ends the scope of a prefix-URI mapping.
  void	error (SAXParseException e) Receives notification of recoverable parser error.
  void	fatalError (SAXParseException e) Reports a fatal XML parsing error.
  void	ignorableWhitespace (char[] ch, int start, int length) Receives notification of ignorable whitespace in element content.
  void	processingInstruction (CharArray target, CharArray data) Receives notification of a processing instruction.
  void	setDocumentLocator (Locator locator) Receives an object for locating the origin of SAX document events.
  void	skippedEntity (CharArray name) Receives notification of a skipped entity.
  void	startDocument () Receives notification of the beginning of a document.
  void	startElement (CharArray namespaceURI, CharArray localName, CharArray qName, Attributes atts) Receives notification of the beginning of an element.
  protected void	startElement (CharArray uri, CharArray localName, CharArray qName, Attributes atts) Generates compile-time error if startElement is not correctly overriden.
  void	startPrefixMapping (CharArray prefix, CharArray uri) Begins the scope of a prefix-URI Namespace mapping.
  void	warning (SAXParseException e) Receives notification of a warning.

  • Methods inherited from class java.lang.Object

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

• Constructor Detail

  • DefaultHandler

    public DefaultHandler()

• Method Detail

  • warning

    public void warning(SAXParseException e)
     throws SAXException 

    Receives notification of a warning. The default behaviour is to take no action.

    Specified by:

    warning in interface ErrorHandler

    Parameters:

    e - the warning information encapsulated in a SAX parse exception.

    Throws:

    SAXException - any SAX exception.

  • error

    public void error(SAXParseException e)
     throws SAXException 

    Receives notification of recoverable parser error. The default behaviour is to take no action.

    Specified by:

    error in interface ErrorHandler

    Parameters:

    e - the error information encapsulated in a SAX parse exception.

    Throws:

    SAXException - any SAX exception.

  • fatalError

    public void fatalError(SAXParseException e)
     throws SAXException 

    Reports a fatal XML parsing error. The default behaviour is to throw the specified exception.

    Specified by:

    fatalError in interface ErrorHandler

    Parameters:

    e - the error information encapsulated in a SAX parse exception.

    Throws:

    SAXException - any SAX exception.

  • setDocumentLocator

    public void setDocumentLocator(Locator locator)

    Description copied from interface: ContentHandler
    Receives an object for locating the origin of SAX document events.

    Specified by:

    setDocumentLocator in interface ContentHandler

    Parameters:

    locator - the document locator.

  • startDocument

    public void startDocument()
     throws SAXException 

    Description copied from interface: ContentHandler
    Receives notification of the beginning of a document.

    Specified by:

    startDocument in interface ContentHandler

    Throws:

    SAXException - any SAX exception.

  • endDocument

    public void endDocument()
     throws SAXException 

    Description copied from interface: ContentHandler
    Receives notification of the end of a document.

    Specified by:

    endDocument in interface ContentHandler

    Throws:

    SAXException - any SAX exception.

  • startPrefixMapping

    public void startPrefixMapping(CharArray prefix,
     CharArray uri)
     throws SAXException 

    Description copied from interface: ContentHandler
    Begins the scope of a prefix-URI Namespace mapping.

    Specified by:

    startPrefixMapping in interface ContentHandler

    Parameters:

    prefix - the Namespace prefix being declared.

    uri - the namespace URI the prefix is mapped to.

    Throws:

    SAXException - any SAX exception.

  • endPrefixMapping

    public void endPrefixMapping(CharArray prefix)
     throws SAXException 

    Description copied from interface: ContentHandler
    Ends the scope of a prefix-URI mapping.

    Specified by:

    endPrefixMapping in interface ContentHandler

    Parameters:

    prefix - the prefix that was being mapping.

    Throws:

    SAXException - any SAX exception.

  • startElement

    public void startElement(CharArray namespaceURI,
     CharArray localName,
     CharArray qName,
     Attributes atts)
     throws SAXException 

    Description copied from interface: ContentHandler
    Receives notification of the beginning of an element.

    Specified by:

    startElement in interface ContentHandler

    Parameters:

    namespaceURI - the namespace URI, or an empty character sequence if the element has no Namespace URI or if namespace processing is not being performed.

    localName - the local name (without prefix), or an empty character sequence if namespace processing is not being performed.

    qName - the qualified name (with prefix), or an empty character sequence if qualified names are not available.

    atts - the attributes attached to the element. If there are no attributes, it shall be an empty Attributes object.

    Throws:

    SAXException - any SAX exception.

  • endElement

    public void endElement(CharArray namespaceURI,
     CharArray localName,
     CharArray qName)
     throws SAXException 

    Description copied from interface: ContentHandler
    Receives notification of the end of an element.

    Specified by:

    endElement in interface ContentHandler

    Parameters:

    namespaceURI - the namespace URI, or an empty character sequence if the element has no Namespace URI or if namespace processing is not being performed.

    localName - the local name (without prefix), or an empty character sequence if namespace processing is not being performed.

    qName - the qualified XML 1.0 name (with prefix), or an empty character sequence if qualified names are not available.

    Throws:

    SAXException - any SAX exception.

  • characters

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

    Description copied from interface: ContentHandler
    Receives notification of character data.

    Specified by:

    characters in interface ContentHandler

    Parameters:

    ch - the characters from the XML document.

    start - the start position in the array.

    length - the number of characters to read from the array.

    Throws:

    SAXException - any SAX exception.

  • ignorableWhitespace

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

    Description copied from interface: ContentHandler
    Receives notification of ignorable whitespace in element content.

    Specified by:

    ignorableWhitespace in interface ContentHandler

    Parameters:

    ch - the characters from the XML document.

    start - the start position in the array.

    length - the number of characters to read from the array.

    Throws:

    SAXException - any SAX exception.

  • processingInstruction

    public void processingInstruction(CharArray target,
     CharArray data)
     throws SAXException 

    Description copied from interface: ContentHandler
    Receives notification of a processing instruction.

    Specified by:

    processingInstruction in interface ContentHandler

    Parameters:

    target - the processing instruction target.

    data - the processing instruction data, or null if none was supplied. The data does not include any whitespace separating it from the target.

    Throws:

    SAXException - any SAX exception.

  • skippedEntity

    public void skippedEntity(CharArray name)
     throws SAXException 

    Description copied from interface: ContentHandler
    Receives notification of a skipped entity.

    Specified by:

    skippedEntity in interface ContentHandler

    Parameters:

    name - the name of the skipped entity. If it is a parameter entity, the name will begin with '%', and if it is the external DTD subset, it will be the character sequence "[dtd]".

    Throws:

    SAXException - any SAX exception.

  • startElement

    protected final void startElement(CharArray uri,
     CharArray localName,
     CharArray qName,
     Attributes atts)
     throws SAXException 

    Generates compile-time error if startElement is not correctly overriden. This method generates a compile-error "final method cannot be overridden" if org.xml.sax.Attributes is used instead of javolution.xml.sax.Attributes (common mistake).

    Parameters:

    uri - the namespace URI, or an empty character sequence if the element has no Namespace URI or if namespace processing is not being performed.

    localName - the local name (without prefix), or an empty character sequence if namespace processing is not being performed.

    qName - the qualified name (with prefix), or an empty character sequence if qualified names are not available.

    atts - the attributes attached to the element. If there are no attributes, it shall be an empty Attributes object.

    Throws:

    SAXException - any SAX exception.