Google

Xerces 3.1.1 API: Class HandlerBase
Overview  Package   Class  Tree  Deprecated  Index  Help 
Xerces 3.1.1
 PREV CLASS  FRAMES    NO FRAMES
SUMMARY:  INNER | FIELD | CONSTR | METHOD DETAIL:  FIELD | CONSTR | METHOD


Class HandlerBase

java.lang.Object
  |
Deprecated. This class works with the deprecated interface. It has been replaced by the SAX2 class.

Default base class for handlers.

This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY.

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 class instead.

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.

Note that the use of this class is optional.

Since:
SAX 1.0
Version:
2.0


          Deprecated.  
Constructor Summary
  int start, int length)
          Deprecated. Receive notification of character data inside an element.
          Deprecated. Receive notification of the end of the document.
          Deprecated. Receive notification of the end of an element.
          Deprecated. Receive notification of a recoverable parser error.
          Deprecated. Report a fatal XML parsing error. int start, int length)
          Deprecated. Receive notification of ignorable whitespace in element content. java.lang.String publicId, java.lang.String systemId)
          Deprecated. Receive notification of a notation declaration. java.lang.String data)
          Deprecated. Receive notification of a processing instruction.
          Deprecated. Receive a Locator object for document events.
          Deprecated. Receive notification of the beginning of the document.
          Deprecated. Receive notification of the start of an element. java.lang.String publicId, java.lang.String systemId, java.lang.String notationName)
          Deprecated. Receive notification of an unparsed entity declaration.
          Deprecated. Receive notification of a parser warning.
Method Summary
 void
 void
 void
 void
 void
 void
 void
 void
java.lang.String systemId)
          Deprecated. Resolve an external entity.
 void
 void
 void
 void
 void
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

HandlerBase

public HandlerBase()
Deprecated. 
Method Detail

resolveEntity

                                 java.lang.String systemId)



Deprecated. 
Resolve an external entity.

 
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.






Parameters:
publicId - The public identifer, or null if none is
                 available.
systemId - The system identifier provided in the XML 
                 document.
Returns:
The new input source, or null to require the









notationDecl


public void notationDecl(java.lang.String name,
                         java.lang.String publicId,
                         java.lang.String systemId)




Deprecated. 
Receive notification of a notation declaration.

 
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.






Parameters:
name - The notation name.
publicId - The notation public identifier, or null if not









unparsedEntityDecl


public void unparsedEntityDecl(java.lang.String name,
                               java.lang.String publicId,
                               java.lang.String systemId,
                               java.lang.String notationName)




Deprecated. 
Receive notification of an unparsed entity declaration.

 
By default, do nothing.  Application writers may override this
 method in a subclass to keep track of the unparsed entities
 declared in a document.






Parameters:
name - The entity name.
publicId - The entity public identifier, or null if not







setDocumentLocator



Deprecated. 
Receive a Locator object for document events.

 
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.














startDocument


public void startDocument()



Deprecated. 
Receive notification of the beginning of the document.

 
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).














endDocument


public void endDocument()



Deprecated. 
Receive notification of the end of the document.

 
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).












startElement

public void startElement(java.lang.String name,



Deprecated. 
Receive notification of the start of an element.

 
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).














endElement


public void endElement(java.lang.String name)



Deprecated. 
Receive notification of the end of an element.

 
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).














characters


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



Deprecated. 
Receive notification of character data inside an element.

 
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).






Parameters:
ch - The characters.
start - The start position in the character array.
length - The number of characters to use from the









ignorableWhitespace


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



Deprecated. 
Receive notification of ignorable whitespace in element content.

 
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).






Parameters:
ch - The whitespace characters.
start - The start position in the character array.
length - The number of characters to use from the









processingInstruction


public void processingInstruction(java.lang.String target,
                                  java.lang.String data)



Deprecated. 
Receive notification of a processing instruction.

 
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.






Parameters:
target - The processing instruction target.
data - The processing instruction data, or null if







warning



Deprecated. 
Receive notification of a parser warning.

 
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.












error



Deprecated. 
Receive notification of a recoverable parser error.

 
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.












fatalError



Deprecated. 
Report a fatal XML parsing error.

 
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.























  

      Overview 
      Package 
    Class 
      Tree 
      Deprecated 
      Index 
      Help 
  





Xerces 3.1.1







 PREV CLASS 

  FRAMES   
 NO FRAMES





  SUMMARY:  INNER | FIELD | CONSTR | METHOD

DETAIL:  FIELD | CONSTR | METHOD