/**@class org.xml.sax.ext.DefaultHandler2 implements org.xml.sax.ext.LexicalHandler implements org.xml.sax.ext.DeclHandler implements org.xml.sax.ext.EntityResolver2 @extends org.xml.sax.helpers.DefaultHandler This class extends the SAX2 base handler class to support the SAX2 {@link org.xml.sax.ext.LexicalHandler}, {@link org.xml.sax.ext.DeclHandler}, and {@link org.xml.sax.ext.EntityResolver2} extensions. Except for overriding the original SAX1 {@link DefaultHandler#resolveEntity resolveEntity()} method the added handler methods just return. Subclassers may override everything on a method-by-method basis. <blockquote> <em>This module, both source code and documentation, is in the Public Domain, and comes with <strong>NO WARRANTY</strong>.</em> </blockquote> <p> <em>Note:</em> this class might yet learn that the <em>ContentHandler.setDocumentLocator()</em> call might be passed a {@link org.xml.sax.ext.Locator2} object, and that the <em>ContentHandler.startElement()</em> call might be passed a {@link org.xml.sax.ext.Attributes2} object. @since SAX 2.0 (extensions 1.1 alpha) @author David Brownell @version TBS */ var DefaultHandler2 = { /** */ startCDATA : function( ) {}, /** */ endCDATA : function( ) {}, /** */ startDTD : function( ) {}, /** */ endDTD : function( ) {}, /** */ startEntity : function( ) {}, /** */ endEntity : function( ) {}, /** */ comment : function( ) {}, /** */ attributeDecl : function( ) {}, /** */ elementDecl : function( ) {}, /** */ externalEntityDecl : function( ) {}, /** */ internalEntityDecl : function( ) {}, /**Tells the parser that if no external subset has been declared in the document text, none should be used. @param {String} name Identifies the document root element. This name comes from a DOCTYPE declaration (where available) or from the actual root element. The parameter is ignored. @param {String} baseURI The document's base URI, serving as an additional hint for selecting the external subset. This is always an absolute URI, unless it is null because the XMLReader was given an InputSource without one. The parameter is ignored. @return {Object {org.xml.sax.InputSource}} null (always). @exception SAXException Any SAX exception, possibly wrapping another exception. @exception IOException Probably indicating a failure to create a new InputStream or Reader, or an illegal URL. */ getExternalSubset : function( ) {}, /**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 {@link DefaultHandler#resolveEntity DefaultHandler.resolveEntity()}, method is overridden to call this one, this method may sometimes be invoked with null <em>name</em> and <em>baseURI</em>, and with the <em>systemId</em> already absolutized. @param {String} name Identifies the external entity being resolved. Either "[dtd]" for the external subset, or a name starting with "%" to indicate a parameter entity, or else the name of a general entity. This is never null when invoked by a SAX2 parser. @param {String} publicId The public identifier of the external entity being referenced (normalized as required by the XML specification), or null if none was supplied. @param {String} baseURI The URI with respect to which relative systemIDs are interpreted. This is always an absolute URI, unless it is null (likely because the XMLReader was given an InputSource without one). This URI is defined by the XML specification to be the one associated with the "<" starting the relevant declaration. @param {String} systemId The system identifier of the external entity being referenced; either a relative or absolute URI. This is never null when invoked by a SAX2 parser; only declared entities, and any external subset, are resolved by such parsers. @return {Object {org.xml.sax.InputSource}} An InputSource object describing the new input source. @exception SAXException Any SAX exception, possibly wrapping another exception. @exception IOException Probably indicating a failure to create a new InputStream or Reader, or an illegal URL. */ resolveEntity : function( ) {}, /**Invokes {@link org.xml.sax.ext.EntityResolver2#resolveEntity org.xml.sax.ext.EntityResolver2.resolveEntity()} with null entity name and base URI. You only need to override that method to use this class. @param {String} publicId The public identifier of the external entity being referenced (normalized as required by the XML specification), or null if none was supplied. @param {String} systemId The system identifier of the external entity being referenced; either a relative or absolute URI. This is never null when invoked by a SAX2 parser; only declared entities, and any external subset, are resolved by such parsers. @return {Object {org.xml.sax.InputSource}} An InputSource object describing the new input source. @exception SAXException Any SAX exception, possibly wrapping another exception. @exception IOException Probably indicating a failure to create a new InputStream or Reader, or an illegal URL. */ resolveEntity : function( ) {}, };