blob: e26c97c178ea60dea5ae4e363a99698c14c145e5 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc on Thu Nov 22 17:12:58 EST 2007 -->
<TITLE>
Xalan-Java 2.7.1: Class SourceTreeManager
</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>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/SourceTreeManager.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../org/apache/xpath/SourceTree.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../org/apache/xpath/VariableStack.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> &nbsp;
&nbsp;<A HREF="SourceTreeManager.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
org.apache.xpath</FONT>
<BR>
Class SourceTreeManager</H2>
<PRE>
java.lang.Object
|
+--<B>org.apache.xpath.SourceTreeManager</B>
</PRE>
<HR>
<DL>
<DT>public class <B>SourceTreeManager</B><DT>extends java.lang.Object</DL>
<P>
This class bottlenecks all management of source trees. The methods
in this class should allow easy garbage collection of source
trees (not yet!), and should centralize parsing for those source trees.
<P>
<HR>
<P>
<!-- ======== INNER CLASS SUMMARY ======== -->
<!-- =========== FIELD SUMMARY =========== -->
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<A NAME="constructor_summary"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#SourceTreeManager()">SourceTreeManager</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
</TR>
</TABLE>
&nbsp;
<!-- ========== 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>&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#findURIFromDoc(int)">findURIFromDoc</A></B>(int&nbsp;owner)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Given a document, find the URL associated with that document.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#getNode(javax.xml.transform.Source)">getNode</A></B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Given a Source object, find the node associated with it.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#getSourceTree(javax.xml.transform.Source, javax.xml.transform.SourceLocator, org.apache.xpath.XPathContext)">getSourceTree</A></B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source,
<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator,
<A HREF="../../../org/apache/xpath/XPathContext.html">XPathContext</A>&nbsp;xctxt)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the source tree from the input source.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#getSourceTree(java.lang.String, java.lang.String, javax.xml.transform.SourceLocator, org.apache.xpath.XPathContext)">getSourceTree</A></B>(java.lang.String&nbsp;base,
java.lang.String&nbsp;urlString,
<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator,
<A HREF="../../../org/apache/xpath/XPathContext.html">XPathContext</A>&nbsp;xctxt)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the source tree from the a base URL and a URL string.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#getURIResolver()">getURIResolver</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the object that will be used to resolve URIs used in
document(), etc.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;<A HREF="../../../org/xml/sax/XMLReader.html">XMLReader</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#getXMLReader(javax.xml.transform.Source, javax.xml.transform.SourceLocator)">getXMLReader</A></B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;inputSource,
<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This method returns the SAX2 parser to use with the InputSource
obtained from this URI.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#parseToNode(javax.xml.transform.Source, javax.xml.transform.SourceLocator, org.apache.xpath.XPathContext)">parseToNode</A></B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source,
<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator,
<A HREF="../../../org/apache/xpath/XPathContext.html">XPathContext</A>&nbsp;xctxt)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Try to create a DOM source tree from the input source.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#putDocumentInCache(int, javax.xml.transform.Source)">putDocumentInCache</A></B>(int&nbsp;n,
<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Put the source tree root node in the document cache.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#removeDocumentFromCache(int)">removeDocumentFromCache</A></B>(int&nbsp;n)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;JJK: Support <?xalan:doc_cache_off?> kluge in ElemForEach.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#reset()">reset</A></B>()</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Reset the list of SourceTree objects that this manager manages.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../../../javax/xml/transform/Source.html">Source</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#resolveURI(java.lang.String, java.lang.String, javax.xml.transform.SourceLocator)">resolveURI</A></B>(java.lang.String&nbsp;base,
java.lang.String&nbsp;urlString,
<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This will be called by the processor when it encounters
an xsl:include, xsl:import, or document() function.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/apache/xpath/SourceTreeManager.html#setURIResolver(javax.xml.transform.URIResolver)">setURIResolver</A></B>(<A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A>&nbsp;resolver)</CODE>
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set an object that will be used to resolve URIs used in
document(), etc.</TD>
</TR>
</TABLE>
&nbsp;<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>
&nbsp;
<P>
<!-- ============ FIELD DETAIL =========== -->
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>
<A NAME="SourceTreeManager()"><!-- --></A><H3>
SourceTreeManager</H3>
<PRE>
public <B>SourceTreeManager</B>()</PRE>
<DL>
</DL>
<!-- ============ 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>Reset the list of SourceTree objects that this manager manages.</DL>
<HR>
<A NAME="setURIResolver(javax.xml.transform.URIResolver)"><!-- --></A><H3>
setURIResolver</H3>
<PRE>
public void <B>setURIResolver</B>(<A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A>&nbsp;resolver)</PRE>
<DL>
<DD>Set an object that will be used to resolve URIs used in
document(), etc.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>resolver</CODE> - An object that implements the URIResolver interface,
or null.</DL>
</DD>
</DL>
<HR>
<A NAME="getURIResolver()"><!-- --></A><H3>
getURIResolver</H3>
<PRE>
public <A HREF="../../../javax/xml/transform/URIResolver.html">URIResolver</A> <B>getURIResolver</B>()</PRE>
<DL>
<DD>Get the object that will be used to resolve URIs used in
document(), etc.<DD><DL>
<DT><B>Returns:</B><DD>An object that implements the URIResolver interface,
or null.</DL>
</DD>
</DL>
<HR>
<A NAME="findURIFromDoc(int)"><!-- --></A><H3>
findURIFromDoc</H3>
<PRE>
public java.lang.String <B>findURIFromDoc</B>(int&nbsp;owner)</PRE>
<DL>
<DD>Given a document, find the URL associated with that document.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>owner</CODE> - Document that was previously processed by this liaison.<DT><B>Returns:</B><DD>The base URI of the owner argument.</DL>
</DD>
</DL>
<HR>
<A NAME="resolveURI(java.lang.String, java.lang.String, javax.xml.transform.SourceLocator)"><!-- --></A><H3>
resolveURI</H3>
<PRE>
public <A HREF="../../../javax/xml/transform/Source.html">Source</A> <B>resolveURI</B>(java.lang.String&nbsp;base,
java.lang.String&nbsp;urlString,
<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator)
throws <A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A>,
java.io.IOException</PRE>
<DL>
<DD>This will be called by the processor when it encounters
an xsl:include, xsl:import, or document() function.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>base</CODE> - The base URI that should be used.<DD><CODE>urlString</CODE> - Value from an xsl:import or xsl:include's href attribute,
or a URI specified in the document() function.<DT><B>Returns:</B><DD>a Source that can be used to process the resource.<DT><B>Throws:</B><DD>java.io.IOException - &nbsp;<DD><A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A> - &nbsp;</DL>
</DD>
</DL>
<HR>
<A NAME="removeDocumentFromCache(int)"><!-- --></A><H3>
removeDocumentFromCache</H3>
<PRE>
public void <B>removeDocumentFromCache</B>(int&nbsp;n)</PRE>
<DL>
<DD>JJK: Support <?xalan:doc_cache_off?> kluge in ElemForEach.
TODO: This function is highly dangerous. Cache management must be improved.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>n</CODE> - The node to remove.</DL>
</DD>
</DL>
<HR>
<A NAME="putDocumentInCache(int, javax.xml.transform.Source)"><!-- --></A><H3>
putDocumentInCache</H3>
<PRE>
public void <B>putDocumentInCache</B>(int&nbsp;n,
<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source)</PRE>
<DL>
<DD>Put the source tree root node in the document cache.
TODO: This function needs to be a LOT more sophisticated.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>n</CODE> - The node to cache.<DD><CODE>source</CODE> - The Source object to cache.</DL>
</DD>
</DL>
<HR>
<A NAME="getNode(javax.xml.transform.Source)"><!-- --></A><H3>
getNode</H3>
<PRE>
public int <B>getNode</B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source)</PRE>
<DL>
<DD>Given a Source object, find the node associated with it.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>source</CODE> - The Source object to act as the key.<DT><B>Returns:</B><DD>The node that is associated with the Source, or null if not found.</DL>
</DD>
</DL>
<HR>
<A NAME="getSourceTree(java.lang.String, java.lang.String, javax.xml.transform.SourceLocator, org.apache.xpath.XPathContext)"><!-- --></A><H3>
getSourceTree</H3>
<PRE>
public int <B>getSourceTree</B>(java.lang.String&nbsp;base,
java.lang.String&nbsp;urlString,
<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator,
<A HREF="../../../org/apache/xpath/XPathContext.html">XPathContext</A>&nbsp;xctxt)
throws <A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A></PRE>
<DL>
<DD>Get the source tree from the a base URL and a URL string.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>base</CODE> - The base URI to use if the urlString is relative.<DD><CODE>urlString</CODE> - An absolute or relative URL string.<DD><CODE>locator</CODE> - The location of the caller, for diagnostic purposes.<DT><B>Returns:</B><DD>should be a non-null reference to the node identified by the
base and urlString.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A> - If the URL can not resolve to a node.</DL>
</DD>
</DL>
<HR>
<A NAME="getSourceTree(javax.xml.transform.Source, javax.xml.transform.SourceLocator, org.apache.xpath.XPathContext)"><!-- --></A><H3>
getSourceTree</H3>
<PRE>
public int <B>getSourceTree</B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source,
<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator,
<A HREF="../../../org/apache/xpath/XPathContext.html">XPathContext</A>&nbsp;xctxt)
throws <A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A></PRE>
<DL>
<DD>Get the source tree from the input source.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>source</CODE> - The Source object that should identify the desired node.<DD><CODE>locator</CODE> - The location of the caller, for diagnostic purposes.<DT><B>Returns:</B><DD>non-null reference to a node.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A> - if the Source argument can't be resolved to
a node.</DL>
</DD>
</DL>
<HR>
<A NAME="parseToNode(javax.xml.transform.Source, javax.xml.transform.SourceLocator, org.apache.xpath.XPathContext)"><!-- --></A><H3>
parseToNode</H3>
<PRE>
public int <B>parseToNode</B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;source,
<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator,
<A HREF="../../../org/apache/xpath/XPathContext.html">XPathContext</A>&nbsp;xctxt)
throws <A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A></PRE>
<DL>
<DD>Try to create a DOM source tree from the input source.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>source</CODE> - The Source object that identifies the source node.<DD><CODE>locator</CODE> - The location of the caller, for diagnostic purposes.<DT><B>Returns:</B><DD>non-null reference to node identified by the source argument.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A> - if the source argument can not be resolved
to a source node.</DL>
</DD>
</DL>
<HR>
<A NAME="getXMLReader(javax.xml.transform.Source, javax.xml.transform.SourceLocator)"><!-- --></A><H3>
getXMLReader</H3>
<PRE>
public static <A HREF="../../../org/xml/sax/XMLReader.html">XMLReader</A> <B>getXMLReader</B>(<A HREF="../../../javax/xml/transform/Source.html">Source</A>&nbsp;inputSource,
<A HREF="../../../javax/xml/transform/SourceLocator.html">SourceLocator</A>&nbsp;locator)
throws <A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A></PRE>
<DL>
<DD>This method returns the SAX2 parser to use with the InputSource
obtained from this URI.
It may return null if any SAX2-conformant XML parser can be used,
or if getInputSource() will also return null. The parser must
be free for use (i.e.
not currently in use for another parse().<DD><DL>
<DT><B>Parameters:</B><DD><CODE>inputSource</CODE> - The value returned from the URIResolver.<DD><CODE>locator</CODE> - The location of the original caller, for diagnostic purposes.<DT><B>Returns:</B><DD>a SAX2 XMLReader to use to resolve the inputSource argument.<DT><B>Throws:</B><DD><A HREF="../../../javax/xml/transform/TransformerException.html">TransformerException</A> - if the reader can not be created.</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>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/SourceTreeManager.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../org/apache/xpath/SourceTree.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../org/apache/xpath/VariableStack.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> &nbsp;
&nbsp;<A HREF="SourceTreeManager.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->
<HR>
Copyright © 2006 Apache XML Project. All Rights Reserved.
</BODY>
</HTML>