/**@class org.xml.sax.HandlerBase
 implements org.xml.sax.EntityResolver

 implements org.xml.sax.DTDHandler

 implements org.xml.sax.DocumentHandler

 implements org.xml.sax.ErrorHandler

@extends java.lang.Object

 Default base class for handlers.

 <blockquote>
 <em>This module, both source code and documentation, is in the
 Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
 See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
 for further information.
 </blockquote>

 <p>This class implements the default behaviour for four SAX1
 interfaces: EntityResolver, DTDHandler, DocumentHandler,
 and ErrorHandler.  It is now obsolete, but is included in SAX2 to
 support legacy SAX1 applications.  SAX2 applications should use
 the {@link org.xml.sax.helpers.DefaultHandler DefaultHandler}
 class instead.</p>

 <p>Application writers can extend this class when they need to
 implement only part of an interface; parser writers can
 instantiate this class to provide default handlers when the
 application has not supplied its own.</p>

 <p>Note that the use of this class is optional.</p>

 @deprecated This class works with the deprecated
             {@link org.xml.sax.DocumentHandler DocumentHandler}
             interface.  It has been replaced by the SAX2
             {@link org.xml.sax.helpers.DefaultHandler DefaultHandler}
             class.
 @since SAX 1.0
 @author David Megginson
 @version 2.0.1 (sax2r2)
 @see org.xml.sax.EntityResolver
 @see org.xml.sax.DTDHandler
 @see org.xml.sax.DocumentHandler
 @see org.xml.sax.ErrorHandler
*/
var HandlerBase = {

/**Resolve an external entity.

 <p>Always return null, so that the parser will use the system
 identifier provided in the XML document.  This method implements
 the SAX default behaviour: application writers can override it
 in a subclass to do special translations such as catalog lookups
 or URI redirection.</p>
@param {String} publicId The public identifier, or null if none is
                 available.
@param {String} systemId The system identifier provided in the XML
                 document.
@return {Object {org.xml.sax.InputSource}} The new input source, or null to require the
         default behaviour.
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.EntityResolver#resolveEntity
*/
resolveEntity : function(  ) {},

/**Receive notification of a notation declaration.

 <p>By default, do nothing.  Application writers may override this
 method in a subclass if they wish to keep track of the notations
 declared in a document.</p>
@param {String} name The notation name.
@param {String} publicId The notation public identifier, or null if not
                 available.
@param {String} systemId The notation system identifier.
@see org.xml.sax.DTDHandler#notationDecl
*/
notationDecl : function(  ) {},

/**Receive notification of an unparsed entity declaration.

 <p>By default, do nothing.  Application writers may override this
 method in a subclass to keep track of the unparsed entities
 declared in a document.</p>
@param {String} name The entity name.
@param {String} publicId The entity public identifier, or null if not
                 available.
@param {String} systemId The entity system identifier.
@param {String} notationName The name of the associated notation.
@see org.xml.sax.DTDHandler#unparsedEntityDecl
*/
unparsedEntityDecl : function(  ) {},

/**Receive a Locator object for document events.

 <p>By default, do nothing.  Application writers may override this
 method in a subclass if they wish to store the locator for use
 with other document events.</p>
@param {Object {Locator}} locator A locator for all SAX document events.
@see org.xml.sax.DocumentHandler#setDocumentLocator
@see org.xml.sax.Locator
*/
setDocumentLocator : function(  ) {},

/**Receive notification of the beginning of the document.

 <p>By default, do nothing.  Application writers may override this
 method in a subclass to take specific actions at the beginning
 of a document (such as allocating the root node of a tree or
 creating an output file).</p>
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.DocumentHandler#startDocument
*/
startDocument : function(  ) {},

/**Receive notification of the end of the document.

 <p>By default, do nothing.  Application writers may override this
 method in a subclass to take specific actions at the beginning
 of a document (such as finalising a tree or closing an output
 file).</p>
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.DocumentHandler#endDocument
*/
endDocument : function(  ) {},

/**Receive notification of the start of an element.

 <p>By default, do nothing.  Application writers may override this
 method in a subclass to take specific actions at the start of
 each element (such as allocating a new tree node or writing
 output to a file).</p>
@param {String} name The element type name.
@param {Object {AttributeList}} attributes The specified or defaulted attributes.
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.DocumentHandler#startElement
*/
startElement : function(  ) {},

/**Receive notification of the end of an element.

 <p>By default, do nothing.  Application writers may override this
 method in a subclass to take specific actions at the end of
 each element (such as finalising a tree node or writing
 output to a file).</p>
@param {String} name the element name
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.DocumentHandler#endElement
*/
endElement : function(  ) {},

/**Receive notification of character data inside an element.

 <p>By default, do nothing.  Application writers may override this
 method to take specific actions for each chunk of character data
 (such as adding the data to a node or buffer, or printing it to
 a file).</p>
@param {Object {char[]}} ch The characters.
@param {Number} start The start position in the character array.
@param {Number} length The number of characters to use from the
               character array.
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.DocumentHandler#characters
*/
characters : function(  ) {},

/**Receive notification of ignorable whitespace in element content.

 <p>By default, do nothing.  Application writers may override this
 method to take specific actions for each chunk of ignorable
 whitespace (such as adding data to a node or buffer, or printing
 it to a file).</p>
@param {Object {char[]}} ch The whitespace characters.
@param {Number} start The start position in the character array.
@param {Number} length The number of characters to use from the
               character array.
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.DocumentHandler#ignorableWhitespace
*/
ignorableWhitespace : function(  ) {},

/**Receive notification of a processing instruction.

 <p>By default, do nothing.  Application writers may override this
 method in a subclass to take specific actions for each
 processing instruction, such as setting status variables or
 invoking other methods.</p>
@param {String} target The processing instruction target.
@param {String} data The processing instruction data, or null if
             none is supplied.
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.DocumentHandler#processingInstruction
*/
processingInstruction : function(  ) {},

/**Receive notification of a parser warning.

 <p>The default implementation does nothing.  Application writers
 may override this method in a subclass to take specific actions
 for each warning, such as inserting the message in a log file or
 printing it to the console.</p>
@param {Object {SAXParseException}} e The warning information encoded as an exception.
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.ErrorHandler#warning
@see org.xml.sax.SAXParseException
*/
warning : function(  ) {},

/**Receive notification of a recoverable parser error.

 <p>The default implementation does nothing.  Application writers
 may override this method in a subclass to take specific actions
 for each error, such as inserting the message in a log file or
 printing it to the console.</p>
@param {Object {SAXParseException}} e The warning information encoded as an exception.
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.ErrorHandler#warning
@see org.xml.sax.SAXParseException
*/
error : function(  ) {},

/**Report a fatal XML parsing error.

 <p>The default implementation throws a SAXParseException.
 Application writers may override this method in a subclass if
 they need to take specific actions for each fatal error (such as
 collecting all of the errors into a single report): in any case,
 the application must stop all regular processing when this
 method is invoked, since the document is no longer reliable, and
 the parser may no longer report parsing events.</p>
@param {Object {SAXParseException}} e The error information encoded as an exception.
@exception org.xml.sax.SAXException Any SAX exception, possibly
            wrapping another exception.
@see org.xml.sax.ErrorHandler#fatalError
@see org.xml.sax.SAXParseException
*/
fatalError : function(  ) {},


};