src/org/xml/sax/HandlerBase.java

Print this page
rev 602 : 8047723: @since tag cleanup in jaxp
Reviewed-by:


  42  *
  43  * <p>This class implements the default behaviour for four SAX1
  44  * interfaces: EntityResolver, DTDHandler, DocumentHandler,
  45  * and ErrorHandler.  It is now obsolete, but is included in SAX2 to
  46  * support legacy SAX1 applications.  SAX2 applications should use
  47  * the {@link org.xml.sax.helpers.DefaultHandler DefaultHandler}
  48  * class instead.</p>
  49  *
  50  * <p>Application writers can extend this class when they need to
  51  * implement only part of an interface; parser writers can
  52  * instantiate this class to provide default handlers when the
  53  * application has not supplied its own.</p>
  54  *
  55  * <p>Note that the use of this class is optional.</p>
  56  *
  57  * @deprecated This class works with the deprecated
  58  *             {@link org.xml.sax.DocumentHandler DocumentHandler}
  59  *             interface.  It has been replaced by the SAX2
  60  *             {@link org.xml.sax.helpers.DefaultHandler DefaultHandler}
  61  *             class.
  62  * @since SAX 1.0
  63  * @author David Megginson
  64  * @see org.xml.sax.EntityResolver
  65  * @see org.xml.sax.DTDHandler
  66  * @see org.xml.sax.DocumentHandler
  67  * @see org.xml.sax.ErrorHandler
  68  */
  69 public class HandlerBase
  70     implements EntityResolver, DTDHandler, DocumentHandler, ErrorHandler
  71 {
  72 
  73 
  74     ////////////////////////////////////////////////////////////////////
  75     // Default implementation of the EntityResolver interface.
  76     ////////////////////////////////////////////////////////////////////
  77 
  78     /**
  79      * Resolve an external entity.
  80      *
  81      * <p>Always return null, so that the parser will use the system
  82      * identifier provided in the XML document.  This method implements




  42  *
  43  * <p>This class implements the default behaviour for four SAX1
  44  * interfaces: EntityResolver, DTDHandler, DocumentHandler,
  45  * and ErrorHandler.  It is now obsolete, but is included in SAX2 to
  46  * support legacy SAX1 applications.  SAX2 applications should use
  47  * the {@link org.xml.sax.helpers.DefaultHandler DefaultHandler}
  48  * class instead.</p>
  49  *
  50  * <p>Application writers can extend this class when they need to
  51  * implement only part of an interface; parser writers can
  52  * instantiate this class to provide default handlers when the
  53  * application has not supplied its own.</p>
  54  *
  55  * <p>Note that the use of this class is optional.</p>
  56  *
  57  * @deprecated This class works with the deprecated
  58  *             {@link org.xml.sax.DocumentHandler DocumentHandler}
  59  *             interface.  It has been replaced by the SAX2
  60  *             {@link org.xml.sax.helpers.DefaultHandler DefaultHandler}
  61  *             class.
  62  * @since 1.4, SAX 1.0
  63  * @author David Megginson
  64  * @see org.xml.sax.EntityResolver
  65  * @see org.xml.sax.DTDHandler
  66  * @see org.xml.sax.DocumentHandler
  67  * @see org.xml.sax.ErrorHandler
  68  */
  69 public class HandlerBase
  70     implements EntityResolver, DTDHandler, DocumentHandler, ErrorHandler
  71 {
  72 
  73 
  74     ////////////////////////////////////////////////////////////////////
  75     // Default implementation of the EntityResolver interface.
  76     ////////////////////////////////////////////////////////////////////
  77 
  78     /**
  79      * Resolve an external entity.
  80      *
  81      * <p>Always return null, so that the parser will use the system
  82      * identifier provided in the XML document.  This method implements