| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
|
| <!--NewPage-->
|
| <HTML>
|
| <HEAD>
|
| <!-- Generated by javadoc on Thu Nov 22 17:12:53 EST 2007 -->
|
| <TITLE>
|
| Xalan-Java 2.7.1: Class DocumentBuilder
|
| </TITLE>
|
| <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
|
| </HEAD>
|
| <BODY BGCOLOR="white">
|
|
|
| <!-- ========== START OF NAVBAR ========== -->
|
| <A NAME="navbar_top"><!-- --></A> |
| <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
|
| <TR>
|
| <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
|
| <A NAME="navbar_top_firstrow"><!-- --></A> |
| <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
|
| <TR ALIGN="center" VALIGN="top">
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
|
| <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/DocumentBuilder.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
|
| </TR>
|
| </TABLE>
|
| </TD>
|
| <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
|
| </EM>
|
| </TD>
|
| </TR>
|
|
|
| <TR>
|
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
| PREV CLASS
|
| <A HREF="../../../javax/xml/parsers/DocumentBuilderFactory.html"><B>NEXT CLASS</B></A></FONT></TD>
|
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
| <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
|
| <A HREF="DocumentBuilder.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
|
| </TR>
|
| <TR>
|
| <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
| SUMMARY: INNER | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
|
| <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
| DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
|
| </TR>
|
| </TABLE>
|
| <!-- =========== END OF NAVBAR =========== -->
|
|
|
| <HR>
|
| <!-- ======== START OF CLASS DATA ======== -->
|
| <H2>
|
| <FONT SIZE="-1">
|
| javax.xml.parsers</FONT>
|
| <BR>
|
| Class DocumentBuilder</H2>
|
| <PRE>
|
| java.lang.Object
|
| |
|
| +--<B>javax.xml.parsers.DocumentBuilder</B>
|
| </PRE>
|
| <HR>
|
| <DL>
|
| <DT>public abstract class <B>DocumentBuilder</B><DT>extends java.lang.Object</DL>
|
|
|
| <P>
|
| Defines the API to obtain DOM Document instances from an XML |
| document. Using this class, an application programmer can obtain a |
| <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> from XML.<p> |
| |
| An instance of this class can be obtained from the |
| <A HREF="../../../javax/xml/parsers/DocumentBuilderFactory.html#newDocumentBuilder()"><CODE>DocumentBuilderFactory.newDocumentBuilder()</CODE></A> method. Once |
| an instance of this class is obtained, XML can be parsed from a |
| variety of input sources. These input sources are InputStreams, |
| Files, URLs, and SAX InputSources.<p> |
| |
| Note that this class reuses several classes from the SAX API. This |
| does not require that the implementor of the underlying DOM |
| implementation use a SAX parser to parse XML document into a |
| <code>Document</code>. It merely requires that the implementation |
| communicate with the application using these existing APIs.
|
| <P>
|
| <HR>
|
|
|
| <P>
|
| <!-- ======== INNER CLASS SUMMARY ======== -->
|
|
|
|
|
| <!-- =========== FIELD SUMMARY =========== -->
|
|
|
|
|
| <!-- ======== CONSTRUCTOR SUMMARY ======== -->
|
|
|
|
|
| <!-- ========== METHOD SUMMARY =========== -->
|
|
|
| <A NAME="method_summary"><!-- --></A> |
| <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
|
| <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
|
| <TD COLSPAN=2><FONT SIZE="+2">
|
| <B>Method Summary</B></FONT></TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE>abstract <A HREF="../../../org/w3c/dom/DOMImplementation.html">DOMImplementation</A></CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#getDOMImplementation()">getDOMImplementation</A></B>()</CODE>
|
|
|
| <BR>
|
| Obtain an instance of a <A HREF="../../../org/w3c/dom/DOMImplementation.html"><CODE>DOMImplementation</CODE></A> object.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> <A HREF="../../../javax/xml/validation/Schema.html">Schema</A></CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#getSchema()">getSchema</A></B>()</CODE>
|
|
|
| <BR>
|
| Get a reference to the the <A HREF="../../../javax/xml/validation/Schema.html"><CODE>Schema</CODE></A> being used by |
| the XML processor.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE>abstract boolean</CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#isNamespaceAware()">isNamespaceAware</A></B>()</CODE>
|
|
|
| <BR>
|
| Indicates whether or not this parser is configured to |
| understand namespaces.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE>abstract boolean</CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#isValidating()">isValidating</A></B>()</CODE>
|
|
|
| <BR>
|
| Indicates whether or not this parser is configured to |
| validate XML documents.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> boolean</CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#isXIncludeAware()">isXIncludeAware</A></B>()</CODE>
|
|
|
| <BR>
|
| Get the XInclude processing mode for this parser.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE>abstract <A HREF="../../../org/w3c/dom/Document.html">Document</A></CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#newDocument()">newDocument</A></B>()</CODE>
|
|
|
| <BR>
|
| Obtain a new instance of a DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object |
| to build a DOM tree with.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> <A HREF="../../../org/w3c/dom/Document.html">Document</A></CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#parse(java.io.File)">parse</A></B>(java.io.File f)</CODE>
|
|
|
| <BR>
|
| Parse the content of the given file as an XML document |
| and return a new DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE>abstract <A HREF="../../../org/w3c/dom/Document.html">Document</A></CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#parse(org.xml.sax.InputSource)">parse</A></B>(<A HREF="../../../org/xml/sax/InputSource.html">InputSource</A> is)</CODE>
|
|
|
| <BR>
|
| Parse the content of the given input source as an XML document |
| and return a new DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> <A HREF="../../../org/w3c/dom/Document.html">Document</A></CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#parse(java.io.InputStream)">parse</A></B>(java.io.InputStream is)</CODE>
|
|
|
| <BR>
|
| Parse the content of the given <code>InputStream</code> as an XML |
| document and return a new DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> <A HREF="../../../org/w3c/dom/Document.html">Document</A></CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#parse(java.io.InputStream, java.lang.String)">parse</A></B>(java.io.InputStream is, |
| java.lang.String systemId)</CODE>
|
|
|
| <BR>
|
| Parse the content of the given <code>InputStream</code> as an |
| XML document and return a new DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> <A HREF="../../../org/w3c/dom/Document.html">Document</A></CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#parse(java.lang.String)">parse</A></B>(java.lang.String uri)</CODE>
|
|
|
| <BR>
|
| Parse the content of the given URI as an XML document |
| and return a new DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE> void</CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#reset()">reset</A></B>()</CODE>
|
|
|
| <BR>
|
| Reset this <code>DocumentBuilder</code> to its original configuration.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE>abstract void</CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#setEntityResolver(org.xml.sax.EntityResolver)">setEntityResolver</A></B>(<A HREF="../../../org/xml/sax/EntityResolver.html">EntityResolver</A> er)</CODE>
|
|
|
| <BR>
|
| Specify the <A HREF="../../../org/xml/sax/EntityResolver.html"><CODE>EntityResolver</CODE></A> to be used to resolve |
| entities present in the XML document to be parsed.</TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
| <CODE>abstract void</CODE></FONT></TD>
|
| <TD><CODE><B><A HREF="../../../javax/xml/parsers/DocumentBuilder.html#setErrorHandler(org.xml.sax.ErrorHandler)">setErrorHandler</A></B>(<A HREF="../../../org/xml/sax/ErrorHandler.html">ErrorHandler</A> eh)</CODE>
|
|
|
| <BR>
|
| Specify the <A HREF="../../../org/xml/sax/ErrorHandler.html"><CODE>ErrorHandler</CODE></A> to be used by the parser.</TD>
|
| </TR>
|
| </TABLE>
|
| <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> |
| <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
|
| <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
|
| <TD><B>Methods inherited from class java.lang.Object</B></TD>
|
| </TR>
|
| <TR BGCOLOR="white" CLASS="TableRowColor">
|
| <TD><CODE>equals,
|
| getClass,
|
| hashCode,
|
| notify,
|
| notifyAll,
|
| toString,
|
| wait,
|
| wait,
|
| wait</CODE></TD>
|
| </TR>
|
| </TABLE>
|
|
|
| <P>
|
|
|
| <!-- ============ FIELD DETAIL =========== -->
|
|
|
|
|
| <!-- ========= CONSTRUCTOR DETAIL ======== -->
|
|
|
|
|
| <!-- ============ METHOD DETAIL ========== -->
|
|
|
| <A NAME="method_detail"><!-- --></A> |
| <TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
|
| <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
|
| <TD COLSPAN=1><FONT SIZE="+2">
|
| <B>Method Detail</B></FONT></TD>
|
| </TR>
|
| </TABLE>
|
|
|
| <A NAME="reset()"><!-- --></A><H3>
|
| reset</H3>
|
| <PRE>
|
| public void <B>reset</B>()</PRE>
|
| <DL>
|
| <DD><p>Reset this <code>DocumentBuilder</code> to its original configuration.</p> |
| |
| <p><code>DocumentBuilder</code> is reset to the same state as when it was created with |
| <A HREF="../../../javax/xml/parsers/DocumentBuilderFactory.html#newDocumentBuilder()"><CODE>DocumentBuilderFactory.newDocumentBuilder()</CODE></A>. |
| <code>reset()</code> is designed to allow the reuse of existing <code>DocumentBuilder</code>s |
| thus saving resources associated with the creation of new <code>DocumentBuilder</code>s.</p> |
| |
| <p>The reset <code>DocumentBuilder</code> is not guaranteed to have the same <A HREF="../../../org/xml/sax/EntityResolver.html"><CODE>EntityResolver</CODE></A> or <A HREF="../../../org/xml/sax/ErrorHandler.html"><CODE>ErrorHandler</CODE></A> |
| <code>Object</code>s, e.g. <CODE>Object.equals(Object obj)</CODE>. It is guaranteed to have a functionally equal |
| <code>EntityResolver</code> and <code>ErrorHandler</code>.</p><DD><DL>
|
| <DT><B>Since: </B><DD>1.5</DD>
|
| </DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="parse(java.io.InputStream)"><!-- --></A><H3>
|
| parse</H3>
|
| <PRE>
|
| public <A HREF="../../../org/w3c/dom/Document.html">Document</A> <B>parse</B>(java.io.InputStream is) |
| throws <A HREF="../../../org/xml/sax/SAXException.html">SAXException</A>, |
| java.io.IOException</PRE>
|
| <DL>
|
| <DD>Parse the content of the given <code>InputStream</code> as an XML |
| document and return a new DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object. |
| An <code>IllegalArgumentException</code> is thrown if the |
| <code>InputStream</code> is null.<DD><DL>
|
| <DT><B>Parameters:</B><DD><CODE>is</CODE> - InputStream containing the content to be parsed.<DT><B>Returns:</B><DD><code>Document</code> result of parsing the |
| <code>InputStream</code><DT><B>Throws:</B><DD>java.io.IOException - If any IO errors occur.<DD><A HREF="../../../org/xml/sax/SAXException.html">SAXException</A> - If any parse errors occur.<DT><B>See Also: </B><DD><A HREF="../../../org/xml/sax/DocumentHandler.html"><CODE>DocumentHandler</CODE></A></DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="parse(java.io.InputStream, java.lang.String)"><!-- --></A><H3>
|
| parse</H3>
|
| <PRE>
|
| public <A HREF="../../../org/w3c/dom/Document.html">Document</A> <B>parse</B>(java.io.InputStream is, |
| java.lang.String systemId) |
| throws <A HREF="../../../org/xml/sax/SAXException.html">SAXException</A>, |
| java.io.IOException</PRE>
|
| <DL>
|
| <DD>Parse the content of the given <code>InputStream</code> as an |
| XML document and return a new DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object. |
| An <code>IllegalArgumentException</code> is thrown if the |
| <code>InputStream</code> is null.<DD><DL>
|
| <DT><B>Parameters:</B><DD><CODE>is</CODE> - InputStream containing the content to be parsed.<DD><CODE>systemId</CODE> - Provide a base for resolving relative URIs.<DT><B>Returns:</B><DD>A new DOM Document object.<DT><B>Throws:</B><DD>java.io.IOException - If any IO errors occur.<DD><A HREF="../../../org/xml/sax/SAXException.html">SAXException</A> - If any parse errors occur.<DT><B>See Also: </B><DD><A HREF="../../../org/xml/sax/DocumentHandler.html"><CODE>DocumentHandler</CODE></A></DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="parse(java.lang.String)"><!-- --></A><H3>
|
| parse</H3>
|
| <PRE>
|
| public <A HREF="../../../org/w3c/dom/Document.html">Document</A> <B>parse</B>(java.lang.String uri) |
| throws <A HREF="../../../org/xml/sax/SAXException.html">SAXException</A>, |
| java.io.IOException</PRE>
|
| <DL>
|
| <DD>Parse the content of the given URI as an XML document |
| and return a new DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object. |
| An <code>IllegalArgumentException</code> is thrown if the |
| URI is <code>null</code> null.<DD><DL>
|
| <DT><B>Parameters:</B><DD><CODE>uri</CODE> - The location of the content to be parsed.<DT><B>Returns:</B><DD>A new DOM Document object.<DT><B>Throws:</B><DD>java.io.IOException - If any IO errors occur.<DD><A HREF="../../../org/xml/sax/SAXException.html">SAXException</A> - If any parse errors occur.<DT><B>See Also: </B><DD><A HREF="../../../org/xml/sax/DocumentHandler.html"><CODE>DocumentHandler</CODE></A></DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="parse(java.io.File)"><!-- --></A><H3>
|
| parse</H3>
|
| <PRE>
|
| public <A HREF="../../../org/w3c/dom/Document.html">Document</A> <B>parse</B>(java.io.File f) |
| throws <A HREF="../../../org/xml/sax/SAXException.html">SAXException</A>, |
| java.io.IOException</PRE>
|
| <DL>
|
| <DD>Parse the content of the given file as an XML document |
| and return a new DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object. |
| An <code>IllegalArgumentException</code> is thrown if the |
| <code>File</code> is <code>null</code> null.<DD><DL>
|
| <DT><B>Parameters:</B><DD><CODE>f</CODE> - The file containing the XML to parse.<DT><B>Returns:</B><DD>A new DOM Document object.<DT><B>Throws:</B><DD>java.io.IOException - If any IO errors occur.<DD><A HREF="../../../org/xml/sax/SAXException.html">SAXException</A> - If any parse errors occur.<DT><B>See Also: </B><DD><A HREF="../../../org/xml/sax/DocumentHandler.html"><CODE>DocumentHandler</CODE></A></DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="parse(org.xml.sax.InputSource)"><!-- --></A><H3>
|
| parse</H3>
|
| <PRE>
|
| public abstract <A HREF="../../../org/w3c/dom/Document.html">Document</A> <B>parse</B>(<A HREF="../../../org/xml/sax/InputSource.html">InputSource</A> is) |
| throws <A HREF="../../../org/xml/sax/SAXException.html">SAXException</A>, |
| java.io.IOException</PRE>
|
| <DL>
|
| <DD>Parse the content of the given input source as an XML document |
| and return a new DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object. |
| An <code>IllegalArgumentException</code> is thrown if the |
| <code>InputSource</code> is <code>null</code> null.<DD><DL>
|
| <DT><B>Parameters:</B><DD><CODE>is</CODE> - InputSource containing the content to be parsed.<DT><B>Returns:</B><DD>A new DOM Document object.<DT><B>Throws:</B><DD>java.io.IOException - If any IO errors occur.<DD><A HREF="../../../org/xml/sax/SAXException.html">SAXException</A> - If any parse errors occur.<DT><B>See Also: </B><DD><A HREF="../../../org/xml/sax/DocumentHandler.html"><CODE>DocumentHandler</CODE></A></DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="isNamespaceAware()"><!-- --></A><H3>
|
| isNamespaceAware</H3>
|
| <PRE>
|
| public abstract boolean <B>isNamespaceAware</B>()</PRE>
|
| <DL>
|
| <DD>Indicates whether or not this parser is configured to |
| understand namespaces.<DD><DL>
|
| <DT><B>Returns:</B><DD>true if this parser is configured to understand |
| namespaces; false otherwise.</DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="isValidating()"><!-- --></A><H3>
|
| isValidating</H3>
|
| <PRE>
|
| public abstract boolean <B>isValidating</B>()</PRE>
|
| <DL>
|
| <DD>Indicates whether or not this parser is configured to |
| validate XML documents.<DD><DL>
|
| <DT><B>Returns:</B><DD>true if this parser is configured to validate |
| XML documents; false otherwise.</DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="setEntityResolver(org.xml.sax.EntityResolver)"><!-- --></A><H3>
|
| setEntityResolver</H3>
|
| <PRE>
|
| public abstract void <B>setEntityResolver</B>(<A HREF="../../../org/xml/sax/EntityResolver.html">EntityResolver</A> er)</PRE>
|
| <DL>
|
| <DD>Specify the <A HREF="../../../org/xml/sax/EntityResolver.html"><CODE>EntityResolver</CODE></A> to be used to resolve |
| entities present in the XML document to be parsed. Setting |
| this to <code>null</code> will result in the underlying |
| implementation using it's own default implementation and |
| behavior.<DD><DL>
|
| <DT><B>Parameters:</B><DD><CODE>er</CODE> - The <code>EntityResolver</code> to be used to resolve entities |
| present in the XML document to be parsed.</DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="setErrorHandler(org.xml.sax.ErrorHandler)"><!-- --></A><H3>
|
| setErrorHandler</H3>
|
| <PRE>
|
| public abstract void <B>setErrorHandler</B>(<A HREF="../../../org/xml/sax/ErrorHandler.html">ErrorHandler</A> eh)</PRE>
|
| <DL>
|
| <DD>Specify the <A HREF="../../../org/xml/sax/ErrorHandler.html"><CODE>ErrorHandler</CODE></A> to be used by the parser. |
| Setting this to <code>null</code> will result in the underlying |
| implementation using it's own default implementation and |
| behavior.<DD><DL>
|
| <DT><B>Parameters:</B><DD><CODE>eh</CODE> - The <code>ErrorHandler</code> to be used by the parser.</DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="newDocument()"><!-- --></A><H3>
|
| newDocument</H3>
|
| <PRE>
|
| public abstract <A HREF="../../../org/w3c/dom/Document.html">Document</A> <B>newDocument</B>()</PRE>
|
| <DL>
|
| <DD>Obtain a new instance of a DOM <A HREF="../../../org/w3c/dom/Document.html"><CODE>Document</CODE></A> object |
| to build a DOM tree with.<DD><DL>
|
| <DT><B>Returns:</B><DD>A new instance of a DOM Document object.</DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="getDOMImplementation()"><!-- --></A><H3>
|
| getDOMImplementation</H3>
|
| <PRE>
|
| public abstract <A HREF="../../../org/w3c/dom/DOMImplementation.html">DOMImplementation</A> <B>getDOMImplementation</B>()</PRE>
|
| <DL>
|
| <DD>Obtain an instance of a <A HREF="../../../org/w3c/dom/DOMImplementation.html"><CODE>DOMImplementation</CODE></A> object.<DD><DL>
|
| <DT><B>Returns:</B><DD>A new instance of a <code>DOMImplementation</code>.</DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="getSchema()"><!-- --></A><H3>
|
| getSchema</H3>
|
| <PRE>
|
| public <A HREF="../../../javax/xml/validation/Schema.html">Schema</A> <B>getSchema</B>()</PRE>
|
| <DL>
|
| <DD><p>Get a reference to the the <A HREF="../../../javax/xml/validation/Schema.html"><CODE>Schema</CODE></A> being used by |
| the XML processor.</p> |
| |
| <p>If no schema is being used, <code>null</code> is returned.</p><DD><DL>
|
| <DT><B>Returns:</B><DD><A HREF="../../../javax/xml/validation/Schema.html"><CODE>Schema</CODE></A> being used or <code>null</code> |
| if none in use<DT><B>Throws:</B><DD>UnsupportedOperationException - For backward compatibility, when implementations for |
| earlier versions of JAXP is used, this exception will be |
| thrown.<DT><B>Since: </B><DD>1.5</DD>
|
| </DL>
|
| </DD>
|
| </DL>
|
| <HR>
|
|
|
| <A NAME="isXIncludeAware()"><!-- --></A><H3>
|
| isXIncludeAware</H3>
|
| <PRE>
|
| public boolean <B>isXIncludeAware</B>()</PRE>
|
| <DL>
|
| <DD><p>Get the XInclude processing mode for this parser.</p><DD><DL>
|
| <DT><B>Returns:</B><DD>the return value of |
| the <A HREF="../../../javax/xml/parsers/DocumentBuilderFactory.html#isXIncludeAware()"><CODE>DocumentBuilderFactory.isXIncludeAware()</CODE></A> |
| when this parser was created from factory.<DT><B>Throws:</B><DD>UnsupportedOperationException - For backward compatibility, when implementations for |
| earlier versions of JAXP is used, this exception will be |
| thrown.<DT><B>Since: </B><DD>1.5</DD>
|
| <DT><B>See Also: </B><DD><A HREF="../../../javax/xml/parsers/DocumentBuilderFactory.html#setXIncludeAware(boolean)"><CODE>DocumentBuilderFactory.setXIncludeAware(boolean)</CODE></A></DL>
|
| </DD>
|
| </DL>
|
| <!-- ========= END OF CLASS DATA ========= -->
|
| <HR>
|
|
|
| <!-- ========== START OF NAVBAR ========== -->
|
| <A NAME="navbar_bottom"><!-- --></A> |
| <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
|
| <TR>
|
| <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
|
| <A NAME="navbar_bottom_firstrow"><!-- --></A> |
| <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
|
| <TR ALIGN="center" VALIGN="top">
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
|
| <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/DocumentBuilder.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
|
| <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
|
| </TR>
|
| </TABLE>
|
| </TD>
|
| <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
|
| </EM>
|
| </TD>
|
| </TR>
|
|
|
| <TR>
|
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
| PREV CLASS
|
| <A HREF="../../../javax/xml/parsers/DocumentBuilderFactory.html"><B>NEXT CLASS</B></A></FONT></TD>
|
| <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
| <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>
|
| <A HREF="DocumentBuilder.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
|
| </TR>
|
| <TR>
|
| <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
| SUMMARY: INNER | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
|
| <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
| DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
|
| </TR>
|
| </TABLE>
|
| <!-- =========== END OF NAVBAR =========== -->
|
|
|
| <HR>
|
| Copyright © 2006 Apache XML Project. All Rights Reserved.
|
| </BODY>
|
| </HTML>
|
