protected void read() throws IOException
{
    // Read next ParseEvent into nextParseEvent/nextType
    // and nextTag, nextStartTag (if applicable)
    // skipping comment & whitespace.
    nextParseEvent = parser.read();
    nextType = nextParseEvent.getType();
    nextTag = nextStartTag = null;
    while (nextType == Xml.COMMENT || nextType == Xml.WHITESPACE)
    {
        nextParseEvent = parser.read();
        nextType = nextParseEvent.getType();
    }
    if (nextType == Xml.END_TAG)
        nextTag = (Tag) nextParseEvent;
    else if (nextType == Xml.START_TAG)
        nextTag = nextStartTag = (StartTag) nextParseEvent;
}
protected Vector readStartTag(String expectedTagName)
throws IOException
{
    Vector attr;
    if (nextType != Xml.START_TAG ||
        !nextStartTag.getName().equals(expectedTagName))
    {
        complain("Expecting <" + expectedTagName 
  + ">");
    }
    attr = nextStartTag.getAttributes();
    read();
    return attr;
}
protected void readEndTag(String expectedTagName)
throws IOException
{
    if (nextType != Xml.END_TAG ||
        !nextTag.getName().equals(expectedTagName))
    {
        complain("Expecting ");
    }
    read();
}
 

// DTD: 
protected Box parseBox() throws IOException
{
    ArrayList objects = new ArrayList();
    readStartTag("box");
    while (true)
    {
        if (nextType == Xml.START_TAG)
        {
            if (nextStartTag.getName().equals("box"))
                objects.add(parseBox());
            else if (nextStartTag.getName().equals("cube"))
                objects.add(parseCube());
            else if (nextStartTag.getName().equals("pile"))
                objects.add(parsePile());
            else if (nextStartTag.getName().equals("pyramid"))
                objects.add(parsePyramid());
            else
                complain("Expecting , , 
  , or ");
        }
        else
            break;
    }
    readEndTag("box");
    return new Box(objects);
}
// DTD: 
protected Pile parsePile() throws IOException
{
    ArrayList objects = new ArrayList();
    readStartTag("pile");
    objects.add(parseCube());
    if (nextType == Xml.START_TAG &&
 nextStartTag.getName().equals("pyramid"))
        objects.add(parsePyramid());
    else if (nextType == Xml.START_TAG &&
 nextStartTag.getName().equals("cube"))
    {
        objects.add(parseCube());
        while (nextType == Xml.START_TAG &&
 nextStartTag.getName().equals("cube"))
            objects.add(parseCube());
        if (nextType == Xml.START_TAG && 
nextStartTag.getName().equals("pyramid"))
            objects.add(parsePyramid());
    }
    else
        complain("Expecting  or ");
    readEndTag("pile");
    return new Pile(objects);
}
 

...
/**
 * kXML-based recursive descent parser for "box world 
  scenarios" described
 * as XML documents. Reconstructs the scenario by creating 
  corresponding
 * objects.
 *
 * @author Soenke Kannapinn, Wincor-Nixdorf GmbH & Co. 
  KG
 */
public class BoxWorldParser
{
    protected BoxWorldParser(XmlParser parser) {...}
    protected void complain(String text)
       throws ParseException {...}
    protected void read()
       throws IOException {...}
    protected String readText()
       throws IOException {...}
    protected Vector readStartTag(String expectedTagName)
       throws IOException {...}
    protected void readEndTag(String expectedTagName)
       throws IOException {...}
    // DTD: 
    protected BoxWorld parseBoxWorld()
       throws IOException {...}
    // DTD: 
    protected Box parseBox()
       throws IOException {...}
    // DTD: 
    protected String parseComment()
       throws IOException {...}
    // DTD: 
    protected Cube parseCube()
       throws IOException {...}
    // DTD: 
    protected Pile parsePile()
       throws IOException {...}
    // DTD: 
    protected Pyramid parsePyramid()
       throws IOException {...}
    protected BoxWorld parseDocument()
       throws IOException {...}
    /**
     * Parse and translate an XML "box world scenario".
     *
     * @param parser The kXML parser instance to be used.
     * @return The BoxWorld meaning 
  of the XML input.
     * @exception IOException in case of IO or parse errors.
     */
    public static BoxWorld parseAndTranslate(XmlParser parser)
       throws IOException {...}
    {
        return new BoxWorldParser(parser).parseDocument();
    }
}
 

package my.box.world;
import org.xml.sax.SAXException;
import org.xml.sax.SAXParseException;
import org.xml.sax.Attributes;
import org.xml.sax.InputSource;
import org.xml.sax.XMLReader;
import org.xml.sax.helpers.XMLReaderFactory;
import java.io.IOException;
import java.util.ArrayList;
/**
 * SAX2-based parser for "box world scenarios" 
  described as XML documents.
 * Reconstructs the scenario by creating corresponding objects.
 *
 * @author Soenke Kannapinn, Wincor-Nixdorf GmbH & Co. 
  KG
 */
public class BoxWorldParser
{
    static private class MainCH extends CallableContentHandler
    {
        // DTD: 
        public MainCH(XMLReader parser) {...}
        public void startElement(String namespaceURI, String 
  localName,
               String qName, Attributes atts) throws SAXException 
  {...}
        public void endElement(String namespaceURI, String 
  localName,
               String qName) throws SAXException {...}
        public void receiveResult(Object result) {...}
        public BoxWorld parse(InputSource is)
               throws IOException, SAXException {...}
    }
    static private class CommentCH extends CallableContentHandler
    {
        // DTD: 
        public CommentCH(CallableContentHandler caller) {...}
        public void startElement(String namespaceURI, String 
  localName,
               String qName, Attributes atts) throws SAXException 
  {...}
        public void characters(char[] text, int start, int 
  length)
               throws SAXException {...}
        public void endElement(String namespaceURI, String 
  localName,
               String qName) throws SAXException {...}
    }
    static private class BoxCH extends CallableContentHandler
    {
        // DTD: 
        public BoxCH(CallableContentHandler caller) {...}
        public void startElement(String namespaceURI, String 
  localName,
               String qName, Attributes atts) throws SAXException 
  {...}
        public void endElement(String namespaceURI, String 
  localName,
               String qName) throws SAXException {...}
        public void receiveResult(Object result) {...}
    }
    static private class CubeCH extends CallableContentHandler
    {
        // DTD: 
        public CubeCH(CallableContentHandler caller) {...}
        public void startElement(String namespaceURI, String 
  localName,
               String qName, Attributes atts) throws SAXException 
  {...}
        public void endElement(String namespaceURI, String 
  localName,
               String qName) throws SAXException {...}
    }
    static private class PyramidCH extends CallableContentHandler
    {
        // DTD: 
        public PyramidCH(CallableContentHandler caller) {...}
        public void startElement(String namespaceURI, String 
  localName,
               String qName, Attributes atts) throws SAXException 
  {...}
        public void endElement(String namespaceURI, String 
  localName,
               String qName) throws SAXException
    }
    static private class PileCH extends CallableContentHandler
    {
        // DTD: 
        public PileCH(CallableContentHandler caller) {...}
        public void startElement(String namespaceURI, String 
  localName,
               String qName, Attributes atts) throws SAXException 
  {...}
        public void endElement(String namespaceURI, String 
  localName,
               String qName) throws SAXException {...}
        public void receiveResult(Object result) {...}
    }
    private BoxWorldParser() throws SAXException {}
    /**
     * Parse and translate an XML "box world scenario".
     *
     * @param parser The SAX2 parser instance to be used.
     * @param inputSource Where to get the XML input document 
  from.
     * @return The BoxWorld meaning 
  of the XML input.
     * @exception IOException in case of IO or parse errors.
     */
    public static BoxWorld parseAndTranslate(XMLReader parser,
           InputSource inputSource)
       throws IOException, SAXException, SAXParseException
    {
        return new MainCH(parser).parse(inputSource);
    }
}