6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 // ContentHandler.java - handle main document content.
  27 // http://www.saxproject.org
  28 // Written by David Megginson
  29 // NO WARRANTY!  This class is in the public domain.
  30 // $Id: ContentHandler.java,v 1.2 2004/11/03 22:44:51 jsuttor Exp $
  31 
  32 package org.xml.sax;
  33 
  34 
  35 /**
  36  * Receive notification of the logical content of a document.
  37  *
  38  * <blockquote>
  39  * <em>This module, both source code and documentation, is in the
  40  * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
  41  * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
  42  * for further information.
  43  * </blockquote>
  44  *
  45  * <p>This is the main interface that most SAX applications
  46  * implement: if the application needs to be informed of basic parsing
  47  * events, it implements this interface and registers an instance with
  48  * the SAX parser using the {@link org.xml.sax.XMLReader#setContentHandler
  49  * setContentHandler} method.  The parser uses the instance to report
  50  * basic document-related events like the start and end of elements
  51  * and character data.</p>
  52  *
  53  * <p>The order of events in this interface is very important, and
  54  * mirrors the order of information in the document itself.  For
  55  * example, all of an element's content (character data, processing
  56  * instructions, and/or subelements) will appear, in order, between
  57  * the startElement event and the corresponding endElement event.</p>
  58  *
  59  * <p>This interface is similar to the now-deprecated SAX 1.0
  60  * DocumentHandler interface, but it adds support for Namespaces
  61  * and for reporting skipped entities (in non-validating XML
  62  * processors).</p>
  63  *
  64  * <p>Implementors should note that there is also a

   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 






  26 package org.xml.sax;
  27 
  28 
  29 /**
  30  * Receive notification of the logical content of a document.
  31  *







  32  * <p>This is the main interface that most SAX applications
  33  * implement: if the application needs to be informed of basic parsing
  34  * events, it implements this interface and registers an instance with
  35  * the SAX parser using the {@link org.xml.sax.XMLReader#setContentHandler
  36  * setContentHandler} method.  The parser uses the instance to report
  37  * basic document-related events like the start and end of elements
  38  * and character data.</p>
  39  *
  40  * <p>The order of events in this interface is very important, and
  41  * mirrors the order of information in the document itself.  For
  42  * example, all of an element's content (character data, processing
  43  * instructions, and/or subelements) will appear, in order, between
  44  * the startElement event and the corresponding endElement event.</p>
  45  *
  46  * <p>This interface is similar to the now-deprecated SAX 1.0
  47  * DocumentHandler interface, but it adds support for Namespaces
  48  * and for reporting skipped entities (in non-validating XML
  49  * processors).</p>
  50  *
  51  * <p>Implementors should note that there is also a