src/org/xml/sax/helpers/DefaultHandler.java

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


  56  *
  57  * <p>This class is available as a convenience base class for SAX2
  58  * applications: it provides default implementations for all of the
  59  * callbacks in the four core SAX2 handler classes:</p>
  60  *
  61  * <ul>
  62  * <li>{@link org.xml.sax.EntityResolver EntityResolver}</li>
  63  * <li>{@link org.xml.sax.DTDHandler DTDHandler}</li>
  64  * <li>{@link org.xml.sax.ContentHandler ContentHandler}</li>
  65  * <li>{@link org.xml.sax.ErrorHandler ErrorHandler}</li>
  66  * </ul>
  67  *
  68  * <p>Application writers can extend this class when they need to
  69  * implement only part of an interface; parser writers can
  70  * instantiate this class to provide default handlers when the
  71  * application has not supplied its own.</p>
  72  *
  73  * <p>This class replaces the deprecated SAX1
  74  * {@link org.xml.sax.HandlerBase HandlerBase} class.</p>
  75  *
  76  * @since SAX 2.0
  77  * @author David Megginson,
  78  * @see org.xml.sax.EntityResolver
  79  * @see org.xml.sax.DTDHandler
  80  * @see org.xml.sax.ContentHandler
  81  * @see org.xml.sax.ErrorHandler
  82  */
  83 public class DefaultHandler
  84     implements EntityResolver, DTDHandler, ContentHandler, ErrorHandler
  85 {
  86 
  87 
  88     ////////////////////////////////////////////////////////////////////
  89     // Default implementation of the EntityResolver interface.
  90     ////////////////////////////////////////////////////////////////////
  91 
  92     /**
  93      * Resolve an external entity.
  94      *
  95      * <p>Always return null, so that the parser will use the system
  96      * identifier provided in the XML document.  This method implements




  56  *
  57  * <p>This class is available as a convenience base class for SAX2
  58  * applications: it provides default implementations for all of the
  59  * callbacks in the four core SAX2 handler classes:</p>
  60  *
  61  * <ul>
  62  * <li>{@link org.xml.sax.EntityResolver EntityResolver}</li>
  63  * <li>{@link org.xml.sax.DTDHandler DTDHandler}</li>
  64  * <li>{@link org.xml.sax.ContentHandler ContentHandler}</li>
  65  * <li>{@link org.xml.sax.ErrorHandler ErrorHandler}</li>
  66  * </ul>
  67  *
  68  * <p>Application writers can extend this class when they need to
  69  * implement only part of an interface; parser writers can
  70  * instantiate this class to provide default handlers when the
  71  * application has not supplied its own.</p>
  72  *
  73  * <p>This class replaces the deprecated SAX1
  74  * {@link org.xml.sax.HandlerBase HandlerBase} class.</p>
  75  *
  76  * @since 1.4, SAX 2.0
  77  * @author David Megginson,
  78  * @see org.xml.sax.EntityResolver
  79  * @see org.xml.sax.DTDHandler
  80  * @see org.xml.sax.ContentHandler
  81  * @see org.xml.sax.ErrorHandler
  82  */
  83 public class DefaultHandler
  84     implements EntityResolver, DTDHandler, ContentHandler, ErrorHandler
  85 {
  86 
  87 
  88     ////////////////////////////////////////////////////////////////////
  89     // Default implementation of the EntityResolver interface.
  90     ////////////////////////////////////////////////////////////////////
  91 
  92     /**
  93      * Resolve an external entity.
  94      *
  95      * <p>Always return null, so that the parser will use the system
  96      * identifier provided in the XML document.  This method implements