jdk.internal.org.xml.sax.InputSource Java Examples

/**
 * Parse the content given {@link org.xml.sax.InputSource} as XML using the
 * specified {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param handler The SAX DefaultHandler to use.
 * @exception IOException If any IO errors occur.
 * @exception IllegalArgumentException If the InputSource or handler is
 * null.
 * @exception SAXException If the underlying parser throws a SAXException
 * while parsing.
 * @see org.xml.sax.helpers.DefaultHandler
 */
public void parse(InputSource is, DefaultHandler handler)
    throws SAXException, IOException
{
    if ((is == null) || (handler == null)) {
        throw new IllegalArgumentException("");
    }
    //              Set up the handler
    mHandCont = handler;
    mHandDtd = handler;
    mHandErr = handler;
    mHandEnt = handler;
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException | IOException | RuntimeException saxe) {
        throw saxe;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource}
 * as XML using the specified
 * {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the <code>InputSource</code> object
 *   is <code>null</code>.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(InputSource is, DefaultHandler dh)
    throws SAXException, IOException
{
    if (is == null) {
        throw new IllegalArgumentException("InputSource cannot be null");
    }

    XMLReader reader = this.getXMLReader();
    if (dh != null) {
        reader.setContentHandler(dh);
        reader.setEntityResolver(dh);
        reader.setErrorHandler(dh);
        reader.setDTDHandler(dh);
    }
    reader.parse(is);
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource}
 * as XML using the specified
 * {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the <code>InputSource</code> object
 *   is <code>null</code>.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(InputSource is, DefaultHandler dh)
    throws SAXException, IOException
{
    if (is == null) {
        throw new IllegalArgumentException("InputSource cannot be null");
    }

    XMLReader reader = this.getXMLReader();
    if (dh != null) {
        reader.setContentHandler(dh);
        reader.setEntityResolver(dh);
        reader.setErrorHandler(dh);
        reader.setDTDHandler(dh);
    }
    reader.parse(is);
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource}
 * as XML using the specified
 * {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the <code>InputSource</code> object
 *   is <code>null</code>.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(InputSource is, DefaultHandler dh)
    throws SAXException, IOException
{
    if (is == null) {
        throw new IllegalArgumentException("InputSource cannot be null");
    }

    XMLReader reader = this.getXMLReader();
    if (dh != null) {
        reader.setContentHandler(dh);
        reader.setEntityResolver(dh);
        reader.setErrorHandler(dh);
        reader.setDTDHandler(dh);
    }
    reader.parse(is);
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource}
 * as XML using the specified
 * {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the <code>InputSource</code> object
 *   is <code>null</code>.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(InputSource is, DefaultHandler dh)
    throws SAXException, IOException
{
    if (is == null) {
        throw new IllegalArgumentException("InputSource cannot be null");
    }

    XMLReader reader = this.getXMLReader();
    if (dh != null) {
        reader.setContentHandler(dh);
        reader.setEntityResolver(dh);
        reader.setErrorHandler(dh);
        reader.setDTDHandler(dh);
    }
    reader.parse(is);
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource} as XML using the
 * specified {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param handler The SAX DefaultHandler to use.
 * @exception IOException If any IO errors occur.
 * @exception IllegalArgumentException If the InputSource or handler is
 * null.
 * @exception SAXException If the underlying parser throws a SAXException
 * while parsing.
 * @see org.xml.sax.helpers.DefaultHandler
 */
public void parse(InputSource is, DefaultHandler handler)
    throws SAXException, IOException
{
    if ((is == null) || (handler == null)) {
        throw new IllegalArgumentException("");
    }
    //              Set up the handler
    mHandCont = handler;
    mHandDtd = handler;
    mHandErr = handler;
    mHandEnt = handler;
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException | IOException | RuntimeException saxe) {
        throw saxe;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource}
 * as XML using the specified
 * {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the <code>InputSource</code> object
 *   is <code>null</code>.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(InputSource is, DefaultHandler dh)
    throws SAXException, IOException
{
    if (is == null) {
        throw new IllegalArgumentException("InputSource cannot be null");
    }

    XMLReader reader = this.getXMLReader();
    if (dh != null) {
        reader.setContentHandler(dh);
        reader.setEntityResolver(dh);
        reader.setErrorHandler(dh);
        reader.setDTDHandler(dh);
    }
    reader.parse(is);
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource} as XML using the
 * specified {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param handler The SAX DefaultHandler to use.
 * @exception IOException If any IO errors occur.
 * @exception IllegalArgumentException If the InputSource or handler is
 * null.
 * @exception SAXException If the underlying parser throws a SAXException
 * while parsing.
 * @see org.xml.sax.helpers.DefaultHandler
 */
public void parse(InputSource is, DefaultHandler handler)
    throws SAXException, IOException
{
    if ((is == null) || (handler == null)) {
        throw new IllegalArgumentException("");
    }
    //              Set up the handler
    mHandCont = handler;
    mHandDtd = handler;
    mHandErr = handler;
    mHandEnt = handler;
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException | IOException | RuntimeException saxe) {
        throw saxe;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource} as XML using the
 * specified {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param handler The SAX DefaultHandler to use.
 * @exception IOException If any IO errors occur.
 * @exception IllegalArgumentException If the InputSource or handler is
 * null.
 * @exception SAXException If the underlying parser throws a SAXException
 * while parsing.
 * @see org.xml.sax.helpers.DefaultHandler
 */
public void parse(InputSource is, DefaultHandler handler)
    throws SAXException, IOException
{
    if ((is == null) || (handler == null)) {
        throw new IllegalArgumentException("");
    }
    //              Set up the handler
    mHandCont = handler;
    mHandDtd = handler;
    mHandErr = handler;
    mHandEnt = handler;
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException | IOException | RuntimeException saxe) {
        throw saxe;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource}
 * as XML using the specified
 * {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the <code>InputSource</code> object
 *   is <code>null</code>.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(InputSource is, DefaultHandler dh)
    throws SAXException, IOException
{
    if (is == null) {
        throw new IllegalArgumentException("InputSource cannot be null");
    }

    XMLReader reader = this.getXMLReader();
    if (dh != null) {
        reader.setContentHandler(dh);
        reader.setEntityResolver(dh);
        reader.setErrorHandler(dh);
        reader.setDTDHandler(dh);
    }
    reader.parse(is);
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource} as XML using the
 * specified {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param handler The SAX DefaultHandler to use.
 * @exception IOException If any IO errors occur.
 * @exception IllegalArgumentException If the InputSource or handler is
 * null.
 * @exception SAXException If the underlying parser throws a SAXException
 * while parsing.
 * @see org.xml.sax.helpers.DefaultHandler
 */
public void parse(InputSource is, DefaultHandler handler)
    throws SAXException, IOException
{
    if ((is == null) || (handler == null)) {
        throw new IllegalArgumentException("");
    }
    //              Set up the handler
    mHandCont = handler;
    mHandDtd = handler;
    mHandErr = handler;
    mHandEnt = handler;
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException | IOException | RuntimeException saxe) {
        throw saxe;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource}
 * as XML using the specified
 * {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the <code>InputSource</code> object
 *   is <code>null</code>.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(InputSource is, DefaultHandler dh)
    throws SAXException, IOException
{
    if (is == null) {
        throw new IllegalArgumentException("InputSource cannot be null");
    }

    XMLReader reader = this.getXMLReader();
    if (dh != null) {
        reader.setContentHandler(dh);
        reader.setEntityResolver(dh);
        reader.setErrorHandler(dh);
        reader.setDTDHandler(dh);
    }
    reader.parse(is);
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource} as XML using the
 * specified {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param handler The SAX DefaultHandler to use.
 * @exception IOException If any IO errors occur.
 * @exception IllegalArgumentException If the InputSource or handler is
 * null.
 * @exception SAXException If the underlying parser throws a SAXException
 * while parsing.
 * @see org.xml.sax.helpers.DefaultHandler
 */
public void parse(InputSource is, DefaultHandler handler)
    throws SAXException, IOException
{
    if ((is == null) || (handler == null)) {
        throw new IllegalArgumentException("");
    }
    //              Set up the handler
    mHandCont = handler;
    mHandDtd = handler;
    mHandErr = handler;
    mHandEnt = handler;
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException | IOException | RuntimeException saxe) {
        throw saxe;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Parse the content given {@link org.xml.sax.InputSource}
 * as XML using the specified
 * {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param is The InputSource containing the content to be parsed.
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the <code>InputSource</code> object
 *   is <code>null</code>.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(InputSource is, DefaultHandler dh)
    throws SAXException, IOException
{
    if (is == null) {
        throw new IllegalArgumentException("InputSource cannot be null");
    }

    XMLReader reader = this.getXMLReader();
    if (dh != null) {
        reader.setContentHandler(dh);
        reader.setEntityResolver(dh);
        reader.setErrorHandler(dh);
        reader.setDTDHandler(dh);
    }
    reader.parse(is);
}
 

/**
 * Parse the content of the file specified as XML using the
 * specified {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param f The file containing the XML to parse
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the File object is null.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(File f, DefaultHandler dh)
    throws SAXException, IOException
{
    if (f == null) {
        throw new IllegalArgumentException("File cannot be null");
    }

    //convert file to appropriate URI, f.toURI().toASCIIString()
    //converts the URI to string as per rule specified in
    //RFC 2396,
    InputSource input = new InputSource(f.toURI().toASCIIString());
    this.parse(input, dh);
}
 

/**
 * Parse the content of the file specified as XML using the
 * specified {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param f The file containing the XML to parse
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the File object is null.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(File f, DefaultHandler dh)
    throws SAXException, IOException
{
    if (f == null) {
        throw new IllegalArgumentException("File cannot be null");
    }

    //convert file to appropriate URI, f.toURI().toASCIIString()
    //converts the URI to string as per rule specified in
    //RFC 2396,
    InputSource input = new InputSource(f.toURI().toASCIIString());
    this.parse(input, dh);
}
 

/**
 * Parse the content of the file specified as XML using the
 * specified {@link org.xml.sax.helpers.DefaultHandler}.
 *
 * @param f The file containing the XML to parse
 * @param dh The SAX DefaultHandler to use.
 *
 * @throws IllegalArgumentException If the File object is null.
 * @throws IOException If any IO errors occur.
 * @throws SAXException If any SAX errors occur during processing.
 *
 * @see org.xml.sax.DocumentHandler
 */
public void parse(File f, DefaultHandler dh)
    throws SAXException, IOException
{
    if (f == null) {
        throw new IllegalArgumentException("File cannot be null");
    }

    //convert file to appropriate URI, f.toURI().toASCIIString()
    //converts the URI to string as per rule specified in
    //RFC 2396,
    InputSource input = new InputSource(f.toURI().toASCIIString());
    this.parse(input, dh);
}
 

/**
 * Parse an XML document.
 *
 * <p>The application can use this method to instruct the XML reader to
 * begin parsing an XML document from any valid input source (a character
 * stream, a byte stream, or a URI).</p>
 *
 * <p>Applications may not invoke this method while a parse is in progress
 * (they should create a new XMLReader instead for each nested XML
 * document). Once a parse is complete, an application may reuse the same
 * XMLReader object, possibly with a different input source.</p>
 *
 * <p>During the parse, the XMLReader will provide information about the XML
 * document through the registered event handlers.</p>
 *
 * <p>This method is synchronous: it will not return until parsing has
 * ended. If a client application wants to terminate parsing early, it
 * should throw an exception.</p>
 *
 * @param is The input source for the top-level of the XML document.
 * @exception org.xml.sax.SAXException Any SAX exception, possibly wrapping
 * another exception.
 * @exception java.io.IOException An IO exception from the parser, possibly
 * from a byte stream or character stream supplied by the application.
 * @see org.xml.sax.InputSource
 * @see #parse(java.lang.String)
 * @see #setEntityResolver
 * @see #setDTDHandler
 * @see #setContentHandler
 * @see #setErrorHandler
 */
public void parse(InputSource is) throws IOException, SAXException {
    if (is == null) {
        throw new IllegalArgumentException("");
    }
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException saxe) {
        throw saxe;
    } catch (IOException ioe) {
        throw ioe;
    } catch (RuntimeException rte) {
        throw rte;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Sets up a new input source on the top of the input stack. Note, the first
 * byte returned by the entity's byte stream has to be the first byte in the
 * entity. However, the parser does not expect the byte order mask in both
 * cases when encoding is provided by the input source.
 *
 * @param is A new input source to set up.
 * @exception IOException If any IO errors occur.
 * @exception Exception is parser specific exception form panic method.
 */
protected void setinp(InputSource is)
        throws Exception {
    Reader reader = null;
    mChIdx = 0;
    mChLen = 0;
    mChars = mInp.chars;
    mInp.src = null;
    if (mPh < PH_DOC_START) {
        mIsSAlone = false;  // default [#2.9]
    }
    mIsSAloneSet = false;
    if (is.getCharacterStream() != null) {
        //          Ignore encoding in the xml text decl.
        reader = is.getCharacterStream();
        xml(reader);
    } else if (is.getByteStream() != null) {
        String expenc;
        if (is.getEncoding() != null) {
            //              Ignore encoding in the xml text decl.
            expenc = is.getEncoding().toUpperCase();
            if (expenc.equals("UTF-16")) {
                reader = bom(is.getByteStream(), 'U');  // UTF-16 [#4.3.3]
            } else {
                reader = enc(expenc, is.getByteStream());
            }
            xml(reader);
        } else {
            //              Get encoding from BOM or the xml text decl.
            reader = bom(is.getByteStream(), ' ');
            if (reader == null) {
                //          Encoding is defined by the xml text decl.
                reader = enc("UTF-8", is.getByteStream());
                expenc = xml(reader);
                if (expenc.startsWith("UTF-16")) {
                    panic(FAULT);  // UTF-16 must have BOM [#4.3.3]
                }
                reader = enc(expenc, is.getByteStream());
            } else {
                //          Encoding is defined by the BOM.
                xml(reader);
            }
        }
    } else {
        //          There is no support for public/system identifiers.
        panic(FAULT);
    }
    mInp.src = reader;
    mInp.pubid = is.getPublicId();
    mInp.sysid = is.getSystemId();
}
 

/**
 * Resoves a parameter entity.
 *
 * This method resolves a parameter entity references. It is also reports
 * external entities to the application.
 *
 * @param flag The '-' instruct the method to do not set up surrounding
 * spaces [#4.4.8].
 * @exception Exception is parser specific exception form panic method.
 * @exception IOException
 */
@SuppressWarnings("fallthrough")
private void pent(char flag) throws Exception {
    char ch;
    int idx = mBuffIdx + 1;
    Input inp = null;
    String str = null;
    bappend('%');
    if (mPh != PH_DTD) // the DTD internal subset
    {
        return;         // Not Recognized [#4.4.1]
    }               //              Read entity name
    bname(false);
    str = new String(mBuff, idx + 2, mBuffIdx - idx - 1);
    if (getch() != ';') {
        panic(FAULT);
    }
    inp = mPEnt.get(str);
    //              Restore the buffer offset
    mBuffIdx = idx - 1;
    if (inp != null) {
        if (inp.chars == null) {
            //              External parameter entity
            InputSource is = resolveEnt(str, inp.pubid, inp.sysid);
            if (is != null) {
                if (flag != '-') {
                    bappend(' ');  // tail space
                }
                push(new Input(BUFFSIZE_READER));
                // BUG: there is no leading space! [#4.4.8]
                setinp(is);
                mInp.pubid = inp.pubid;
                mInp.sysid = inp.sysid;
            } else {
                //          Unresolved external parameter entity
                skippedEnt("%" + str);
            }
        } else {
            //              Internal parameter entity
            if (flag == '-') {
                //          No surrounding spaces
                inp.chIdx = 1;
            } else {
                //          Insert surrounding spaces
                bappend(' ');  // tail space
                inp.chIdx = 0;
            }
            push(inp);
        }
    } else {
        //          Unknown parameter entity
        skippedEnt("%" + str);
    }
}
 

/**
 * Sets up a new input source on the top of the input stack. Note, the first
 * byte returned by the entity's byte stream has to be the first byte in the
 * entity. However, the parser does not expect the byte order mask in both
 * cases when encoding is provided by the input source.
 *
 * @param is A new input source to set up.
 * @exception IOException If any IO errors occur.
 * @exception Exception is parser specific exception form panic method.
 */
protected void setinp(InputSource is)
        throws Exception {
    Reader reader = null;
    mChIdx = 0;
    mChLen = 0;
    mChars = mInp.chars;
    mInp.src = null;
    if (mPh < PH_DOC_START) {
        mIsSAlone = false;  // default [#2.9]
    }
    mIsSAloneSet = false;
    if (is.getCharacterStream() != null) {
        //          Ignore encoding in the xml text decl.
        reader = is.getCharacterStream();
        xml(reader);
    } else if (is.getByteStream() != null) {
        String expenc;
        if (is.getEncoding() != null) {
            //              Ignore encoding in the xml text decl.
            expenc = is.getEncoding().toUpperCase();
            if (expenc.equals("UTF-16")) {
                reader = bom(is.getByteStream(), 'U');  // UTF-16 [#4.3.3]
            } else {
                reader = enc(expenc, is.getByteStream());
            }
            xml(reader);
        } else {
            //              Get encoding from BOM or the xml text decl.
            reader = bom(is.getByteStream(), ' ');
            if (reader == null) {
                //          Encoding is defined by the xml text decl.
                reader = enc("UTF-8", is.getByteStream());
                expenc = xml(reader);
                if (expenc.startsWith("UTF-16")) {
                    panic(FAULT);  // UTF-16 must have BOM [#4.3.3]
                }
                reader = enc(expenc, is.getByteStream());
            } else {
                //          Encoding is defined by the BOM.
                xml(reader);
            }
        }
    } else {
        //          There is no support for public/system identifiers.
        panic(FAULT);
    }
    mInp.src = reader;
    mInp.pubid = is.getPublicId();
    mInp.sysid = is.getSystemId();
}
 

/**
 * Parse an XML document.
 *
 * <p>The application can use this method to instruct the XML reader to
 * begin parsing an XML document from any valid input source (a character
 * stream, a byte stream, or a URI).</p>
 *
 * <p>Applications may not invoke this method while a parse is in progress
 * (they should create a new XMLReader instead for each nested XML
 * document). Once a parse is complete, an application may reuse the same
 * XMLReader object, possibly with a different input source.</p>
 *
 * <p>During the parse, the XMLReader will provide information about the XML
 * document through the registered event handlers.</p>
 *
 * <p>This method is synchronous: it will not return until parsing has
 * ended. If a client application wants to terminate parsing early, it
 * should throw an exception.</p>
 *
 * @param is The input source for the top-level of the XML document.
 * @exception org.xml.sax.SAXException Any SAX exception, possibly wrapping
 * another exception.
 * @exception java.io.IOException An IO exception from the parser, possibly
 * from a byte stream or character stream supplied by the application.
 * @see org.xml.sax.InputSource
 * @see #parse(java.lang.String)
 * @see #setEntityResolver
 * @see #setDTDHandler
 * @see #setContentHandler
 * @see #setErrorHandler
 */
public void parse(InputSource is) throws IOException, SAXException {
    if (is == null) {
        throw new IllegalArgumentException("");
    }
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException saxe) {
        throw saxe;
    } catch (IOException ioe) {
        throw ioe;
    } catch (RuntimeException rte) {
        throw rte;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Resoves a parameter entity.
 *
 * This method resolves a parameter entity references. It is also reports
 * external entities to the application.
 *
 * @param flag The '-' instruct the method to do not set up surrounding
 * spaces [#4.4.8].
 * @exception Exception is parser specific exception form panic method.
 * @exception IOException
 */
@SuppressWarnings("fallthrough")
private void pent(char flag) throws Exception {
    char ch;
    int idx = mBuffIdx + 1;
    Input inp = null;
    String str = null;
    bappend('%');
    if (mPh != PH_DTD) // the DTD internal subset
    {
        return;         // Not Recognized [#4.4.1]
    }               //              Read entity name
    bname(false);
    str = new String(mBuff, idx + 2, mBuffIdx - idx - 1);
    if (getch() != ';') {
        panic(FAULT);
    }
    inp = mPEnt.get(str);
    //              Restore the buffer offset
    mBuffIdx = idx - 1;
    if (inp != null) {
        if (inp.chars == null) {
            //              External parameter entity
            InputSource is = resolveEnt(str, inp.pubid, inp.sysid);
            if (is != null) {
                if (flag != '-') {
                    bappend(' ');  // tail space
                }
                push(new Input(BUFFSIZE_READER));
                // BUG: there is no leading space! [#4.4.8]
                setinp(is);
                mInp.pubid = inp.pubid;
                mInp.sysid = inp.sysid;
            } else {
                //          Unresolved external parameter entity
                skippedEnt("%" + str);
            }
        } else {
            //              Internal parameter entity
            if (flag == '-') {
                //          No surrounding spaces
                inp.chIdx = 1;
            } else {
                //          Insert surrounding spaces
                bappend(' ');  // tail space
                inp.chIdx = 0;
            }
            push(inp);
        }
    } else {
        //          Unknown parameter entity
        skippedEnt("%" + str);
    }
}
 

/**
 * Parse an XML document.
 *
 * <p>The application can use this method to instruct the XML reader to
 * begin parsing an XML document from any valid input source (a character
 * stream, a byte stream, or a URI).</p>
 *
 * <p>Applications may not invoke this method while a parse is in progress
 * (they should create a new XMLReader instead for each nested XML
 * document). Once a parse is complete, an application may reuse the same
 * XMLReader object, possibly with a different input source.</p>
 *
 * <p>During the parse, the XMLReader will provide information about the XML
 * document through the registered event handlers.</p>
 *
 * <p>This method is synchronous: it will not return until parsing has
 * ended. If a client application wants to terminate parsing early, it
 * should throw an exception.</p>
 *
 * @param is The input source for the top-level of the XML document.
 * @exception org.xml.sax.SAXException Any SAX exception, possibly wrapping
 * another exception.
 * @exception java.io.IOException An IO exception from the parser, possibly
 * from a byte stream or character stream supplied by the application.
 * @see org.xml.sax.InputSource
 * @see #parse(java.lang.String)
 * @see #setEntityResolver
 * @see #setDTDHandler
 * @see #setContentHandler
 * @see #setErrorHandler
 */
public void parse(InputSource is) throws IOException, SAXException {
    if (is == null) {
        throw new IllegalArgumentException("");
    }
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException saxe) {
        throw saxe;
    } catch (IOException ioe) {
        throw ioe;
    } catch (RuntimeException rte) {
        throw rte;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Resoves a parameter entity.
 *
 * This method resolves a parameter entity references. It is also reports
 * external entities to the application.
 *
 * @param flag The '-' instruct the method to do not set up surrounding
 * spaces [#4.4.8].
 * @exception Exception is parser specific exception form panic method.
 * @exception IOException
 */
@SuppressWarnings("fallthrough")
private void pent(char flag) throws Exception {
    char ch;
    int idx = mBuffIdx + 1;
    Input inp = null;
    String str = null;
    bappend('%');
    if (mPh != PH_DTD) // the DTD internal subset
    {
        return;         // Not Recognized [#4.4.1]
    }               //              Read entity name
    bname(false);
    str = new String(mBuff, idx + 2, mBuffIdx - idx - 1);
    if (getch() != ';') {
        panic(FAULT);
    }
    inp = mPEnt.get(str);
    //              Restore the buffer offset
    mBuffIdx = idx - 1;
    if (inp != null) {
        if (inp.chars == null) {
            //              External parameter entity
            InputSource is = resolveEnt(str, inp.pubid, inp.sysid);
            if (is != null) {
                if (flag != '-') {
                    bappend(' ');  // tail space
                }
                push(new Input(BUFFSIZE_READER));
                // BUG: there is no leading space! [#4.4.8]
                setinp(is);
                mInp.pubid = inp.pubid;
                mInp.sysid = inp.sysid;
            } else {
                //          Unresolved external parameter entity
                skippedEnt("%" + str);
            }
        } else {
            //              Internal parameter entity
            if (flag == '-') {
                //          No surrounding spaces
                inp.chIdx = 1;
            } else {
                //          Insert surrounding spaces
                bappend(' ');  // tail space
                inp.chIdx = 0;
            }
            push(inp);
        }
    } else {
        //          Unknown parameter entity
        skippedEnt("%" + str);
    }
}
 

/**
 * Parse an XML document.
 *
 * <p>The application can use this method to instruct the XML reader to
 * begin parsing an XML document from any valid input source (a character
 * stream, a byte stream, or a URI).</p>
 *
 * <p>Applications may not invoke this method while a parse is in progress
 * (they should create a new XMLReader instead for each nested XML
 * document). Once a parse is complete, an application may reuse the same
 * XMLReader object, possibly with a different input source.</p>
 *
 * <p>During the parse, the XMLReader will provide information about the XML
 * document through the registered event handlers.</p>
 *
 * <p>This method is synchronous: it will not return until parsing has
 * ended. If a client application wants to terminate parsing early, it
 * should throw an exception.</p>
 *
 * @param is The input source for the top-level of the XML document.
 * @exception org.xml.sax.SAXException Any SAX exception, possibly wrapping
 * another exception.
 * @exception java.io.IOException An IO exception from the parser, possibly
 * from a byte stream or character stream supplied by the application.
 * @see org.xml.sax.InputSource
 * @see #parse(java.lang.String)
 * @see #setEntityResolver
 * @see #setDTDHandler
 * @see #setContentHandler
 * @see #setErrorHandler
 */
public void parse(InputSource is) throws IOException, SAXException {
    if (is == null) {
        throw new IllegalArgumentException("");
    }
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException saxe) {
        throw saxe;
    } catch (IOException ioe) {
        throw ioe;
    } catch (RuntimeException rte) {
        throw rte;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Parse an XML document.
 *
 * <p>The application can use this method to instruct the XML reader to
 * begin parsing an XML document from any valid input source (a character
 * stream, a byte stream, or a URI).</p>
 *
 * <p>Applications may not invoke this method while a parse is in progress
 * (they should create a new XMLReader instead for each nested XML
 * document). Once a parse is complete, an application may reuse the same
 * XMLReader object, possibly with a different input source.</p>
 *
 * <p>During the parse, the XMLReader will provide information about the XML
 * document through the registered event handlers.</p>
 *
 * <p>This method is synchronous: it will not return until parsing has
 * ended. If a client application wants to terminate parsing early, it
 * should throw an exception.</p>
 *
 * @param is The input source for the top-level of the XML document.
 * @exception org.xml.sax.SAXException Any SAX exception, possibly wrapping
 * another exception.
 * @exception java.io.IOException An IO exception from the parser, possibly
 * from a byte stream or character stream supplied by the application.
 * @see org.xml.sax.InputSource
 * @see #parse(java.lang.String)
 * @see #setEntityResolver
 * @see #setDTDHandler
 * @see #setContentHandler
 * @see #setErrorHandler
 */
public void parse(InputSource is) throws IOException, SAXException {
    if (is == null) {
        throw new IllegalArgumentException("");
    }
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException saxe) {
        throw saxe;
    } catch (IOException ioe) {
        throw ioe;
    } catch (RuntimeException rte) {
        throw rte;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Parse an XML document.
 *
 * <p>The application can use this method to instruct the XML reader to
 * begin parsing an XML document from any valid input source (a character
 * stream, a byte stream, or a URI).</p>
 *
 * <p>Applications may not invoke this method while a parse is in progress
 * (they should create a new XMLReader instead for each nested XML
 * document). Once a parse is complete, an application may reuse the same
 * XMLReader object, possibly with a different input source.</p>
 *
 * <p>During the parse, the XMLReader will provide information about the XML
 * document through the registered event handlers.</p>
 *
 * <p>This method is synchronous: it will not return until parsing has
 * ended. If a client application wants to terminate parsing early, it
 * should throw an exception.</p>
 *
 * @param is The input source for the top-level of the XML document.
 * @exception org.xml.sax.SAXException Any SAX exception, possibly wrapping
 * another exception.
 * @exception java.io.IOException An IO exception from the parser, possibly
 * from a byte stream or character stream supplied by the application.
 * @see org.xml.sax.InputSource
 * @see #parse(java.lang.String)
 * @see #setEntityResolver
 * @see #setDTDHandler
 * @see #setContentHandler
 * @see #setErrorHandler
 */
public void parse(InputSource is) throws IOException, SAXException {
    if (is == null) {
        throw new IllegalArgumentException("");
    }
    //              Set up the document
    mInp = new Input(BUFFSIZE_READER);
    mPh = PH_BEFORE_DOC;  // before parsing
    try {
        setinp(is);
    } catch (SAXException saxe) {
        throw saxe;
    } catch (IOException ioe) {
        throw ioe;
    } catch (RuntimeException rte) {
        throw rte;
    } catch (Exception e) {
        panic(e.toString());
    }
    parse();
}
 

/**
 * Sets up a new input source on the top of the input stack. Note, the first
 * byte returned by the entity's byte stream has to be the first byte in the
 * entity. However, the parser does not expect the byte order mask in both
 * cases when encoding is provided by the input source.
 *
 * @param is A new input source to set up.
 * @exception IOException If any IO errors occur.
 * @exception Exception is parser specific exception form panic method.
 */
protected void setinp(InputSource is)
        throws Exception {
    Reader reader = null;
    mChIdx = 0;
    mChLen = 0;
    mChars = mInp.chars;
    mInp.src = null;
    if (mPh < PH_DOC_START) {
        mIsSAlone = false;  // default [#2.9]
    }
    mIsSAloneSet = false;
    if (is.getCharacterStream() != null) {
        //          Ignore encoding in the xml text decl.
        reader = is.getCharacterStream();
        xml(reader);
    } else if (is.getByteStream() != null) {
        String expenc;
        if (is.getEncoding() != null) {
            //              Ignore encoding in the xml text decl.
            expenc = is.getEncoding().toUpperCase();
            if (expenc.equals("UTF-16")) {
                reader = bom(is.getByteStream(), 'U');  // UTF-16 [#4.3.3]
            } else {
                reader = enc(expenc, is.getByteStream());
            }
            xml(reader);
        } else {
            //              Get encoding from BOM or the xml text decl.
            reader = bom(is.getByteStream(), ' ');
            if (reader == null) {
                //          Encoding is defined by the xml text decl.
                reader = enc("UTF-8", is.getByteStream());
                expenc = xml(reader);
                if (expenc.startsWith("UTF-16")) {
                    panic(FAULT);  // UTF-16 must have BOM [#4.3.3]
                }
                reader = enc(expenc, is.getByteStream());
            } else {
                //          Encoding is defined by the BOM.
                xml(reader);
            }
        }
    } else {
        //          There is no support for public/system identifiers.
        panic(FAULT);
    }
    mInp.src = reader;
    mInp.pubid = is.getPublicId();
    mInp.sysid = is.getSystemId();
}
 

/**
 * Sets up a new input source on the top of the input stack. Note, the first
 * byte returned by the entity's byte stream has to be the first byte in the
 * entity. However, the parser does not expect the byte order mask in both
 * cases when encoding is provided by the input source.
 *
 * @param is A new input source to set up.
 * @exception IOException If any IO errors occur.
 * @exception Exception is parser specific exception form panic method.
 */
protected void setinp(InputSource is)
        throws Exception {
    Reader reader = null;
    mChIdx = 0;
    mChLen = 0;
    mChars = mInp.chars;
    mInp.src = null;
    if (mPh < PH_DOC_START) {
        mIsSAlone = false;  // default [#2.9]
    }
    mIsSAloneSet = false;
    if (is.getCharacterStream() != null) {
        //          Ignore encoding in the xml text decl.
        reader = is.getCharacterStream();
        xml(reader);
    } else if (is.getByteStream() != null) {
        String expenc;
        if (is.getEncoding() != null) {
            //              Ignore encoding in the xml text decl.
            expenc = is.getEncoding().toUpperCase();
            if (expenc.equals("UTF-16")) {
                reader = bom(is.getByteStream(), 'U');  // UTF-16 [#4.3.3]
            } else {
                reader = enc(expenc, is.getByteStream());
            }
            xml(reader);
        } else {
            //              Get encoding from BOM or the xml text decl.
            reader = bom(is.getByteStream(), ' ');
            if (reader == null) {
                //          Encoding is defined by the xml text decl.
                reader = enc("UTF-8", is.getByteStream());
                expenc = xml(reader);
                if (expenc.startsWith("UTF-16")) {
                    panic(FAULT);  // UTF-16 must have BOM [#4.3.3]
                }
                reader = enc(expenc, is.getByteStream());
            } else {
                //          Encoding is defined by the BOM.
                xml(reader);
            }
        }
    } else {
        //          There is no support for public/system identifiers.
        panic(FAULT);
    }
    mInp.src = reader;
    mInp.pubid = is.getPublicId();
    mInp.sysid = is.getSystemId();
}