<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.6.0_18) on Fri Dec 09 20:48:45 GMT 2011 -->
<TITLE>
XPathEvaluator
</TITLE>
<META NAME="date" CONTENT="2011-12-09">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="XPathEvaluator";
}
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<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="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">
<A HREF="../../../../net/sf/saxon/xpath/JAXPXPathStaticContext.html" title="class in net.sf.saxon.xpath"><B>PREV CLASS</B></A>
<A HREF="../../../../net/sf/saxon/xpath/XPathExpressionImpl.html" title="class in net.sf.saxon.xpath"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?net/sf/saxon/xpath/XPathEvaluator.html" target="_top"><B>FRAMES</B></A>
<A HREF="XPathEvaluator.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
net.sf.saxon.xpath</FONT>
<BR>
Class XPathEvaluator</H2>
<PRE>
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</A>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>net.sf.saxon.xpath.XPathEvaluator</B>
</PRE>
<DL>
<DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></DD>
</DL>
<HR>
<DL>
<DT><PRE>public class <B>XPathEvaluator</B><DT>extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A><DT>implements <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></DL>
</PRE>
<P>
<p>XPathEvaluator implements the JAXP API for standalone XPath processing (that is,
executing XPath expressions in the absence of an XSLT stylesheet). It is an implementation
of the JAXP 1.3 XPath interface, with additional methods provided (a) for backwards
compatibility (b) to give extra control over the XPath evaluation, and (c) to support
XPath 2.0.</p>
<p>It is intended to evolve this so that it only supports the JAXP style of operation.
Some of the methods are therefore marked as deprecated in this release, and will be
dropped in a future release.</p>
<p>For an alternative XPath API, offering more direct access to Saxon capabilities,
see <A HREF="../../../../net/sf/saxon/sxpath/XPathEvaluator.html" title="class in net.sf.saxon.sxpath"><CODE>XPathEvaluator</CODE></A>.</p>
<p>Note that the <code>XPathEvaluator</code> links to a Saxon <A HREF="../../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon"><CODE>Configuration</CODE></A>
object. By default a new <code>Configuration</code> is created automatically. In many
applications, however, it is desirable to share a configuration. The default configuration
is not schema aware. All source documents used by XPath expressions under this evaluator
must themselves be built using the <code>Configuration</code> used by this evaluator.</p>
<P>
<P>
<DL>
<DT><B>Author:</B></DT>
<DD>Michael H. Kay</DD>
</DL>
<HR>
<P>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<A NAME="constructor_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#XPathEvaluator()">XPathEvaluator</A></B>()</CODE>
<BR>
Default constructor.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#XPathEvaluator(net.sf.saxon.Configuration)">XPathEvaluator</A></B>(<A HREF="../../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A> config)</CODE>
<BR>
Construct an XPathEvaluator with a specified configuration.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#XPathEvaluator(javax.xml.transform.Source)">XPathEvaluator</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform">Source</A> source)</CODE>
<BR>
Construct an XPathEvaluator to process a particular source document.</TD>
</TR>
</TABLE>
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Method Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpression.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpression</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#compile(java.lang.String)">compile</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expr)</CODE>
<BR>
Compile an XPath 2.0 expression</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../net/sf/saxon/xpath/XPathExpressionImpl.html" title="class in net.sf.saxon.xpath">XPathExpressionImpl</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#createExpression(java.lang.String)">createExpression</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expression)</CODE>
<BR>
<B>Deprecated.</B> <I>since Saxon 8.9 - use <A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#compile(java.lang.String)"><CODE>compile(String)</CODE></A></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#evaluate(java.lang.String, org.xml.sax.InputSource)">evaluate</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expr,
<A HREF="http://download.oracle.com/javase/6/docs/api/org/xml/sax/InputSource.html?is-external=true" title="class or interface in org.xml.sax">InputSource</A> inputSource)</CODE>
<BR>
Single-shot method to parse and build a source document, and
compile an execute an XPath 2.0 expression, against that document,
returning the result as a string</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#evaluate(java.lang.String, org.xml.sax.InputSource, javax.xml.namespace.QName)">evaluate</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expr,
<A HREF="http://download.oracle.com/javase/6/docs/api/org/xml/sax/InputSource.html?is-external=true" title="class or interface in org.xml.sax">InputSource</A> inputSource,
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> qName)</CODE>
<BR>
Single-shot method to parse and build a source document, and
compile an execute an XPath 2.0 expression, against that document</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#evaluate(java.lang.String, java.lang.Object)">evaluate</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expr,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> node)</CODE>
<BR>
Single-shot method to compile an execute an XPath 2.0 expression, returning
the result as a string.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#evaluate(java.lang.String, java.lang.Object, javax.xml.namespace.QName)">evaluate</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expr,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> node,
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> qName)</CODE>
<BR>
Single-shot method to compile and execute an XPath 2.0 expression.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#getConfiguration()">getConfiguration</A></B>()</CODE>
<BR>
Get the Configuration used by this XPathEvaluator</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/NamespaceContext.html?is-external=true" title="class or interface in javax.xml.namespace">NamespaceContext</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#getNamespaceContext()">getNamespaceContext</A></B>()</CODE>
<BR>
Get the namespace context, if one has been set using <A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setNamespaceContext(javax.xml.namespace.NamespaceContext)"><CODE>setNamespaceContext(javax.xml.namespace.NamespaceContext)</CODE></A></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../net/sf/saxon/xpath/JAXPXPathStaticContext.html" title="class in net.sf.saxon.xpath">JAXPXPathStaticContext</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#getStaticContext()">getStaticContext</A></B>()</CODE>
<BR>
Get the current static context</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathFunctionResolver.html?is-external=true" title="class or interface in javax.xml.xpath">XPathFunctionResolver</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#getXPathFunctionResolver()">getXPathFunctionResolver</A></B>()</CODE>
<BR>
Get the resolver for XPath functions</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathVariableResolver.html?is-external=true" title="class or interface in javax.xml.xpath">XPathVariableResolver</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#getXPathVariableResolver()">getXPathVariableResolver</A></B>()</CODE>
<BR>
Get the resolver for XPath variables</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="../../../../net/sf/saxon/xpath/XPathEvaluator.html#importSchema(javax.xml.transform.Source)">importSchema</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform">Source</A> source)</CODE>
<BR>
Import a schema.</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="../../../../net/sf/saxon/xpath/XPathEvaluator.html#isBackwardsCompatible()">isBackwardsCompatible</A></B>()</CODE>
<BR>
Get the value of XPath 1.0 compatibility mode</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#main(java.lang.String[])">main</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[] args)</CODE>
<BR>
A simple command-line interface for the XPathEvaluator (not documented).</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="../../../../net/sf/saxon/xpath/XPathEvaluator.html#reset()">reset</A></B>()</CODE>
<BR>
</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="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setBackwardsCompatible(boolean)">setBackwardsCompatible</A></B>(boolean compatible)</CODE>
<BR>
Set XPath 1.0 compatibility mode on or off (by default, it is false).</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="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setContextNode(net.sf.saxon.om.NodeInfo)">setContextNode</A></B>(<A HREF="../../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A> node)</CODE>
<BR>
<B>Deprecated.</B> <I>since Saxon 8.9 - use the various method defined in the JAXP interface definition,
which allow a NodeInfo object to be supplied as the value of the Source argument</I></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="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setNamespaceContext(javax.xml.namespace.NamespaceContext)">setNamespaceContext</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/NamespaceContext.html?is-external=true" title="class or interface in javax.xml.namespace">NamespaceContext</A> namespaceContext)</CODE>
<BR>
Set the namespace context to be used.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setSource(javax.xml.transform.Source)">setSource</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform">Source</A> source)</CODE>
<BR>
Supply a document against which XPath expressions are to be executed, converting it to a
Saxon NodeInfo 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="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setStaticContext(net.sf.saxon.xpath.JAXPXPathStaticContext)">setStaticContext</A></B>(<A HREF="../../../../net/sf/saxon/xpath/JAXPXPathStaticContext.html" title="class in net.sf.saxon.xpath">JAXPXPathStaticContext</A> context)</CODE>
<BR>
Set the static context for compiling XPath expressions.</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="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setStripSpace(boolean)">setStripSpace</A></B>(boolean strip)</CODE>
<BR>
<B>Deprecated.</B> <I>since 8.9. The preferred way to define options for the way in which source
documents are built is to use the class <A HREF="../../../../net/sf/saxon/lib/AugmentedSource.html" title="class in net.sf.saxon.lib"><CODE>AugmentedSource</CODE></A> for any
of the methods expecting a <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform"><CODE>Source</CODE></A> object.</I></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="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setXPathFunctionResolver(javax.xml.xpath.XPathFunctionResolver)">setXPathFunctionResolver</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathFunctionResolver.html?is-external=true" title="class or interface in javax.xml.xpath">XPathFunctionResolver</A> xPathFunctionResolver)</CODE>
<BR>
Set the resolver for XPath functions</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="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setXPathVariableResolver(javax.xml.xpath.XPathVariableResolver)">setXPathVariableResolver</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathVariableResolver.html?is-external=true" title="class or interface in javax.xml.xpath">XPathVariableResolver</A> xPathVariableResolver)</CODE>
<BR>
Set the resolver for XPath variables</TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
<P>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="XPathEvaluator()"><!-- --></A><H3>
XPathEvaluator</H3>
<PRE>
public <B>XPathEvaluator</B>()</PRE>
<DL>
<DD>Default constructor. Creates an XPathEvaluator with Configuration appropriate
to the version of the Saxon software being run.
<P>
</DL>
<HR>
<A NAME="XPathEvaluator(net.sf.saxon.Configuration)"><!-- --></A><H3>
XPathEvaluator</H3>
<PRE>
public <B>XPathEvaluator</B>(<A HREF="../../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A> config)</PRE>
<DL>
<DD>Construct an XPathEvaluator with a specified configuration.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>config</CODE> - the configuration to be used. If schema-aware XPath expressions are to be used,
this must be an EnterpriseConfiguration.</DL>
</DL>
<HR>
<A NAME="XPathEvaluator(javax.xml.transform.Source)"><!-- --></A><H3>
XPathEvaluator</H3>
<PRE>
public <B>XPathEvaluator</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform">Source</A> source)
throws <A HREF="../../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></PRE>
<DL>
<DD>Construct an XPathEvaluator to process a particular source document. This is equivalent to
using the default constructor and immediately calling setSource().
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>source</CODE> - The source document (or a specific node within it).
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></CODE></DL>
</DL>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="getConfiguration()"><!-- --></A><H3>
getConfiguration</H3>
<PRE>
public <A HREF="../../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A> <B>getConfiguration</B>()</PRE>
<DL>
<DD>Get the Configuration used by this XPathEvaluator
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the Configuration used by this XPathEvaluator</DL>
</DD>
</DL>
<HR>
<A NAME="setStripSpace(boolean)"><!-- --></A><H3>
setStripSpace</H3>
<PRE>
public void <B>setStripSpace</B>(boolean strip)</PRE>
<DL>
<DD><B>Deprecated.</B> <I>since 8.9. The preferred way to define options for the way in which source
documents are built is to use the class <A HREF="../../../../net/sf/saxon/lib/AugmentedSource.html" title="class in net.sf.saxon.lib"><CODE>AugmentedSource</CODE></A> for any
of the methods expecting a <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform"><CODE>Source</CODE></A> object.</I>
<P>
<DD>Indicate whether all whitespace text nodes in the source document are to be
removed. This option has no effect unless it is called before the call on setSource(),
and unless the Source supplied to setSource() is a SAXSource or StreamSource.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>strip</CODE> - True if all whitespace text nodes are to be stripped from the source document,
false otherwise. The default if the method is not called is false.</DL>
</DD>
</DL>
<HR>
<A NAME="setSource(javax.xml.transform.Source)"><!-- --></A><H3>
setSource</H3>
<PRE>
public <A HREF="../../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A> <B>setSource</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform">Source</A> source)
throws <A HREF="../../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></PRE>
<DL>
<DD>Supply a document against which XPath expressions are to be executed, converting it to a
Saxon NodeInfo object.
<p>If the supplied source is a <code>NodeInfo</code>, it is returned unchanged.</p>
<p>If the supplied source is a <code>DOMSource</code>, the result is a Saxon <code>NodeInfo</code>
wrapper around the DOM Node contained by the DOMSource.</p>
<p>In all other cases, the result is a document node, and is the same as the result of calling
<A HREF="../../../../net/sf/saxon/Configuration.html#buildDocument(javax.xml.transform.Source)"><CODE>Configuration.buildDocument(javax.xml.transform.Source)</CODE></A> with the same argument;
except that when whitespace stripping has been requested using <A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setStripSpace(boolean)"><CODE>setStripSpace(boolean)</CODE></A>,
this request is passed on.</p>
<p>Despite the name of this method, it does not change the state of the <code>XPathEvaluator</code>
in any way.</p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>source</CODE> - Any javax.xml.transform.Source object representing the document against
which XPath expressions will be executed. Note that a Saxon <A HREF="../../../../net/sf/saxon/om/DocumentInfo.html" title="interface in net.sf.saxon.om"><CODE>DocumentInfo</CODE></A>
(indeed any <A HREF="../../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om"><CODE>NodeInfo</CODE></A>)
can be used as a Source. To use a third-party DOM Document as a source, create an instance of
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/dom/DOMSource.html?is-external=true" title="class or interface in javax.xml.transform.dom"><CODE>DOMSource</CODE></A> to wrap it.
<p>The Source object supplied also determines the initial setting
of the context item. In most cases the context node will be the root of the supplied document;
however, if a NodeInfo or DOMSource is supplied it can be any node in the document. </p>
<DT><B>Returns:</B><DD>the NodeInfo of the start node in the resulting document object.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathException</A></CODE> - if the supplied Source is a NodeInfo object that was built using an incompatible
Configuration (that is, a Configuration using a different NamePool). Also, if any error occurs parsing
the document supplied as the Source.
<DD><CODE><A HREF="../../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setStaticContext(net.sf.saxon.xpath.JAXPXPathStaticContext)"><!-- --></A><H3>
setStaticContext</H3>
<PRE>
public void <B>setStaticContext</B>(<A HREF="../../../../net/sf/saxon/xpath/JAXPXPathStaticContext.html" title="class in net.sf.saxon.xpath">JAXPXPathStaticContext</A> context)</PRE>
<DL>
<DD>Set the static context for compiling XPath expressions. This provides control over the
environment in which the expression is compiled, for example it allows namespace prefixes to
be declared, variables to be bound and functions to be defined. For most purposes, the static
context can be defined by providing and tailoring an instance of the JAXPXPathStaticContext class.
Until this method is called, a default static context is used, in which no namespaces are defined
other than the standard ones (xml, xslt, and saxon), and no variables or functions (other than the
core XPath functions) are available.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>context</CODE> - the static context
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if the supplied static context uses a different and incompatible
Configuration from the one used in this XPathEvaluator</DL>
</DD>
</DL>
<HR>
<A NAME="getStaticContext()"><!-- --></A><H3>
getStaticContext</H3>
<PRE>
public <A HREF="../../../../net/sf/saxon/xpath/JAXPXPathStaticContext.html" title="class in net.sf.saxon.xpath">JAXPXPathStaticContext</A> <B>getStaticContext</B>()</PRE>
<DL>
<DD>Get the current static context
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the static context</DL>
</DD>
</DL>
<HR>
<A NAME="createExpression(java.lang.String)"><!-- --></A><H3>
createExpression</H3>
<PRE>
public <A HREF="../../../../net/sf/saxon/xpath/XPathExpressionImpl.html" title="class in net.sf.saxon.xpath">XPathExpressionImpl</A> <B>createExpression</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expression)
throws <A HREF="../../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></PRE>
<DL>
<DD><B>Deprecated.</B> <I>since Saxon 8.9 - use <A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#compile(java.lang.String)"><CODE>compile(String)</CODE></A></I>
<P>
<DD>Prepare an XPath expression for subsequent evaluation.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>expression</CODE> - The XPath expression to be evaluated, supplied as a string.
<DT><B>Returns:</B><DD>an XPathExpression object representing the prepared expression
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></CODE> - if the syntax of the expression is wrong, or if it references namespaces,
variables, or functions that have not been declared.</DL>
</DD>
</DL>
<HR>
<A NAME="setContextNode(net.sf.saxon.om.NodeInfo)"><!-- --></A><H3>
setContextNode</H3>
<PRE>
public void <B>setContextNode</B>(<A HREF="../../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A> node)</PRE>
<DL>
<DD><B>Deprecated.</B> <I>since Saxon 8.9 - use the various method defined in the JAXP interface definition,
which allow a NodeInfo object to be supplied as the value of the Source argument</I>
<P>
<DD>Set the context node. This provides the context node for any expressions executed after this
method is called, including expressions that were prepared before it was called.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>node</CODE> - The node to be used as the context node. The node must be within a tree built using
the same Saxon <A HREF="../../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon"><CODE>Configuration</CODE></A> as used by this XPathEvaluator.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if the supplied node was built using the wrong Configuration</DL>
</DD>
</DL>
<HR>
<A NAME="reset()"><!-- --></A><H3>
reset</H3>
<PRE>
public void <B>reset</B>()</PRE>
<DL>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#reset()" title="class or interface in javax.xml.xpath">reset</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
</DL>
</DD>
</DL>
<HR>
<A NAME="setBackwardsCompatible(boolean)"><!-- --></A><H3>
setBackwardsCompatible</H3>
<PRE>
public void <B>setBackwardsCompatible</B>(boolean compatible)</PRE>
<DL>
<DD>Set XPath 1.0 compatibility mode on or off (by default, it is false). This applies
to any XPath expression compiled while this option is in force.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>compatible</CODE> - true if XPath 1.0 compatibility mode is to be set to true, false
if it is to be set to false.</DL>
</DD>
</DL>
<HR>
<A NAME="isBackwardsCompatible()"><!-- --></A><H3>
isBackwardsCompatible</H3>
<PRE>
public boolean <B>isBackwardsCompatible</B>()</PRE>
<DL>
<DD>Get the value of XPath 1.0 compatibility mode
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>true if XPath 1.0 compatibility mode is set</DL>
</DD>
</DL>
<HR>
<A NAME="setXPathVariableResolver(javax.xml.xpath.XPathVariableResolver)"><!-- --></A><H3>
setXPathVariableResolver</H3>
<PRE>
public void <B>setXPathVariableResolver</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathVariableResolver.html?is-external=true" title="class or interface in javax.xml.xpath">XPathVariableResolver</A> xPathVariableResolver)</PRE>
<DL>
<DD>Set the resolver for XPath variables
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#setXPathVariableResolver(javax.xml.xpath.XPathVariableResolver)" title="class or interface in javax.xml.xpath">setXPathVariableResolver</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xPathVariableResolver</CODE> - a resolver for variables</DL>
</DD>
</DL>
<HR>
<A NAME="getXPathVariableResolver()"><!-- --></A><H3>
getXPathVariableResolver</H3>
<PRE>
public <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathVariableResolver.html?is-external=true" title="class or interface in javax.xml.xpath">XPathVariableResolver</A> <B>getXPathVariableResolver</B>()</PRE>
<DL>
<DD>Get the resolver for XPath variables
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#getXPathVariableResolver()" title="class or interface in javax.xml.xpath">getXPathVariableResolver</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the resolver, if one has been set</DL>
</DD>
</DL>
<HR>
<A NAME="setXPathFunctionResolver(javax.xml.xpath.XPathFunctionResolver)"><!-- --></A><H3>
setXPathFunctionResolver</H3>
<PRE>
public void <B>setXPathFunctionResolver</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathFunctionResolver.html?is-external=true" title="class or interface in javax.xml.xpath">XPathFunctionResolver</A> xPathFunctionResolver)</PRE>
<DL>
<DD>Set the resolver for XPath functions
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#setXPathFunctionResolver(javax.xml.xpath.XPathFunctionResolver)" title="class or interface in javax.xml.xpath">setXPathFunctionResolver</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>xPathFunctionResolver</CODE> - a resolver for XPath function calls</DL>
</DD>
</DL>
<HR>
<A NAME="getXPathFunctionResolver()"><!-- --></A><H3>
getXPathFunctionResolver</H3>
<PRE>
public <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathFunctionResolver.html?is-external=true" title="class or interface in javax.xml.xpath">XPathFunctionResolver</A> <B>getXPathFunctionResolver</B>()</PRE>
<DL>
<DD>Get the resolver for XPath functions
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#getXPathFunctionResolver()" title="class or interface in javax.xml.xpath">getXPathFunctionResolver</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the resolver, if one has been set</DL>
</DD>
</DL>
<HR>
<A NAME="setNamespaceContext(javax.xml.namespace.NamespaceContext)"><!-- --></A><H3>
setNamespaceContext</H3>
<PRE>
public void <B>setNamespaceContext</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/NamespaceContext.html?is-external=true" title="class or interface in javax.xml.namespace">NamespaceContext</A> namespaceContext)</PRE>
<DL>
<DD>Set the namespace context to be used.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#setNamespaceContext(javax.xml.namespace.NamespaceContext)" title="class or interface in javax.xml.xpath">setNamespaceContext</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>namespaceContext</CODE> - The namespace context</DL>
</DD>
</DL>
<HR>
<A NAME="getNamespaceContext()"><!-- --></A><H3>
getNamespaceContext</H3>
<PRE>
public <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/NamespaceContext.html?is-external=true" title="class or interface in javax.xml.namespace">NamespaceContext</A> <B>getNamespaceContext</B>()</PRE>
<DL>
<DD>Get the namespace context, if one has been set using <A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setNamespaceContext(javax.xml.namespace.NamespaceContext)"><CODE>setNamespaceContext(javax.xml.namespace.NamespaceContext)</CODE></A>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#getNamespaceContext()" title="class or interface in javax.xml.xpath">getNamespaceContext</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the namespace context if set, or null otherwise</DL>
</DD>
</DL>
<HR>
<A NAME="importSchema(javax.xml.transform.Source)"><!-- --></A><H3>
importSchema</H3>
<PRE>
public void <B>importSchema</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform">Source</A> source)
throws <A HREF="../../../../net/sf/saxon/type/SchemaException.html" title="class in net.sf.saxon.type">SchemaException</A></PRE>
<DL>
<DD>Import a schema. This is possible only if Saxon-EE is being used,
and if the Configuration is an EnterpriseConfiguration. Having imported a schema, the types
defined in that schema become part of the static context.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>source</CODE> - A Source object identifying the schema document to be loaded
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../net/sf/saxon/type/SchemaException.html" title="class in net.sf.saxon.type">SchemaException</A></CODE> - if the schema contained in this document is invalid
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/UnsupportedOperationException.html?is-external=true" title="class or interface in java.lang">UnsupportedOperationException</A></CODE> - if the configuration is not schema-aware</DL>
</DD>
</DL>
<HR>
<A NAME="compile(java.lang.String)"><!-- --></A><H3>
compile</H3>
<PRE>
public <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpression.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpression</A> <B>compile</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expr)
throws <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpressionException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpressionException</A></PRE>
<DL>
<DD>Compile an XPath 2.0 expression
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#compile(java.lang.String)" title="class or interface in javax.xml.xpath">compile</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>expr</CODE> - the XPath 2.0 expression to be compiled, as a string
<DT><B>Returns:</B><DD>the compiled form of the expression
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpressionException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpressionException</A></CODE> - if there are any static errors in the expression.
Note that references to undeclared variables are not treated as static errors, because
variables are not pre-declared using this API.</DL>
</DD>
</DL>
<HR>
<A NAME="evaluate(java.lang.String, java.lang.Object, javax.xml.namespace.QName)"><!-- --></A><H3>
evaluate</H3>
<PRE>
public <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> <B>evaluate</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expr,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> node,
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> qName)
throws <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpressionException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpressionException</A></PRE>
<DL>
<DD>Single-shot method to compile and execute an XPath 2.0 expression.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#evaluate(java.lang.String, java.lang.Object, javax.xml.namespace.QName)" title="class or interface in javax.xml.xpath">evaluate</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>expr</CODE> - The XPath 2.0 expression to be compiled and executed<DD><CODE>node</CODE> - The context node for evaluation of the expression.
<p>This may be a NodeInfo object, representing a node in Saxon's native
implementation of the data model, or it may be a node in any supported
external object model: DOM, JDOM, DOM4J, or XOM, or any other model for
which support has been configured in the Configuration. Note that the
supporting libraries for the chosen model must be on the class path.</p>
<p><b>Contrary to the interface specification, Saxon does not supply an empty
document when the value is null. This is because Saxon supports multiple object models,
and it's unclear what kind of document node would be appropriate. Instead, Saxon uses
the node supplied to the <A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setContextNode(net.sf.saxon.om.NodeInfo)"><CODE>setContextNode(net.sf.saxon.om.NodeInfo)</CODE></A> method if available, and if none
is available, executes the XPath expression with the context item undefined.</p></p><DD><CODE>qName</CODE> - The type of result required. For details, see
<A HREF="../../../../net/sf/saxon/xpath/XPathExpressionImpl.html#evaluate(java.lang.Object, javax.xml.namespace.QName)"><CODE>XPathExpressionImpl.evaluate(Object, javax.xml.namespace.QName)</CODE></A>
<DT><B>Returns:</B><DD>the result of evaluating the expression, returned as described in
<A HREF="../../../../net/sf/saxon/xpath/XPathExpressionImpl.html#evaluate(java.lang.Object, javax.xml.namespace.QName)"><CODE>XPathExpressionImpl.evaluate(Object, javax.xml.namespace.QName)</CODE></A>
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpressionException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpressionException</A></CODE> - if any static or dynamic error occurs
in evaluating the expression.</DL>
</DD>
</DL>
<HR>
<A NAME="evaluate(java.lang.String, java.lang.Object)"><!-- --></A><H3>
evaluate</H3>
<PRE>
public <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>evaluate</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expr,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> node)
throws <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpressionException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpressionException</A></PRE>
<DL>
<DD>Single-shot method to compile an execute an XPath 2.0 expression, returning
the result as a string.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#evaluate(java.lang.String, java.lang.Object)" title="class or interface in javax.xml.xpath">evaluate</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>expr</CODE> - The XPath 2.0 expression to be compiled and executed<DD><CODE>node</CODE> - The context node for evaluation of the expression
<p>This may be a NodeInfo object, representing a node in Saxon's native
implementation of the data model, or it may be a node in any supported
external object model: DOM, JDOM, DOM4J, or XOM, or any other model for
which support has been configured in the Configuration. Note that the
supporting libraries for the chosen model must be on the class path.</p>
<p><b>Contrary to the interface specification, Saxon does not supply an empty
document when the value is null. This is because Saxon supports multiple object models,
and it's unclear what kind of document node would be appropriate. Instead, Saxon uses
the node supplied to the <A HREF="../../../../net/sf/saxon/xpath/XPathEvaluator.html#setContextNode(net.sf.saxon.om.NodeInfo)"><CODE>setContextNode(net.sf.saxon.om.NodeInfo)</CODE></A> method if available, and if none
is available, executes the XPath expression with the context item undefined.</p></p>
<DT><B>Returns:</B><DD>the result of evaluating the expression, converted to a string as if
by calling the XPath string() function
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpressionException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpressionException</A></CODE> - if any static or dynamic error occurs
in evaluating the expression.</DL>
</DD>
</DL>
<HR>
<A NAME="evaluate(java.lang.String, org.xml.sax.InputSource, javax.xml.namespace.QName)"><!-- --></A><H3>
evaluate</H3>
<PRE>
public <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> <B>evaluate</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expr,
<A HREF="http://download.oracle.com/javase/6/docs/api/org/xml/sax/InputSource.html?is-external=true" title="class or interface in org.xml.sax">InputSource</A> inputSource,
<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/namespace/QName.html?is-external=true" title="class or interface in javax.xml.namespace">QName</A> qName)
throws <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpressionException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpressionException</A></PRE>
<DL>
<DD>Single-shot method to parse and build a source document, and
compile an execute an XPath 2.0 expression, against that document
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#evaluate(java.lang.String, org.xml.sax.InputSource, javax.xml.namespace.QName)" title="class or interface in javax.xml.xpath">evaluate</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>expr</CODE> - The XPath 2.0 expression to be compiled and executed<DD><CODE>inputSource</CODE> - The source document: this will be parsed and built into a tree,
and the XPath expression will be executed with the root node of the tree as the
context node.<DD><CODE>qName</CODE> - The type of result required. For details, see
<A HREF="../../../../net/sf/saxon/xpath/XPathExpressionImpl.html#evaluate(java.lang.Object, javax.xml.namespace.QName)"><CODE>XPathExpressionImpl.evaluate(Object, javax.xml.namespace.QName)</CODE></A>
<DT><B>Returns:</B><DD>the result of evaluating the expression, returned as described in
<A HREF="../../../../net/sf/saxon/xpath/XPathExpressionImpl.html#evaluate(java.lang.Object, javax.xml.namespace.QName)"><CODE>XPathExpressionImpl.evaluate(Object, javax.xml.namespace.QName)</CODE></A>
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpressionException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpressionException</A></CODE> - if any static or dynamic error occurs
in evaluating the expression.
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</A></CODE> - if any of the three arguments is null</DL>
</DD>
</DL>
<HR>
<A NAME="evaluate(java.lang.String, org.xml.sax.InputSource)"><!-- --></A><H3>
evaluate</H3>
<PRE>
public <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>evaluate</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> expr,
<A HREF="http://download.oracle.com/javase/6/docs/api/org/xml/sax/InputSource.html?is-external=true" title="class or interface in org.xml.sax">InputSource</A> inputSource)
throws <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpressionException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpressionException</A></PRE>
<DL>
<DD>Single-shot method to parse and build a source document, and
compile an execute an XPath 2.0 expression, against that document,
returning the result as a string
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true#evaluate(java.lang.String, org.xml.sax.InputSource)" title="class or interface in javax.xml.xpath">evaluate</A></CODE> in interface <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPath.html?is-external=true" title="class or interface in javax.xml.xpath">XPath</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>expr</CODE> - The XPath 2.0 expression to be compiled and executed<DD><CODE>inputSource</CODE> - The source document: this will be parsed and built into a tree,
and the XPath expression will be executed with the root node of the tree as the
context node
<DT><B>Returns:</B><DD>the result of evaluating the expression, converted to a string as
if by calling the XPath string() function
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/xpath/XPathExpressionException.html?is-external=true" title="class or interface in javax.xml.xpath">XPathExpressionException</A></CODE> - if any static or dynamic error occurs
in evaluating the expression.
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</A></CODE> - if either of the two arguments is null</DL>
</DD>
</DL>
<HR>
<A NAME="main(java.lang.String[])"><!-- --></A><H3>
main</H3>
<PRE>
public static void <B>main</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[] args)
throws <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</A></PRE>
<DL>
<DD>A simple command-line interface for the XPathEvaluator (not documented).
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>args</CODE> - command line arguments.
First parameter is the filename containing the source document, second
parameter is the XPath expression.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Exception.html?is-external=true" title="class or interface in java.lang">Exception</A></CODE> - if any error occurs</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<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="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">
<A HREF="../../../../net/sf/saxon/xpath/JAXPXPathStaticContext.html" title="class in net.sf.saxon.xpath"><B>PREV CLASS</B></A>
<A HREF="../../../../net/sf/saxon/xpath/XPathExpressionImpl.html" title="class in net.sf.saxon.xpath"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?net/sf/saxon/xpath/XPathEvaluator.html" target="_top"><B>FRAMES</B></A>
<A HREF="XPathEvaluator.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
Copyright (c) 2004-2011 Saxonica Limited. All rights reserved.
</BODY>
</HTML>
