<!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:00 GMT 2011 --> <TITLE> Controller </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="Controller"; } } </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/Configuration.LicenseFeature.html" title="class in net.sf.saxon"><B>PREV CLASS</B></A> <A HREF="../../../net/sf/saxon/Filter.html" title="class in net.sf.saxon"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html?net/sf/saxon/Controller.html" target="_top"><B>FRAMES</B></A> <A HREF="Controller.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</FONT> <BR> Class Controller</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 "><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">javax.xml.transform.Transformer</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>net.sf.saxon.Controller</B> </PRE> <HR> <DL> <DT><PRE>public class <B>Controller</B><DT>extends <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></DL> </PRE> <P> The Controller is Saxon's implementation of the JAXP Transformer class, and represents an executing instance of a transformation or query. Multiple concurrent executions of the same transformation or query will use different Controller instances. This class is therefore not thread-safe. <p> The Controller is serially reusable, as required by JAXP: when one transformation or query is finished, it can be used to run another. However, there is no advantage in doing this rather than allocating a new Controller each time. <p> The Controller can also be used when running Java applications that use neither XSLT nor XQuery. A dummy Controller is created when running free-standing XPath expressions. <p> The Controller holds those parts of the dynamic context that do not vary during the course of a transformation or query, or that do not change once their value has been computed. This also includes those parts of the static context that are required at run-time. <p> Wherever possible XSLT applications should use the JAXP Transformer class directly, rather than relying on Saxon-specific methods in the Controller. However, some features are currently available only through this class. This applies especially to new features specific to XSLT 2.0, since the JAXP interface still supports only XSLT 1.0. Such methods may be superseded in the future by JAXP methods. <p> Many methods on the Controller are designed for internal use and should not be considered stable. From release 8.4 onwards, those methods that are considered sufficiently stable to constitute path of the Saxon public API are labelled with the JavaDoc tag "since": the value indicates the release at which the method was added to the public API. <P> <P> <DL> <DT><B>Since:</B></DT> <DD>8.4</DD> <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/Controller.html#Controller(net.sf.saxon.Configuration)">Controller</A></B>(<A HREF="../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A> config)</CODE> <BR> Create a Controller and initialise variables.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#Controller(net.sf.saxon.Configuration, net.sf.saxon.expr.instruct.Executable)">Controller</A></B>(<A HREF="../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A> config, <A HREF="../../../net/sf/saxon/expr/instruct/Executable.html" title="class in net.sf.saxon.expr.instruct">Executable</A> executable)</CODE> <BR> Create a Controller and initialise variables.</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> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#addTraceListener(net.sf.saxon.lib.TraceListener)">addTraceListener</A></B>(<A HREF="../../../net/sf/saxon/lib/TraceListener.html" title="interface in net.sf.saxon.lib">TraceListener</A> trace)</CODE> <BR> Adds the specified trace listener to receive trace events from this instance.</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/Controller.html#addUnavailableOutputDestination(net.sf.saxon.om.DocumentURI)">addUnavailableOutputDestination</A></B>(<A HREF="../../../net/sf/saxon/om/DocumentURI.html" title="class in net.sf.saxon.om">DocumentURI</A> uri)</CODE> <BR> Add a URI to the set of output destinations that cannot be written to, either because they have already been written to, or because they have been read</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/Controller.html#allocateGlobalVariables(int)">allocateGlobalVariables</A></B>(int numberOfVariables)</CODE> <BR> Allocate space in the bindery for global variables.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/event/SequenceOutputter.html" title="class in net.sf.saxon.event">SequenceOutputter</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#allocateSequenceOutputter(int)">allocateSequenceOutputter</A></B>(int size)</CODE> <BR> Allocate a SequenceOutputter for a new output destination.</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/Controller.html#checkImplicitResultTree()">checkImplicitResultTree</A></B>()</CODE> <BR> Check whether an XSLT implicit result tree can be written.</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/Controller.html#checkUniqueOutputDestination(net.sf.saxon.om.DocumentURI)">checkUniqueOutputDestination</A></B>(<A HREF="../../../net/sf/saxon/om/DocumentURI.html" title="class in net.sf.saxon.om">DocumentURI</A> uri)</CODE> <BR> Check that an output destination has not been used before, optionally adding this URI to the set of URIs that have been used.</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/Controller.html#clearDocumentPool()">clearDocumentPool</A></B>()</CODE> <BR> Clear the document pool.</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/Controller.html#clearParameters()">clearParameters</A></B>()</CODE> <BR> Reset the parameters to a null list.</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/Controller.html#defineGlobalParameters()">defineGlobalParameters</A></B>()</CODE> <BR> Register the global parameters of the transformation or query.</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/Controller.html#getBaseOutputURI()">getBaseOutputURI</A></B>()</CODE> <BR> Get the base output URI.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/expr/instruct/Bindery.html" title="class in net.sf.saxon.expr.instruct">Bindery</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getBindery()">getBindery</A></B>()</CODE> <BR> Get the current bindery.</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/ClassLoader.html?is-external=true" title="class or interface in java.lang">ClassLoader</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getClassLoader()">getClassLoader</A></B>()</CODE> <BR> Get the ClassLoader supplied using the method <A HREF="../../../net/sf/saxon/Controller.html#setClassLoader(java.lang.ClassLoader)"><CODE>setClassLoader(java.lang.ClassLoader)</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/lib/CollectionURIResolver.html" title="interface in net.sf.saxon.lib">CollectionURIResolver</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getCollectionURIResolver()">getCollectionURIResolver</A></B>()</CODE> <BR> Get the CollectionURIResolver used for resolving references to collections.</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/Controller.html#getConfiguration()">getConfiguration</A></B>()</CODE> <BR> Get the Configuration associated with this Controller.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/om/Item.html" title="interface in net.sf.saxon.om">Item</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getContextForGlobalVariables()">getContextForGlobalVariables</A></B>()</CODE> <BR> Get the item used as the context for evaluating global variables.</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/Controller.html#getCookedBaseOutputURI()">getCookedBaseOutputURI</A></B>()</CODE> <BR> Get the base output URI after processing.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/value/DateTimeValue.html" title="class in net.sf.saxon.value">DateTimeValue</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getCurrentDateTime()">getCurrentDateTime</A></B>()</CODE> <BR> Get the current date and time for this query or transformation.</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/Controller.html#getDefaultCollection()">getDefaultCollection</A></B>()</CODE> <BR> Get the name of the default collection.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/om/DocumentPool.html" title="class in net.sf.saxon.om">DocumentPool</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getDocumentPool()">getDocumentPool</A></B>()</CODE> <BR> Get the document pool.</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/transform/ErrorListener.html?is-external=true" title="class or interface in javax.xml.transform">ErrorListener</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getErrorListener()">getErrorListener</A></B>()</CODE> <BR> Get the error listener.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/expr/instruct/Executable.html" title="class in net.sf.saxon.expr.instruct">Executable</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getExecutable()">getExecutable</A></B>()</CODE> <BR> Get the Executable object.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getImplicitTimezone()">getImplicitTimezone</A></B>()</CODE> <BR> Get the implicit timezone for this query or transformation</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/om/Item.html" title="interface in net.sf.saxon.om">Item</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getInitialContextItem()">getInitialContextItem</A></B>()</CODE> <BR> Get the initial context item.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/trans/Mode.html" title="class in net.sf.saxon.trans">Mode</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getInitialMode()">getInitialMode</A></B>()</CODE> <BR> Get the initial mode for the transformation</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/Controller.html#getInitialModeName()">getInitialModeName</A></B>()</CODE> <BR> Get the name of the initial mode for the transformation</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/Controller.html#getInitialTemplate()">getInitialTemplate</A></B>()</CODE> <BR> Get the initial template</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/trans/KeyManager.html" title="class in net.sf.saxon.trans">KeyManager</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getKeyManager()">getKeyManager</A></B>()</CODE> <BR> Get the KeyManager.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/event/Receiver.html" title="interface in net.sf.saxon.event">Receiver</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getMessageEmitter()">getMessageEmitter</A></B>()</CODE> <BR> Get the Receiver used for xsl:message output.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/om/TreeModel.html" title="class in net.sf.saxon.om">TreeModel</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getModel()">getModel</A></B>()</CODE> <BR> Get the tree model that will 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/NamePool.html" title="class in net.sf.saxon.om">NamePool</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getNamePool()">getNamePool</A></B>()</CODE> <BR> Get the name pool in use.</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/util/Properties.html?is-external=true" title="class or interface in java.util">Properties</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getOutputProperties()">getOutputProperties</A></B>()</CODE> <BR> Get the output properties for the transformation.</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/Controller.html#getOutputProperty(java.lang.String)">getOutputProperty</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> name)</CODE> <BR> Get the value of an output property.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/lib/OutputURIResolver.html" title="interface in net.sf.saxon.lib">OutputURIResolver</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getOutputURIResolver()">getOutputURIResolver</A></B>()</CODE> <BR> Get the output URI resolver.</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/Controller.html#getParameter(java.lang.String)">getParameter</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> expandedName)</CODE> <BR> Get a parameter to the transformation.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/expr/parser/PathMap.html" title="class in net.sf.saxon.expr.parser">PathMap</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getPathMapForDocumentProjection()">getPathMapForDocumentProjection</A></B>()</CODE> <BR> Get the path map used for document projection, if any.</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/transform/Result.html?is-external=true" title="class or interface in javax.xml.transform">Result</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getPrincipalResult()">getPrincipalResult</A></B>()</CODE> <BR> Get the principal result destination.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getRecoveryPolicy()">getRecoveryPolicy</A></B>()</CODE> <BR> Get the policy for handling recoverable errors</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getRememberedNumber(net.sf.saxon.om.NodeInfo)">getRememberedNumber</A></B>(<A HREF="../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A> node)</CODE> <BR> Get the number of a node if it is the last remembered one.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/trans/RuleManager.html" title="class in net.sf.saxon.trans">RuleManager</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getRuleManager()">getRuleManager</A></B>()</CODE> <BR> Get the Rule Manager.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/lib/SchemaURIResolver.html" title="interface in net.sf.saxon.lib">SchemaURIResolver</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getSchemaURIResolver()">getSchemaURIResolver</A></B>()</CODE> <BR> Get the SchemaURIResolver used for resolving references to schema documents.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getSchemaValidationMode()">getSchemaValidationMode</A></B>()</CODE> <BR> Ask whether source documents loaded using the doc(), document(), and collection() functions, or supplied as a StreamSource or SAXSource to the transform() or addParameter() method should be subjected to schema validation</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/om/SpaceStrippingRule.html" title="interface in net.sf.saxon.om">SpaceStrippingRule</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getSpaceStrippingRule()">getSpaceStrippingRule</A></B>()</CODE> <BR> </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/transform/URIResolver.html?is-external=true" title="class or interface in javax.xml.transform">URIResolver</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getStandardURIResolver()">getStandardURIResolver</A></B>()</CODE> <BR> Get the fallback URI resolver.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/event/Receiver.html" title="interface in net.sf.saxon.event">Receiver</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getStreamingReceiver(net.sf.saxon.trans.Mode, javax.xml.transform.Result)">getStreamingReceiver</A></B>(<A HREF="../../../net/sf/saxon/trans/Mode.html" title="class in net.sf.saxon.trans">Mode</A> mode, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Result.html?is-external=true" title="class or interface in javax.xml.transform">Result</A> result)</CODE> <BR> Get a receiver to which the input to this transformation can be supplied as a stream of events, causing the transformation to be executed in streaming mode.</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/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getTraceFunctionDestination()">getTraceFunctionDestination</A></B>()</CODE> <BR> Get the destination for output from the fn:trace() function.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/lib/TraceListener.html" title="interface in net.sf.saxon.lib">TraceListener</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getTraceListener()">getTraceListener</A></B>()</CODE> <BR> Get the TraceListener.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getTreeModel()">getTreeModel</A></B>()</CODE> <BR> <B>Deprecated.</B> <I>since 9.2: use <A HREF="../../../net/sf/saxon/Controller.html#getModel()"><CODE>getModel()</CODE></A></I></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/lib/UnparsedTextURIResolver.html" title="interface in net.sf.saxon.lib">UnparsedTextURIResolver</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getUnparsedTextURIResolver()">getUnparsedTextURIResolver</A></B>()</CODE> <BR> Get the URI resolver for the unparsed-text() function.</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/transform/URIResolver.html?is-external=true" title="class or interface in javax.xml.transform">URIResolver</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#getURIResolver()">getURIResolver</A></B>()</CODE> <BR> Get the URI resolver.</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/Controller.html#getUserData(java.lang.Object, java.lang.String)">getUserData</A></B>(<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> key, <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> name)</CODE> <BR> Get user data associated with a key.</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/Controller.html#hasThereBeenAnExplicitResultDocument()">hasThereBeenAnExplicitResultDocument</A></B>()</CODE> <BR> Test whether an explicit result tree has been written using xsl:result-document</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/Controller.html#isStripSourceTree()">isStripSourceTree</A></B>()</CODE> <BR> Ask whether the transformation will perform whitespace stripping for supplied source trees as defined by the xsl:strip-space and xsl:preserve-space declarations in the stylesheet.</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/Controller.html#isTracing()">isTracing</A></B>()</CODE> <BR> Test whether instruction execution is being traced.</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/Controller.html#isUnusedOutputDestination(net.sf.saxon.om.DocumentURI)">isUnusedOutputDestination</A></B>(<A HREF="../../../net/sf/saxon/om/DocumentURI.html" title="class in net.sf.saxon.om">DocumentURI</A> uri)</CODE> <BR> Determine whether an output URI is available for use.</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/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#iterateParameters()">iterateParameters</A></B>()</CODE> <BR> Get an iterator over the names of global parameters that have been defined</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/event/Builder.html" title="class in net.sf.saxon.event">Builder</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#makeBuilder()">makeBuilder</A></B>()</CODE> <BR> Make a builder for the selected tree model.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/event/PipelineConfiguration.html" title="class in net.sf.saxon.event">PipelineConfiguration</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#makePipelineConfiguration()">makePipelineConfiguration</A></B>()</CODE> <BR> Make a PipelineConfiguration based on the properties of this Controller.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/event/Stripper.html" title="class in net.sf.saxon.event">Stripper</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#makeStripper(net.sf.saxon.event.Receiver)">makeStripper</A></B>(<A HREF="../../../net/sf/saxon/event/Receiver.html" title="interface in net.sf.saxon.event">Receiver</A> next)</CODE> <BR> Make a Stripper configured to implement the whitespace stripping rules.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../net/sf/saxon/expr/XPathContextMajor.html" title="class in net.sf.saxon.expr">XPathContextMajor</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#newXPathContext()">newXPathContext</A></B>()</CODE> <BR> Make an XPathContext object for expression evaluation.</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/Controller.html#pauseTracing(boolean)">pauseTracing</A></B>(boolean pause)</CODE> <BR> Pause or resume tracing.</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/Controller.html#preEvaluateGlobals(net.sf.saxon.expr.XPathContext)">preEvaluateGlobals</A></B>(<A HREF="../../../net/sf/saxon/expr/XPathContext.html" title="interface in net.sf.saxon.expr">XPathContext</A> context)</CODE> <BR> Pre-evaluate global variables (when debugging/tracing).</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/Controller.html#prepareInputTree(javax.xml.transform.Source)">prepareInputTree</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> Prepare an input tree for processing.</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/Controller.html#recoverableError(net.sf.saxon.trans.XPathException)">recoverableError</A></B>(<A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A> err)</CODE> <BR> Report a recoverable error.</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/Controller.html#registerDocument(net.sf.saxon.om.DocumentInfo, net.sf.saxon.om.DocumentURI)">registerDocument</A></B>(<A HREF="../../../net/sf/saxon/om/DocumentInfo.html" title="interface in net.sf.saxon.om">DocumentInfo</A> doc, <A HREF="../../../net/sf/saxon/om/DocumentURI.html" title="class in net.sf.saxon.om">DocumentURI</A> uri)</CODE> <BR> Add a document to the document pool, and check that it is suitable for use in this query or transformation.</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/Controller.html#removeTraceListener(net.sf.saxon.lib.TraceListener)">removeTraceListener</A></B>(<A HREF="../../../net/sf/saxon/lib/TraceListener.html" title="interface in net.sf.saxon.lib">TraceListener</A> trace)</CODE> <BR> Removes the specified trace listener so that the listener will no longer receive trace events.</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/Controller.html#removeUnavailableOutputDestination(net.sf.saxon.om.DocumentURI)">removeUnavailableOutputDestination</A></B>(<A HREF="../../../net/sf/saxon/om/DocumentURI.html" title="class in net.sf.saxon.om">DocumentURI</A> uri)</CODE> <BR> Remove a URI from the set of output destinations that cannot be written to or read from.</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/Controller.html#reportFatalError(net.sf.saxon.trans.XPathException)">reportFatalError</A></B>(<A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A> err)</CODE> <BR> Report a fatal error</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/Controller.html#reset()">reset</A></B>()</CODE> <BR> Reset this <code>Transformer</code> to its original configuration.</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/Controller.html#reuseSequenceOutputter(net.sf.saxon.event.SequenceOutputter)">reuseSequenceOutputter</A></B>(<A HREF="../../../net/sf/saxon/event/SequenceOutputter.html" title="class in net.sf.saxon.event">SequenceOutputter</A> out)</CODE> <BR> Accept a SequenceOutputter that is now available for reuse</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/Controller.html#setBaseOutputURI(java.lang.String)">setBaseOutputURI</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> uri)</CODE> <BR> Set the base output URI.</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/Controller.html#setClassLoader(java.lang.ClassLoader)">setClassLoader</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/ClassLoader.html?is-external=true" title="class or interface in java.lang">ClassLoader</A> loader)</CODE> <BR> Set a ClassLoader to be used when loading external classes.</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/Controller.html#setCollectionURIResolver(net.sf.saxon.lib.CollectionURIResolver)">setCollectionURIResolver</A></B>(<A HREF="../../../net/sf/saxon/lib/CollectionURIResolver.html" title="interface in net.sf.saxon.lib">CollectionURIResolver</A> resolver)</CODE> <BR> Set the CollectionURIResolver used for resolving collection URIs.</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/Controller.html#setCurrentDateTime(net.sf.saxon.value.DateTimeValue)">setCurrentDateTime</A></B>(<A HREF="../../../net/sf/saxon/value/DateTimeValue.html" title="class in net.sf.saxon.value">DateTimeValue</A> dateTime)</CODE> <BR> Set the current date and time for this query or transformation.</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/Controller.html#setDefaultCollection(java.lang.String)">setDefaultCollection</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> uri)</CODE> <BR> Set the name of the default collection.</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/Controller.html#setErrorListener(javax.xml.transform.ErrorListener)">setErrorListener</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/ErrorListener.html?is-external=true" title="class or interface in javax.xml.transform">ErrorListener</A> listener)</CODE> <BR> Set the error listener.</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/Controller.html#setExecutable(net.sf.saxon.expr.instruct.Executable)">setExecutable</A></B>(<A HREF="../../../net/sf/saxon/expr/instruct/Executable.html" title="class in net.sf.saxon.expr.instruct">Executable</A> exec)</CODE> <BR> Associate this Controller with an Executable.</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/Controller.html#setInitialContextItem(net.sf.saxon.om.Item)">setInitialContextItem</A></B>(<A HREF="../../../net/sf/saxon/om/Item.html" title="interface in net.sf.saxon.om">Item</A> item)</CODE> <BR> Set the initial context item, when running XQuery.</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/Controller.html#setInitialMode(java.lang.String)">setInitialMode</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> expandedModeName)</CODE> <BR> Set the initial mode for the transformation.</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/Controller.html#setInitialTemplate(java.lang.String)">setInitialTemplate</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> expandedName)</CODE> <BR> Set the initial named template to be used as the entry point.</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/Controller.html#setMessageEmitter(net.sf.saxon.event.Receiver)">setMessageEmitter</A></B>(<A HREF="../../../net/sf/saxon/event/Receiver.html" title="interface in net.sf.saxon.event">Receiver</A> receiver)</CODE> <BR> Set the Receiver to be used for xsl:message output.</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/Controller.html#setModel(net.sf.saxon.om.TreeModel)">setModel</A></B>(<A HREF="../../../net/sf/saxon/om/TreeModel.html" title="class in net.sf.saxon.om">TreeModel</A> model)</CODE> <BR> Set the tree model to use.</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/Controller.html#setOutputProperties(java.util.Properties)">setOutputProperties</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/util/Properties.html?is-external=true" title="class or interface in java.util">Properties</A> properties)</CODE> <BR> Set the output properties for the transformation.</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/Controller.html#setOutputProperty(java.lang.String, java.lang.String)">setOutputProperty</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> name, <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> value)</CODE> <BR> Set an output property for the transformation.</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/Controller.html#setOutputURIResolver(net.sf.saxon.lib.OutputURIResolver)">setOutputURIResolver</A></B>(<A HREF="../../../net/sf/saxon/lib/OutputURIResolver.html" title="interface in net.sf.saxon.lib">OutputURIResolver</A> resolver)</CODE> <BR> Set the URI resolver for secondary output documents.</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/Controller.html#setParameter(java.lang.String, java.lang.Object)">setParameter</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> expandedName, <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> value)</CODE> <BR> Set a parameter for the transformation.</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/Controller.html#setParameter(net.sf.saxon.om.StructuredQName, net.sf.saxon.om.ValueRepresentation)">setParameter</A></B>(<A HREF="../../../net/sf/saxon/om/StructuredQName.html" title="class in net.sf.saxon.om">StructuredQName</A> qName, <A HREF="../../../net/sf/saxon/om/ValueRepresentation.html" title="interface in net.sf.saxon.om">ValueRepresentation</A> value)</CODE> <BR> Supply a parameter using Saxon-specific representations of the name and value</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/Controller.html#setPreparedStylesheet(net.sf.saxon.PreparedStylesheet)">setPreparedStylesheet</A></B>(<A HREF="../../../net/sf/saxon/PreparedStylesheet.html" title="class in net.sf.saxon">PreparedStylesheet</A> sheet)</CODE> <BR> Associate this Controller with a compiled stylesheet.</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/Controller.html#setRecoveryPolicy(int)">setRecoveryPolicy</A></B>(int policy)</CODE> <BR> Set the policy for handling recoverable XSLT errors.</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/Controller.html#setRememberedNumber(net.sf.saxon.om.NodeInfo, int)">setRememberedNumber</A></B>(<A HREF="../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A> node, int number)</CODE> <BR> Set the last remembered node, for node numbering purposes.</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/Controller.html#setRuleManager(net.sf.saxon.trans.RuleManager)">setRuleManager</A></B>(<A HREF="../../../net/sf/saxon/trans/RuleManager.html" title="class in net.sf.saxon.trans">RuleManager</A> r)</CODE> <BR> Set the RuleManager, used to manage template rules for each mode.</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/Controller.html#setSchemaURIResolver(net.sf.saxon.lib.SchemaURIResolver)">setSchemaURIResolver</A></B>(<A HREF="../../../net/sf/saxon/lib/SchemaURIResolver.html" title="interface in net.sf.saxon.lib">SchemaURIResolver</A> resolver)</CODE> <BR> Set the SchemaURIResolver used for resolving references to schema documents.</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/Controller.html#setSchemaValidationMode(int)">setSchemaValidationMode</A></B>(int validationMode)</CODE> <BR> Say whether source documents loaded using the doc(), document(), and collection() functions, or supplied as a StreamSource or SAXSource to the transform() or addParameter() method, should be subjected to schema validation.</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/Controller.html#setStripSourceTrees(boolean)">setStripSourceTrees</A></B>(boolean strip)</CODE> <BR> Say whether the transformation should perform whitespace stripping as defined by the xsl:strip-space and xsl:preserve-space declarations in the stylesheet in the case where a source tree is supplied to the transformation as a tree (typically a DOMSource, or a Saxon NodeInfo).</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/Controller.html#setThereHasBeenAnExplicitResultDocument()">setThereHasBeenAnExplicitResultDocument</A></B>()</CODE> <BR> Set that an explicit result tree has been written using xsl:result-document</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/Controller.html#setTraceFunctionDestination(java.io.PrintStream)">setTraceFunctionDestination</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</A> stream)</CODE> <BR> Set the destination for output from the fn:trace() function.</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/Controller.html#setTraceListener(net.sf.saxon.lib.TraceListener)">setTraceListener</A></B>(<A HREF="../../../net/sf/saxon/lib/TraceListener.html" title="interface in net.sf.saxon.lib">TraceListener</A> listener)</CODE> <BR> Set a TraceListener, replacing any existing TraceListener</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/Controller.html#setTreeModel(int)">setTreeModel</A></B>(int model)</CODE> <BR> <B>Deprecated.</B> <I>since 9.2: use <A HREF="../../../net/sf/saxon/Controller.html#setModel(net.sf.saxon.om.TreeModel)"><CODE>setModel(net.sf.saxon.om.TreeModel)</CODE></A></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/Controller.html#setUnparsedTextURIResolver(net.sf.saxon.lib.UnparsedTextURIResolver)">setUnparsedTextURIResolver</A></B>(<A HREF="../../../net/sf/saxon/lib/UnparsedTextURIResolver.html" title="interface in net.sf.saxon.lib">UnparsedTextURIResolver</A> resolver)</CODE> <BR> Set an UnparsedTextURIResolver to be used to resolve URIs passed to the XSLT unparsed-text() function.</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/Controller.html#setURIResolver(javax.xml.transform.URIResolver)">setURIResolver</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/URIResolver.html?is-external=true" title="class or interface in javax.xml.transform">URIResolver</A> resolver)</CODE> <BR> Set an 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> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../net/sf/saxon/Controller.html#setUseDocumentProjection(net.sf.saxon.expr.parser.PathMap)">setUseDocumentProjection</A></B>(<A HREF="../../../net/sf/saxon/expr/parser/PathMap.html" title="class in net.sf.saxon.expr.parser">PathMap</A> pathMap)</CODE> <BR> Indicate whether document projection should be used, and supply the PathMap used to control it.</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/Controller.html#setUserData(java.lang.Object, java.lang.String, java.lang.Object)">setUserData</A></B>(<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> key, <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> name, <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> data)</CODE> <BR> Set user data associated with a key.</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/Controller.html#transform(javax.xml.transform.Source, javax.xml.transform.Result)">transform</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, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Result.html?is-external=true" title="class or interface in javax.xml.transform">Result</A> result)</CODE> <BR> Perform a transformation from a Source document to a Result document.</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/Controller.html#transformDocument(net.sf.saxon.om.NodeInfo, javax.xml.transform.Result)">transformDocument</A></B>(<A HREF="../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A> startNode, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Result.html?is-external=true" title="class or interface in javax.xml.transform">Result</A> result)</CODE> <BR> Transform a source XML document supplied as a tree.</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/Controller.html#transformStream(javax.xml.transform.Source, net.sf.saxon.trans.Mode, javax.xml.transform.Result)">transformStream</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, <A HREF="../../../net/sf/saxon/trans/Mode.html" title="class in net.sf.saxon.trans">Mode</A> mode, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Result.html?is-external=true" title="class or interface in javax.xml.transform">Result</A> result)</CODE> <BR> Transform a source XML document supplied as a stream, in streaming mode.</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="Controller(net.sf.saxon.Configuration)"><!-- --></A><H3> Controller</H3> <PRE> public <B>Controller</B>(<A HREF="../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A> config)</PRE> <DL> <DD>Create a Controller and initialise variables. Note: XSLT applications should create the Controller by using the JAXP newTransformer() method, or in S9API by using XsltExecutable.load() <P> <DL> <DT><B>Parameters:</B><DD><CODE>config</CODE> - The Configuration used by this Controller</DL> </DL> <HR> <A NAME="Controller(net.sf.saxon.Configuration, net.sf.saxon.expr.instruct.Executable)"><!-- --></A><H3> Controller</H3> <PRE> public <B>Controller</B>(<A HREF="../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A> config, <A HREF="../../../net/sf/saxon/expr/instruct/Executable.html" title="class in net.sf.saxon.expr.instruct">Executable</A> executable)</PRE> <DL> <DD>Create a Controller and initialise variables. <P> <DL> <DT><B>Parameters:</B><DD><CODE>config</CODE> - The Configuration used by this Controller<DD><CODE>executable</CODE> - The executable used by this Controller</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="reset()"><!-- --></A><H3> reset</H3> <PRE> public void <B>reset</B>()</PRE> <DL> <DD><p>Reset this <code>Transformer</code> to its original configuration.</p> <p/> <p><code>Transformer</code> is reset to the same state as when it was created with <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/TransformerFactory.html?is-external=true#newTransformer()" title="class or interface in javax.xml.transform"><CODE>TransformerFactory.newTransformer()</CODE></A>, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/TransformerFactory.html?is-external=true#newTransformer(javax.xml.transform.Source)" title="class or interface in javax.xml.transform"><CODE>TransformerFactory.newTransformer(javax.xml.transform.Source source)</CODE></A> or <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Templates.html?is-external=true#newTransformer()" title="class or interface in javax.xml.transform"><CODE>Templates.newTransformer()</CODE></A>. <code>reset()</code> is designed to allow the reuse of existing <code>Transformer</code>s thus saving resources associated with the creation of new <code>Transformer</code>s.</p> <p> <i>The above is from the JAXP specification. With Saxon, it's unlikely that reusing a Transformer will give any performance benefits over creating a new one. The one case where it might be beneficial is to reuse the document pool (the set of documents that have been loaded using the doc() or document() functions). Therefore, this method does not clear the document pool. If you want to clear the document pool, call the method <A HREF="../../../net/sf/saxon/Controller.html#clearDocumentPool()"><CODE>clearDocumentPool()</CODE></A> as well.</i> <p/> <p>The reset <code>Transformer</code> is not guaranteed to have the same <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/URIResolver.html?is-external=true" title="class or interface in javax.xml.transform"><CODE>URIResolver</CODE></A> or <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/ErrorListener.html?is-external=true" title="class or interface in javax.xml.transform"><CODE>ErrorListener</CODE></A> <code>Object</code>s, e.g. <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"><CODE>Object.equals(Object obj)</CODE></A>. It is guaranteed to have a functionally equal <code>URIResolver</code> and <code>ErrorListener</code>.</p> <P> <DD><DL> <DT><B>Overrides:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#reset()" title="class or interface in javax.xml.transform">reset</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Since:</B></DT> <DD>1.5</DD> </DL> </DD> </DL> <HR> <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 associated with this Controller. The Configuration holds settings that potentially apply globally to many different queries and transformations. <P> <DD><DL> <DT><B>Returns:</B><DD>the Configuration object<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="setInitialMode(java.lang.String)"><!-- --></A><H3> setInitialMode</H3> <PRE> public void <B>setInitialMode</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> expandedModeName)</PRE> <DL> <DD>Set the initial mode for the transformation. <p> XSLT 2.0 allows a transformation to be started in a mode other than the default mode. The transformation then starts by looking for the template rule in this mode that best matches the initial context node. <p> This method may eventually be superseded by a standard JAXP method. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>expandedModeName</CODE> - the name of the initial mode. The mode is supplied as an expanded QName, that is "localname" if there is no namespace, or "{uri}localname" otherwise. If the value is null or zero-length, the initial mode is reset to the unnamed default mode.<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="getInitialModeName()"><!-- --></A><H3> getInitialModeName</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>getInitialModeName</B>()</PRE> <DL> <DD>Get the name of the initial mode for the transformation <P> <DD><DL> <DT><B>Returns:</B><DD>the name of the initial mode, as a name in Clark format; null indicates that the initial mode is the unnamed mode.</DL> </DD> </DL> <HR> <A NAME="getInitialMode()"><!-- --></A><H3> getInitialMode</H3> <PRE> public <A HREF="../../../net/sf/saxon/trans/Mode.html" title="class in net.sf.saxon.trans">Mode</A> <B>getInitialMode</B>()</PRE> <DL> <DD>Get the initial mode for the transformation <P> <DD><DL> <DT><B>Returns:</B><DD>the initial mode. This will be the default/unnamed mode if no specific mode has been requested</DL> </DD> </DL> <HR> <A NAME="setOutputProperties(java.util.Properties)"><!-- --></A><H3> setOutputProperties</H3> <PRE> public void <B>setOutputProperties</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/util/Properties.html?is-external=true" title="class or interface in java.util">Properties</A> properties)</PRE> <DL> <DD>Set the output properties for the transformation. These properties will override properties set in the templates with xsl:output. <p> As well as the properties defined in the JAXP OutputKeys class, Saxon defines an additional set of properties in <A HREF="../../../net/sf/saxon/lib/SaxonOutputKeys.html" title="class in net.sf.saxon.lib"><CODE>SaxonOutputKeys</CODE></A>. These fall into two categories: Constants representing serialization properties defined in XSLT 2.0 (which are not yet supported by JAXP), and constants supporting Saxon extensions to the set of serialization properties. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#setOutputProperties(java.util.Properties)" title="class or interface in javax.xml.transform">setOutputProperties</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>properties</CODE> - the output properties to be used for the transformation. If the value is null, the properties are reset to be the properties of the Templates object (that is, for XSLT 2.0, the properties set in the unnamed xsl:output object). <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 any of the properties are invalid (other than properties in a user-defined namespace)<DT><B>Since:</B></DT> <DD>8.4</DD> <DT><B>See Also:</B><DD><A HREF="../../../net/sf/saxon/lib/SaxonOutputKeys.html" title="class in net.sf.saxon.lib"><CODE>SaxonOutputKeys</CODE></A></DL> </DD> </DL> <HR> <A NAME="getOutputProperties()"><!-- --></A><H3> getOutputProperties</H3> <PRE> public <A HREF="http://download.oracle.com/javase/6/docs/api/java/util/Properties.html?is-external=true" title="class or interface in java.util">Properties</A> <B>getOutputProperties</B>()</PRE> <DL> <DD>Get the output properties for the transformation. <p> As well as the properties defined in the JAXP OutputKeys class, Saxon defines an additional set of properties in <A HREF="../../../net/sf/saxon/lib/SaxonOutputKeys.html" title="class in net.sf.saxon.lib"><CODE>SaxonOutputKeys</CODE></A>. These fall into two categories: Constants representing serialization properties defined in XSLT 2.0 (which are not yet supported by JAXP), and constants supporting Saxon extensions to the set of serialization properties. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#getOutputProperties()" title="class or interface in javax.xml.transform">getOutputProperties</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>the output properties being used for the transformation, including properties defined in the stylesheet for the unnamed output format<DT><B>Since:</B></DT> <DD>8.4</DD> <DT><B>See Also:</B><DD><A HREF="../../../net/sf/saxon/lib/SaxonOutputKeys.html" title="class in net.sf.saxon.lib"><CODE>SaxonOutputKeys</CODE></A></DL> </DD> </DL> <HR> <A NAME="setOutputProperty(java.lang.String, java.lang.String)"><!-- --></A><H3> setOutputProperty</H3> <PRE> public void <B>setOutputProperty</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> name, <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> value)</PRE> <DL> <DD>Set an output property for the transformation. <p>As well as the properties defined in the JAXP OutputKeys class, Saxon defines an additional set of properties in <A HREF="../../../net/sf/saxon/lib/SaxonOutputKeys.html" title="class in net.sf.saxon.lib"><CODE>SaxonOutputKeys</CODE></A>. These fall into two categories: Constants representing serialization properties defined in XSLT 2.0 (which are not yet supported by JAXP), and constants supporting Saxon extensions to the set of serialization properties.</p> <p>As an extension to the JAXP specification, supplying the value "" (a zero-length string) for any parameter has the effect of cancelling any value defined in the stylesheet or query; for example setting doctype-system or doctype-public to "" causes the serializer to be run with these properties taken as absent. This rule does not apply to parameters where "" is a meaningful value, for example cdata-section-elements.</p> <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#setOutputProperty(java.lang.String, java.lang.String)" title="class or interface in javax.xml.transform">setOutputProperty</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the property<DD><CODE>value</CODE> - the value of the property <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 property is invalid (except for properties in a user-defined namespace)<DT><B>Since:</B></DT> <DD>8.4</DD> <DT><B>See Also:</B><DD><A HREF="../../../net/sf/saxon/lib/SaxonOutputKeys.html" title="class in net.sf.saxon.lib"><CODE>SaxonOutputKeys</CODE></A></DL> </DD> </DL> <HR> <A NAME="getOutputProperty(java.lang.String)"><!-- --></A><H3> getOutputProperty</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>getOutputProperty</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> name)</PRE> <DL> <DD>Get the value of an output property. <p> As well as the properties defined in the JAXP OutputKeys class, Saxon defines an additional set of properties in <A HREF="../../../net/sf/saxon/lib/SaxonOutputKeys.html" title="class in net.sf.saxon.lib"><CODE>SaxonOutputKeys</CODE></A>. These fall into two categories: Constants representing serialization properties defined in XSLT 2.0 (which are not yet supported by JAXP), and constants supporting Saxon extensions to the set of serialization properties. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#getOutputProperty(java.lang.String)" title="class or interface in javax.xml.transform">getOutputProperty</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the requested property <DT><B>Returns:</B><DD>the value of the requested property<DT><B>Since:</B></DT> <DD>8.4</DD> <DT><B>See Also:</B><DD><A HREF="../../../net/sf/saxon/lib/SaxonOutputKeys.html" title="class in net.sf.saxon.lib"><CODE>SaxonOutputKeys</CODE></A></DL> </DD> </DL> <HR> <A NAME="setBaseOutputURI(java.lang.String)"><!-- --></A><H3> setBaseOutputURI</H3> <PRE> public void <B>setBaseOutputURI</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> uri)</PRE> <DL> <DD>Set the base output URI. <p>This defaults to the system ID of the Result object for the principal output of the transformation if this is known; if it is not known, it defaults to the current directory.</p> <p> The base output URI is used for resolving relative URIs in the <code>href</code> attribute of the <code>xsl:result-document</code> instruction.</p> <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>uri</CODE> - the base output URI<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="getBaseOutputURI()"><!-- --></A><H3> getBaseOutputURI</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>getBaseOutputURI</B>()</PRE> <DL> <DD>Get the base output URI. <p>This returns the value set using the <A HREF="../../../net/sf/saxon/Controller.html#setBaseOutputURI(java.lang.String)"><CODE>setBaseOutputURI(java.lang.String)</CODE></A> method. If no value has been set explicitly, then the method returns null if called before the transformation, or the computed default base output URI if called after the transformation.</p> <p> The base output URI is used for resolving relative URIs in the <code>href</code> attribute of the <code>xsl:result-document</code> instruction.</p> <P> <DD><DL> <DT><B>Returns:</B><DD>the base output URI<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="getCookedBaseOutputURI()"><!-- --></A><H3> getCookedBaseOutputURI</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>getCookedBaseOutputURI</B>()</PRE> <DL> <DD>Get the base output URI after processing. The processing consists of (a) defaulting to the current user directory if no base URI is available and if the stylesheet is trusted, and (b) applying IRI-to-URI escaping <P> <DD><DL> <DT><B>Returns:</B><DD>the base output URI after processing.</DL> </DD> </DL> <HR> <A NAME="getPrincipalResult()"><!-- --></A><H3> getPrincipalResult</H3> <PRE> public <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Result.html?is-external=true" title="class or interface in javax.xml.transform">Result</A> <B>getPrincipalResult</B>()</PRE> <DL> <DD>Get the principal result destination. <p>This method is intended for internal use only. It is typically called by Saxon during the course of a transformation, to discover the result that was supplied in the transform() call.</p> <P> <DD><DL> <DT><B>Returns:</B><DD>the Result object supplied as the principal result destination.</DL> </DD> </DL> <HR> <A NAME="checkUniqueOutputDestination(net.sf.saxon.om.DocumentURI)"><!-- --></A><H3> checkUniqueOutputDestination</H3> <PRE> public boolean <B>checkUniqueOutputDestination</B>(<A HREF="../../../net/sf/saxon/om/DocumentURI.html" title="class in net.sf.saxon.om">DocumentURI</A> uri)</PRE> <DL> <DD>Check that an output destination has not been used before, optionally adding this URI to the set of URIs that have been used. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>uri</CODE> - the URI to be used as the output destination <DT><B>Returns:</B><DD>true if the URI is available for use; false if it has already been used. <p> This method is intended for internal use only.</DL> </DD> </DL> <HR> <A NAME="addUnavailableOutputDestination(net.sf.saxon.om.DocumentURI)"><!-- --></A><H3> addUnavailableOutputDestination</H3> <PRE> public void <B>addUnavailableOutputDestination</B>(<A HREF="../../../net/sf/saxon/om/DocumentURI.html" title="class in net.sf.saxon.om">DocumentURI</A> uri)</PRE> <DL> <DD>Add a URI to the set of output destinations that cannot be written to, either because they have already been written to, or because they have been read <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>uri</CODE> - A URI that is not available as an output destination</DL> </DD> </DL> <HR> <A NAME="removeUnavailableOutputDestination(net.sf.saxon.om.DocumentURI)"><!-- --></A><H3> removeUnavailableOutputDestination</H3> <PRE> public void <B>removeUnavailableOutputDestination</B>(<A HREF="../../../net/sf/saxon/om/DocumentURI.html" title="class in net.sf.saxon.om">DocumentURI</A> uri)</PRE> <DL> <DD>Remove a URI from the set of output destinations that cannot be written to or read from. Used to support saxon:discard-document() <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>uri</CODE> - A URI that is being made available as an output destination</DL> </DD> </DL> <HR> <A NAME="isUnusedOutputDestination(net.sf.saxon.om.DocumentURI)"><!-- --></A><H3> isUnusedOutputDestination</H3> <PRE> public boolean <B>isUnusedOutputDestination</B>(<A HREF="../../../net/sf/saxon/om/DocumentURI.html" title="class in net.sf.saxon.om">DocumentURI</A> uri)</PRE> <DL> <DD>Determine whether an output URI is available for use. This method is intended for use by applications, via an extension function. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>uri</CODE> - A uri that the application is proposing to use in the href attribute of xsl:result-document: if this function returns false, then the xsl:result-document call will fail saying the URI has already been used. <DT><B>Returns:</B><DD>true if the URI is available for use. Note that this function is not "stable": it may return different results for the same URI at different points in the transformation.</DL> </DD> </DL> <HR> <A NAME="checkImplicitResultTree()"><!-- --></A><H3> checkImplicitResultTree</H3> <PRE> public void <B>checkImplicitResultTree</B>() throws <A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></PRE> <DL> <DD>Check whether an XSLT implicit result tree can be written. This is allowed only if no xsl:result-document has been written for the principal output URI <P> <DD><DL> <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> </DD> </DL> <HR> <A NAME="setThereHasBeenAnExplicitResultDocument()"><!-- --></A><H3> setThereHasBeenAnExplicitResultDocument</H3> <PRE> public void <B>setThereHasBeenAnExplicitResultDocument</B>()</PRE> <DL> <DD>Set that an explicit result tree has been written using xsl:result-document <P> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="hasThereBeenAnExplicitResultDocument()"><!-- --></A><H3> hasThereBeenAnExplicitResultDocument</H3> <PRE> public boolean <B>hasThereBeenAnExplicitResultDocument</B>()</PRE> <DL> <DD>Test whether an explicit result tree has been written using xsl:result-document <P> <DD><DL> <DT><B>Returns:</B><DD>true if the transformation has evaluated an xsl:result-document instruction</DL> </DD> </DL> <HR> <A NAME="allocateSequenceOutputter(int)"><!-- --></A><H3> allocateSequenceOutputter</H3> <PRE> public <A HREF="../../../net/sf/saxon/event/SequenceOutputter.html" title="class in net.sf.saxon.event">SequenceOutputter</A> <B>allocateSequenceOutputter</B>(int size)</PRE> <DL> <DD>Allocate a SequenceOutputter for a new output destination. Reuse the existing one if it is available for reuse (this is designed to ensure that the TinyTree structure is also reused, creating a forest of trees all sharing the same data structure) <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>size</CODE> - the estimated size of the output sequence <DT><B>Returns:</B><DD>SequenceOutputter the allocated SequenceOutputter</DL> </DD> </DL> <HR> <A NAME="reuseSequenceOutputter(net.sf.saxon.event.SequenceOutputter)"><!-- --></A><H3> reuseSequenceOutputter</H3> <PRE> public void <B>reuseSequenceOutputter</B>(<A HREF="../../../net/sf/saxon/event/SequenceOutputter.html" title="class in net.sf.saxon.event">SequenceOutputter</A> out)</PRE> <DL> <DD>Accept a SequenceOutputter that is now available for reuse <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>out</CODE> - the SequenceOutputter that is available for reuse</DL> </DD> </DL> <HR> <A NAME="setInitialTemplate(java.lang.String)"><!-- --></A><H3> setInitialTemplate</H3> <PRE> public void <B>setInitialTemplate</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> expandedName) throws <A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></PRE> <DL> <DD>Set the initial named template to be used as the entry point. <p> XSLT 2.0 allows a transformation to start by executing a named template, rather than by matching an initial context node in a source document. This method may eventually be superseded by a standard JAXP method once JAXP supports XSLT 2.0. <p> Note that any parameters supplied using <A HREF="../../../net/sf/saxon/Controller.html#setParameter(java.lang.String, java.lang.Object)"><CODE>setParameter(java.lang.String, java.lang.Object)</CODE></A> are used as the values of global stylesheet parameters. There is no way to supply values for local parameters of the initial template. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>expandedName</CODE> - The expanded name of the template in {uri}local format, or null or a zero-length string to indicate that there should be no initial template. <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 there is no named template with this name<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="getInitialTemplate()"><!-- --></A><H3> getInitialTemplate</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>getInitialTemplate</B>()</PRE> <DL> <DD>Get the initial template <P> <DD><DL> <DT><B>Returns:</B><DD>the name of the initial template, as an expanded name in Clark format if set, or null otherwise<DT><B>Since:</B></DT> <DD>8.7</DD> </DL> </DD> </DL> <HR> <A NAME="makePipelineConfiguration()"><!-- --></A><H3> makePipelineConfiguration</H3> <PRE> public <A HREF="../../../net/sf/saxon/event/PipelineConfiguration.html" title="class in net.sf.saxon.event">PipelineConfiguration</A> <B>makePipelineConfiguration</B>()</PRE> <DL> <DD>Make a PipelineConfiguration based on the properties of this Controller. <p> This interface is intended primarily for internal use, although it may be necessary for applications to call it directly if they construct pull or push pipelines <P> <DD><DL> <DT><B>Returns:</B><DD>a newly constructed PipelineConfiguration holding a reference to this Controller as well as other configuration information.</DL> </DD> </DL> <HR> <A NAME="setMessageEmitter(net.sf.saxon.event.Receiver)"><!-- --></A><H3> setMessageEmitter</H3> <PRE> public void <B>setMessageEmitter</B>(<A HREF="../../../net/sf/saxon/event/Receiver.html" title="interface in net.sf.saxon.event">Receiver</A> receiver)</PRE> <DL> <DD>Set the Receiver to be used for xsl:message output. <p> Recent versions of the JAXP interface specify that by default the output of xsl:message is sent to the registered ErrorListener. Saxon does not implement this convention. Instead, the output is sent to a default message emitter, which is a slightly customised implementation of the standard Saxon Emitter interface.</p> <p> This interface can be used to change the way in which Saxon outputs xsl:message output.</p> <p> It is not necessary to use this interface in order to change the destination to which messages are written: that can be achieved by obtaining the standard message emitter and calling its <A HREF="../../../net/sf/saxon/serialize/Emitter.html#setWriter(java.io.Writer)"><CODE>Emitter.setWriter(java.io.Writer)</CODE></A> method.</p> <p> Although any <code>Receiver</code> can be supplied as the destination for messages, applications may find it convenient to implement a subclass of <A HREF="../../../net/sf/saxon/event/SequenceWriter.html" title="class in net.sf.saxon.event"><CODE>SequenceWriter</CODE></A>, in which only the abstract <code>write()</code> method is implemented. This will have the effect that the <code>write()</code> method is called to output each message as it is generated, with the <code>Item</code> that is passed to the <code>write()</code> method being the document node at the root of an XML document containing the contents of the message. <p> This method is intended for use by advanced applications. The Receiver interface itself is subject to change in new Saxon releases.</p> <p> The supplied Receiver will have its open() method called once at the start of the transformation, and its close() method will be called once at the end of the transformation. Each individual call of an xsl:message instruction is wrapped by calls of startDocument() and endDocument(). If terminate="yes" is specified on the xsl:message call, the properties argument of the startDocument() call will be set to the value <A HREF="../../../net/sf/saxon/event/ReceiverOptions.html#TERMINATE"><CODE>ReceiverOptions.TERMINATE</CODE></A>.</p> <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>receiver</CODE> - The receiver to receive xsl:message output.<DT><B>Since:</B></DT> <DD>8.4; changed in 8.9 to supply a Receiver rather than an Emitter</DD> </DL> </DD> </DL> <HR> <A NAME="getMessageEmitter()"><!-- --></A><H3> getMessageEmitter</H3> <PRE> public <A HREF="../../../net/sf/saxon/event/Receiver.html" title="interface in net.sf.saxon.event">Receiver</A> <B>getMessageEmitter</B>()</PRE> <DL> <DD>Get the Receiver used for xsl:message output. This returns the emitter previously supplied to the <A HREF="../../../net/sf/saxon/Controller.html#setMessageEmitter(net.sf.saxon.event.Receiver)"><CODE>setMessageEmitter(net.sf.saxon.event.Receiver)</CODE></A> method, or the default message emitter otherwise. <P> <DD><DL> <DT><B>Returns:</B><DD>the Receiver being used for xsl:message output<DT><B>Since:</B></DT> <DD>8.4; changed in 8.9 to return a Receiver rather than an Emitter</DD> </DL> </DD> </DL> <HR> <A NAME="setRecoveryPolicy(int)"><!-- --></A><H3> setRecoveryPolicy</H3> <PRE> public void <B>setRecoveryPolicy</B>(int policy)</PRE> <DL> <DD>Set the policy for handling recoverable XSLT errors. <p>Since 9.3 this call has no effect unless the error listener in use is a <A HREF="../../../net/sf/saxon/lib/StandardErrorListener.html" title="class in net.sf.saxon.lib"><CODE>StandardErrorListener</CODE></A> or a subclass thereof. Calling this method then results in a call to the StandardErrorListener to set the recovery policy, and the action that is taken on calls of the various methods error(), fatalError(), and warning() is then the responsibility of the ErrorListener itself.</p> <p>Since 9.2 the policy for handling the most common recoverable error, namely the ambiguous template match that arises when a node matches more than one match pattern, is a compile-time rather than run-time setting, and can be controlled using <A HREF="../../../net/sf/saxon/trans/CompilerInfo.html#setRecoveryPolicy(int)"><CODE>CompilerInfo.setRecoveryPolicy(int)</CODE></A> </p> <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>policy</CODE> - the recovery policy to be used. The options are <A HREF="../../../net/sf/saxon/Configuration.html#RECOVER_SILENTLY"><CODE>Configuration.RECOVER_SILENTLY</CODE></A>, <A HREF="../../../net/sf/saxon/Configuration.html#RECOVER_WITH_WARNINGS"><CODE>Configuration.RECOVER_WITH_WARNINGS</CODE></A>, or <A HREF="../../../net/sf/saxon/Configuration.html#DO_NOT_RECOVER"><CODE>Configuration.DO_NOT_RECOVER</CODE></A>.<DT><B>Since:</B></DT> <DD>8.7.1</DD> </DL> </DD> </DL> <HR> <A NAME="getRecoveryPolicy()"><!-- --></A><H3> getRecoveryPolicy</H3> <PRE> public int <B>getRecoveryPolicy</B>()</PRE> <DL> <DD>Get the policy for handling recoverable errors <P> <DD><DL> <DT><B>Returns:</B><DD>the current policy. If none has been set with this Controller, the value registered with the Configuration is returned.<DT><B>Since:</B></DT> <DD>8.7.1</DD> </DL> </DD> </DL> <HR> <A NAME="setErrorListener(javax.xml.transform.ErrorListener)"><!-- --></A><H3> setErrorListener</H3> <PRE> public void <B>setErrorListener</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/ErrorListener.html?is-external=true" title="class or interface in javax.xml.transform">ErrorListener</A> listener)</PRE> <DL> <DD>Set the error listener. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#setErrorListener(javax.xml.transform.ErrorListener)" title="class or interface in javax.xml.transform">setErrorListener</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>listener</CODE> - the ErrorListener to be used</DL> </DD> </DL> <HR> <A NAME="getErrorListener()"><!-- --></A><H3> getErrorListener</H3> <PRE> public <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/ErrorListener.html?is-external=true" title="class or interface in javax.xml.transform">ErrorListener</A> <B>getErrorListener</B>()</PRE> <DL> <DD>Get the error listener. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#getErrorListener()" title="class or interface in javax.xml.transform">getErrorListener</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>the ErrorListener in use</DL> </DD> </DL> <HR> <A NAME="recoverableError(net.sf.saxon.trans.XPathException)"><!-- --></A><H3> recoverableError</H3> <PRE> public void <B>recoverableError</B>(<A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A> err) throws <A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></PRE> <DL> <DD>Report a recoverable error. This is an XSLT concept: by default, such an error results in a warning message, and processing continues. In XQuery, however, there are no recoverable errors so a fatal error is reported. <p> This method is intended for internal use only. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>err</CODE> - An exception holding information about the error <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 error listener decides not to recover from the error</DL> </DD> </DL> <HR> <A NAME="reportFatalError(net.sf.saxon.trans.XPathException)"><!-- --></A><H3> reportFatalError</H3> <PRE> public void <B>reportFatalError</B>(<A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A> err)</PRE> <DL> <DD>Report a fatal error <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>err</CODE> - the error to be reported</DL> </DD> </DL> <HR> <A NAME="getExecutable()"><!-- --></A><H3> getExecutable</H3> <PRE> public <A HREF="../../../net/sf/saxon/expr/instruct/Executable.html" title="class in net.sf.saxon.expr.instruct">Executable</A> <B>getExecutable</B>()</PRE> <DL> <DD>Get the Executable object. <p> This method is intended for internal use only. <P> <DD><DL> <DT><B>Returns:</B><DD>the Executable (which represents the compiled stylesheet)</DL> </DD> </DL> <HR> <A NAME="getDocumentPool()"><!-- --></A><H3> getDocumentPool</H3> <PRE> public <A HREF="../../../net/sf/saxon/om/DocumentPool.html" title="class in net.sf.saxon.om">DocumentPool</A> <B>getDocumentPool</B>()</PRE> <DL> <DD>Get the document pool. This is used only for source documents, not for stylesheet modules. <p> This method is intended for internal use only. <P> <DD><DL> <DT><B>Returns:</B><DD>the source document pool</DL> </DD> </DL> <HR> <A NAME="clearDocumentPool()"><!-- --></A><H3> clearDocumentPool</H3> <PRE> public void <B>clearDocumentPool</B>()</PRE> <DL> <DD>Clear the document pool. This is sometimes useful when re-using the same Transformer for a sequence of transformations, but it isn't done automatically, because when the transformations use common look-up documents, the caching is beneficial. <P> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="setInitialContextItem(net.sf.saxon.om.Item)"><!-- --></A><H3> setInitialContextItem</H3> <PRE> public void <B>setInitialContextItem</B>(<A HREF="../../../net/sf/saxon/om/Item.html" title="interface in net.sf.saxon.om">Item</A> item)</PRE> <DL> <DD>Set the initial context item, when running XQuery. <p/> When a transformation is invoked using the <A HREF="../../../net/sf/saxon/Controller.html#transform(javax.xml.transform.Source, javax.xml.transform.Result)"><CODE>transform(javax.xml.transform.Source, javax.xml.transform.Result)</CODE></A> method, the initial context node is set automatically. This method is useful in XQuery, to define an initial context node for evaluating global variables, and also in XSLT 2.0, when the transformation is started by invoking a named template. <p>When an initial context item is set, it also becomes the context item used for evaluating global variables. The two context items can only be different when the <A HREF="../../../net/sf/saxon/Controller.html#transform(javax.xml.transform.Source, javax.xml.transform.Result)"><CODE>transform(javax.xml.transform.Source, javax.xml.transform.Result)</CODE></A> method is used to transform a document starting at a node other than the root.</p> <p>In XQuery, the two context items are always the same; in XSLT, the context node for evaluating global variables is the root of the tree containing the initial context item.</p> <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>item</CODE> - The initial context item.<DT><B>Since:</B></DT> <DD>8.7</DD> </DL> </DD> </DL> <HR> <A NAME="getBindery()"><!-- --></A><H3> getBindery</H3> <PRE> public <A HREF="../../../net/sf/saxon/expr/instruct/Bindery.html" title="class in net.sf.saxon.expr.instruct">Bindery</A> <B>getBindery</B>()</PRE> <DL> <DD>Get the current bindery. <p> This method is intended for internal use only. <P> <DD><DL> <DT><B>Returns:</B><DD>the Bindery (in which values of all variables are held)</DL> </DD> </DL> <HR> <A NAME="getInitialContextItem()"><!-- --></A><H3> getInitialContextItem</H3> <PRE> public <A HREF="../../../net/sf/saxon/om/Item.html" title="interface in net.sf.saxon.om">Item</A> <B>getInitialContextItem</B>()</PRE> <DL> <DD>Get the initial context item. This returns the item (often a document node) previously supplied to the <A HREF="../../../net/sf/saxon/Controller.html#setInitialContextItem(net.sf.saxon.om.Item)"><CODE>setInitialContextItem(net.sf.saxon.om.Item)</CODE></A> method, or the initial context node set implicitly using methods such as <A HREF="../../../net/sf/saxon/Controller.html#transform(javax.xml.transform.Source, javax.xml.transform.Result)"><CODE>transform(javax.xml.transform.Source, javax.xml.transform.Result)</CODE></A>. <P> <DD><DL> <DT><B>Returns:</B><DD>the initial context item. Note that in XSLT this must be a node, but in XQuery it may also be an atomic value.<DT><B>Since:</B></DT> <DD>8.7</DD> </DL> </DD> </DL> <HR> <A NAME="getContextForGlobalVariables()"><!-- --></A><H3> getContextForGlobalVariables</H3> <PRE> public <A HREF="../../../net/sf/saxon/om/Item.html" title="interface in net.sf.saxon.om">Item</A> <B>getContextForGlobalVariables</B>()</PRE> <DL> <DD>Get the item used as the context for evaluating global variables. In XQuery this is the same as the initial context item; in XSLT it is the root of the tree containing the initial context node. <P> <DD><DL> <DT><B>Returns:</B><DD>the context item for evaluating global variables, or null if there is none<DT><B>Since:</B></DT> <DD>8.7</DD> </DL> </DD> </DL> <HR> <A NAME="setURIResolver(javax.xml.transform.URIResolver)"><!-- --></A><H3> setURIResolver</H3> <PRE> public void <B>setURIResolver</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/URIResolver.html?is-external=true" title="class or interface in javax.xml.transform">URIResolver</A> resolver)</PRE> <DL> <DD>Set an object that will be used to resolve URIs used in document(), etc. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#setURIResolver(javax.xml.transform.URIResolver)" title="class or interface in javax.xml.transform">setURIResolver</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <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="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/URIResolver.html?is-external=true" title="class or interface in javax.xml.transform">URIResolver</A> <B>getURIResolver</B>()</PRE> <DL> <DD>Get the URI resolver. <p><i>This method changed in Saxon 8.5, to conform to the JAXP specification. If there is no user-specified URIResolver, it now returns null; previously it returned the system default URIResolver.</i></p> <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#getURIResolver()" title="class or interface in javax.xml.transform">getURIResolver</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>the user-supplied URI resolver if there is one, or null otherwise.</DL> </DD> </DL> <HR> <A NAME="getStandardURIResolver()"><!-- --></A><H3> getStandardURIResolver</H3> <PRE> public <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/URIResolver.html?is-external=true" title="class or interface in javax.xml.transform">URIResolver</A> <B>getStandardURIResolver</B>()</PRE> <DL> <DD>Get the fallback URI resolver. This is the URIResolver that Saxon uses when the user-supplied URI resolver returns null. <p> This method is intended for internal use only. <P> <DD><DL> <DT><B>Returns:</B><DD>the the system-defined URIResolver</DL> </DD> </DL> <HR> <A NAME="setOutputURIResolver(net.sf.saxon.lib.OutputURIResolver)"><!-- --></A><H3> setOutputURIResolver</H3> <PRE> public void <B>setOutputURIResolver</B>(<A HREF="../../../net/sf/saxon/lib/OutputURIResolver.html" title="interface in net.sf.saxon.lib">OutputURIResolver</A> resolver)</PRE> <DL> <DD>Set the URI resolver for secondary output documents. <p> XSLT 2.0 introduces the <code>xsl:result-document</code instruction, allowing a transformation to have multiple result documents. JAXP does not yet support this capability. This method allows an OutputURIResolver to be specified that takes responsibility for deciding the destination (and, if it wishes, the serialization properties) of secondary output files. <p> This method may eventually be superseded by a standard JAXP method. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>resolver</CODE> - An object that implements the OutputURIResolver interface, or null.<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="getOutputURIResolver()"><!-- --></A><H3> getOutputURIResolver</H3> <PRE> public <A HREF="../../../net/sf/saxon/lib/OutputURIResolver.html" title="interface in net.sf.saxon.lib">OutputURIResolver</A> <B>getOutputURIResolver</B>()</PRE> <DL> <DD>Get the output URI resolver. <P> <DD><DL> <DT><B>Returns:</B><DD>the user-supplied URI resolver if there is one, or the system-defined one otherwise.<DT><B>Since:</B></DT> <DD>8.4</DD> <DT><B>See Also:</B><DD><A HREF="../../../net/sf/saxon/Controller.html#setOutputURIResolver(net.sf.saxon.lib.OutputURIResolver)"><CODE>setOutputURIResolver(net.sf.saxon.lib.OutputURIResolver)</CODE></A></DL> </DD> </DL> <HR> <A NAME="setUnparsedTextURIResolver(net.sf.saxon.lib.UnparsedTextURIResolver)"><!-- --></A><H3> setUnparsedTextURIResolver</H3> <PRE> public void <B>setUnparsedTextURIResolver</B>(<A HREF="../../../net/sf/saxon/lib/UnparsedTextURIResolver.html" title="interface in net.sf.saxon.lib">UnparsedTextURIResolver</A> resolver)</PRE> <DL> <DD>Set an UnparsedTextURIResolver to be used to resolve URIs passed to the XSLT unparsed-text() function. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>resolver</CODE> - the unparsed text URI resolver to be used. This replaces any unparsed text URI resolver previously registered.<DT><B>Since:</B></DT> <DD>8.9</DD> </DL> </DD> </DL> <HR> <A NAME="getUnparsedTextURIResolver()"><!-- --></A><H3> getUnparsedTextURIResolver</H3> <PRE> public <A HREF="../../../net/sf/saxon/lib/UnparsedTextURIResolver.html" title="interface in net.sf.saxon.lib">UnparsedTextURIResolver</A> <B>getUnparsedTextURIResolver</B>()</PRE> <DL> <DD>Get the URI resolver for the unparsed-text() function. This will return the UnparsedTextURIResolver previously set using the <A HREF="../../../net/sf/saxon/Controller.html#setUnparsedTextURIResolver(net.sf.saxon.lib.UnparsedTextURIResolver)"><CODE>setUnparsedTextURIResolver(net.sf.saxon.lib.UnparsedTextURIResolver)</CODE></A> method. <P> <DD><DL> <DT><B>Returns:</B><DD>the registered UnparsedTextURIResolver<DT><B>Since:</B></DT> <DD>8.9</DD> </DL> </DD> </DL> <HR> <A NAME="setSchemaURIResolver(net.sf.saxon.lib.SchemaURIResolver)"><!-- --></A><H3> setSchemaURIResolver</H3> <PRE> public void <B>setSchemaURIResolver</B>(<A HREF="../../../net/sf/saxon/lib/SchemaURIResolver.html" title="interface in net.sf.saxon.lib">SchemaURIResolver</A> resolver)</PRE> <DL> <DD>Set the SchemaURIResolver used for resolving references to schema documents. Defaults to the SchemaURIResolver registered with the Configuration <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>resolver</CODE> - the resolver for references to schema documents</DL> </DD> </DL> <HR> <A NAME="getSchemaURIResolver()"><!-- --></A><H3> getSchemaURIResolver</H3> <PRE> public <A HREF="../../../net/sf/saxon/lib/SchemaURIResolver.html" title="interface in net.sf.saxon.lib">SchemaURIResolver</A> <B>getSchemaURIResolver</B>()</PRE> <DL> <DD>Get the SchemaURIResolver used for resolving references to schema documents. If none has been set on the Controller, returns the SchemaURIResolver registered with the Configuration <P> <DD><DL> <DT><B>Returns:</B><DD>the resolver for references to schema documents</DL> </DD> </DL> <HR> <A NAME="setCollectionURIResolver(net.sf.saxon.lib.CollectionURIResolver)"><!-- --></A><H3> setCollectionURIResolver</H3> <PRE> public void <B>setCollectionURIResolver</B>(<A HREF="../../../net/sf/saxon/lib/CollectionURIResolver.html" title="interface in net.sf.saxon.lib">CollectionURIResolver</A> resolver)</PRE> <DL> <DD>Set the CollectionURIResolver used for resolving collection URIs. Defaults to the CollectionURIResolver registered with the Configuration <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>resolver</CODE> - the resolver for references to collections<DT><B>Since:</B></DT> <DD>9.4</DD> </DL> </DD> </DL> <HR> <A NAME="getCollectionURIResolver()"><!-- --></A><H3> getCollectionURIResolver</H3> <PRE> public <A HREF="../../../net/sf/saxon/lib/CollectionURIResolver.html" title="interface in net.sf.saxon.lib">CollectionURIResolver</A> <B>getCollectionURIResolver</B>()</PRE> <DL> <DD>Get the CollectionURIResolver used for resolving references to collections. If none has been set on the Controller, returns the CollectionURIResolver registered with the Configuration <P> <DD><DL> <DT><B>Returns:</B><DD>the resolver for references to collections<DT><B>Since:</B></DT> <DD>9.4</DD> </DL> </DD> </DL> <HR> <A NAME="setDefaultCollection(java.lang.String)"><!-- --></A><H3> setDefaultCollection</H3> <PRE> public void <B>setDefaultCollection</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> uri)</PRE> <DL> <DD>Set the name of the default collection. Defaults to the default collection name registered with the Configuration. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>uri</CODE> - the collection URI of the default collection. May be null, to cause fallback to the collection name registered with the Configuration. The name will be passed to the collection URI resolver to identify the documents in the collection, unless the name is <code>http://saxon.sf.net/collection/empty</code> which always refers to the empty collection.<DT><B>Since:</B></DT> <DD>9.4</DD> </DL> </DD> </DL> <HR> <A NAME="getDefaultCollection()"><!-- --></A><H3> getDefaultCollection</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>getDefaultCollection</B>()</PRE> <DL> <DD>Get the name of the default collection. Defaults to the default collection name registered with the Configuration. <P> <DD><DL> <DT><B>Returns:</B><DD>the collection URI of the default collection. If no value has been set explicitly, the collection URI registered with the Configuration is returned<DT><B>Since:</B></DT> <DD>9.4</DD> </DL> </DD> </DL> <HR> <A NAME="getSchemaValidationMode()"><!-- --></A><H3> getSchemaValidationMode</H3> <PRE> public int <B>getSchemaValidationMode</B>()</PRE> <DL> <DD>Ask whether source documents loaded using the doc(), document(), and collection() functions, or supplied as a StreamSource or SAXSource to the transform() or addParameter() method should be subjected to schema validation <P> <DD><DL> <DT><B>Returns:</B><DD>the schema validation mode previously set using setSchemaValidationMode(), or the default mode <A HREF="../../../net/sf/saxon/lib/Validation.html#STRIP"><CODE>Validation.STRIP</CODE></A> otherwise.</DL> </DD> </DL> <HR> <A NAME="setSchemaValidationMode(int)"><!-- --></A><H3> setSchemaValidationMode</H3> <PRE> public void <B>setSchemaValidationMode</B>(int validationMode)</PRE> <DL> <DD>Say whether source documents loaded using the doc(), document(), and collection() functions, or supplied as a StreamSource or SAXSource to the transform() or addParameter() method, should be subjected to schema validation. The default value is taken from the corresponding property of the Configuration. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>validationMode</CODE> - the validation (or construction) mode to be used for source documents. One of <A HREF="../../../net/sf/saxon/lib/Validation.html#STRIP"><CODE>Validation.STRIP</CODE></A>, <A HREF="../../../net/sf/saxon/lib/Validation.html#PRESERVE"><CODE>Validation.PRESERVE</CODE></A>, <A HREF="../../../net/sf/saxon/lib/Validation.html#STRICT"><CODE>Validation.STRICT</CODE></A>, <A HREF="../../../net/sf/saxon/lib/Validation.html#LAX"><CODE>Validation.LAX</CODE></A><DT><B>Since:</B></DT> <DD>9.2</DD> </DL> </DD> </DL> <HR> <A NAME="getKeyManager()"><!-- --></A><H3> getKeyManager</H3> <PRE> public <A HREF="../../../net/sf/saxon/trans/KeyManager.html" title="class in net.sf.saxon.trans">KeyManager</A> <B>getKeyManager</B>()</PRE> <DL> <DD>Get the KeyManager. <p> This method is intended for internal use only. <P> <DD><DL> <DT><B>Returns:</B><DD>the KeyManager, which holds details of all key declarations</DL> </DD> </DL> <HR> <A NAME="getNamePool()"><!-- --></A><H3> getNamePool</H3> <PRE> public <A HREF="../../../net/sf/saxon/om/NamePool.html" title="class in net.sf.saxon.om">NamePool</A> <B>getNamePool</B>()</PRE> <DL> <DD>Get the name pool in use. The name pool is responsible for mapping QNames used in source documents and compiled stylesheets and queries into numeric codes. All source documents used by a given transformation or query must use the same name pool as the compiled stylesheet or query. <P> <DD><DL> <DT><B>Returns:</B><DD>the name pool in use<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="setTreeModel(int)"><!-- --></A><H3> setTreeModel</H3> <PRE> public void <B>setTreeModel</B>(int model)</PRE> <DL> <DD><B>Deprecated.</B> <I>since 9.2: use <A HREF="../../../net/sf/saxon/Controller.html#setModel(net.sf.saxon.om.TreeModel)"><CODE>setModel(net.sf.saxon.om.TreeModel)</CODE></A></I> <P> <DD>Set the tree data model to use. This affects all source documents subsequently constructed using a Builder obtained from this Controller. This includes a document built from a StreamSource or SAXSource supplied as a parameter to the <A HREF="../../../net/sf/saxon/Controller.html#transform(javax.xml.transform.Source, javax.xml.transform.Result)"><CODE>transform(javax.xml.transform.Source, javax.xml.transform.Result)</CODE></A> method. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>model</CODE> - the required tree model: <A HREF="../../../net/sf/saxon/event/Builder.html#LINKED_TREE"><CODE>Builder.LINKED_TREE</CODE></A>, <A HREF="../../../net/sf/saxon/event/Builder.html#TINY_TREE"><CODE>Builder.TINY_TREE</CODE></A>, or <A HREF="../../../net/sf/saxon/event/Builder.html#TINY_TREE_CONDENSED"><CODE>Builder.TINY_TREE_CONDENSED</CODE></A><DT><B>Since:</B></DT> <DD>8.4 (Condensed tinytree added in 9.2)</DD> <DT><B>See Also:</B><DD><A HREF="../../../net/sf/saxon/event/Builder.html" title="class in net.sf.saxon.event"><CODE>Builder</CODE></A></DL> </DD> </DL> <HR> <A NAME="getTreeModel()"><!-- --></A><H3> getTreeModel</H3> <PRE> public int <B>getTreeModel</B>()</PRE> <DL> <DD><B>Deprecated.</B> <I>since 9.2: use <A HREF="../../../net/sf/saxon/Controller.html#getModel()"><CODE>getModel()</CODE></A></I> <P> <DD>Get the tree data model to use. This affects all source documents subsequently constructed using a Builder obtained from this Controller. This includes a document built from a StreamSource or SAXSource supplied as a parameter to the <A HREF="../../../net/sf/saxon/Controller.html#transform(javax.xml.transform.Source, javax.xml.transform.Result)"><CODE>transform(javax.xml.transform.Source, javax.xml.transform.Result)</CODE></A> method. <P> <DD><DL> <DT><B>Returns:</B><DD>model the tree model: <A HREF="../../../net/sf/saxon/event/Builder.html#LINKED_TREE"><CODE>Builder.LINKED_TREE</CODE></A>, <A HREF="../../../net/sf/saxon/event/Builder.html#TINY_TREE"><CODE>Builder.TINY_TREE</CODE></A>, or <A HREF="../../../net/sf/saxon/event/Builder.html#TINY_TREE_CONDENSED"><CODE>Builder.TINY_TREE_CONDENSED</CODE></A><DT><B>Since:</B></DT> <DD>9.1 (Condensed tinytree added in 9.2)</DD> <DT><B>See Also:</B><DD><A HREF="../../../net/sf/saxon/event/Builder.html" title="class in net.sf.saxon.event"><CODE>Builder</CODE></A></DL> </DD> </DL> <HR> <A NAME="setModel(net.sf.saxon.om.TreeModel)"><!-- --></A><H3> setModel</H3> <PRE> public void <B>setModel</B>(<A HREF="../../../net/sf/saxon/om/TreeModel.html" title="class in net.sf.saxon.om">TreeModel</A> model)</PRE> <DL> <DD>Set the tree model to use. Default is the tiny tree <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>model</CODE> - typically one of the constants <A HREF="../../../net/sf/saxon/om/TreeModel.html#TINY_TREE"><CODE>TreeModel.TINY_TREE</CODE></A>, <A HREF="../../../net/sf/saxon/om/TreeModel.html#TINY_TREE_CONDENSED"><CODE>TreeModel.TINY_TREE_CONDENSED</CODE></A>, or <A HREF="../../../net/sf/saxon/om/TreeModel.html#LINKED_TREE"><CODE>TreeModel.LINKED_TREE</CODE></A>. It is also possible to use a user-defined tree model.<DT><B>Since:</B></DT> <DD>9.2</DD> </DL> </DD> </DL> <HR> <A NAME="getModel()"><!-- --></A><H3> getModel</H3> <PRE> public <A HREF="../../../net/sf/saxon/om/TreeModel.html" title="class in net.sf.saxon.om">TreeModel</A> <B>getModel</B>()</PRE> <DL> <DD>Get the tree model that will be used. <P> <DD><DL> <DT><B>Returns:</B><DD>typically one of the constants <A HREF="../../../net/sf/saxon/om/TreeModel.html#TINY_TREE"><CODE>TreeModel.TINY_TREE</CODE></A>, <A HREF="../../../net/sf/saxon/om/TreeModel.html#TINY_TREE_CONDENSED"><CODE>TreeModel.TINY_TREE_CONDENSED</CODE></A>, or <A HREF="../../../net/sf/saxon/om/TreeModel.html#LINKED_TREE"><CODE>TreeModel.LINKED_TREE</CODE></A>. It is also possible to use a user-defined tree model.<DT><B>Since:</B></DT> <DD>9.2</DD> </DL> </DD> </DL> <HR> <A NAME="makeBuilder()"><!-- --></A><H3> makeBuilder</H3> <PRE> public <A HREF="../../../net/sf/saxon/event/Builder.html" title="class in net.sf.saxon.event">Builder</A> <B>makeBuilder</B>()</PRE> <DL> <DD>Make a builder for the selected tree model. <P> <DD><DL> <DT><B>Returns:</B><DD>an instance of the Builder for the chosen tree model<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="setStripSourceTrees(boolean)"><!-- --></A><H3> setStripSourceTrees</H3> <PRE> public void <B>setStripSourceTrees</B>(boolean strip)</PRE> <DL> <DD>Say whether the transformation should perform whitespace stripping as defined by the xsl:strip-space and xsl:preserve-space declarations in the stylesheet in the case where a source tree is supplied to the transformation as a tree (typically a DOMSource, or a Saxon NodeInfo). The default is true. It is legitimate to suppress whitespace stripping if the client knows that all unnecessary whitespace has already been removed from the tree before it is processed. Note that this option applies to all source documents for which whitespace-stripping is normally applied, that is, both the principal source documents, and documents read using the doc(), document(), and collection() functions. It does not apply to source documents that are supplied in the form of a SAXSource or StreamSource, for which whitespace is stripped during the process of tree construction. <p>Generally, stripping whitespace speeds up the transformation if it is done while building the source tree, but slows it down if it is applied to a tree that has already been built. So if the same source tree is used as input to a number of transformations, it is better to strip the whitespace once at the time of tree construction, rather than doing it on-the-fly during each transformation.</p> <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>strip</CODE> - true if whitespace is to be stripped from supplied source trees as defined by xsl:strip-space; false to suppress whitespace stripping<DT><B>Since:</B></DT> <DD>9.3</DD> </DL> </DD> </DL> <HR> <A NAME="isStripSourceTree()"><!-- --></A><H3> isStripSourceTree</H3> <PRE> public boolean <B>isStripSourceTree</B>()</PRE> <DL> <DD>Ask whether the transformation will perform whitespace stripping for supplied source trees as defined by the xsl:strip-space and xsl:preserve-space declarations in the stylesheet. <P> <DD><DL> <DT><B>Returns:</B><DD>true unless whitespace stripping has been suppressed using <A HREF="../../../net/sf/saxon/Controller.html#setStripSourceTrees(boolean)"><CODE>setStripSourceTrees(boolean)</CODE></A>.<DT><B>Since:</B></DT> <DD>9.3</DD> </DL> </DD> </DL> <HR> <A NAME="makeStripper(net.sf.saxon.event.Receiver)"><!-- --></A><H3> makeStripper</H3> <PRE> public <A HREF="../../../net/sf/saxon/event/Stripper.html" title="class in net.sf.saxon.event">Stripper</A> <B>makeStripper</B>(<A HREF="../../../net/sf/saxon/event/Receiver.html" title="interface in net.sf.saxon.event">Receiver</A> next)</PRE> <DL> <DD>Make a Stripper configured to implement the whitespace stripping rules. In the case of XSLT the whitespace stripping rules are normally defined by <code>xsl:strip-space</code> and <code>xsl:preserve-space</code elements in the stylesheet. Alternatively, stripping of all whitespace text nodes may be defined at the level of the Configuration, using the method <A HREF="../../../net/sf/saxon/Configuration.html#setStripsAllWhiteSpace(boolean)"><CODE>Configuration.setStripsAllWhiteSpace(boolean)</CODE></A>. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>next</CODE> - the Receiver to which the events filtered by this stripper are to be sent (often a Builder). May be null if the stripper is not being used for filtering into a Builder or other Receiver. <DT><B>Returns:</B><DD>the required Stripper. A Stripper may be used in two ways. It acts as a filter applied to an event stream, that can be used to remove the events representing whitespace text nodes before they reach a Builder. Alternatively, it can be used to define a view of an existing tree in which the whitespace text nodes are dynamically skipped while navigating the XPath axes.<DT><B>Since:</B></DT> <DD>8.4 - Generalized in 8.5 to accept any Receiver as an argument</DD> </DL> </DD> </DL> <HR> <A NAME="getSpaceStrippingRule()"><!-- --></A><H3> getSpaceStrippingRule</H3> <PRE> public <A HREF="../../../net/sf/saxon/om/SpaceStrippingRule.html" title="interface in net.sf.saxon.om">SpaceStrippingRule</A> <B>getSpaceStrippingRule</B>()</PRE> <DL> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="registerDocument(net.sf.saxon.om.DocumentInfo, net.sf.saxon.om.DocumentURI)"><!-- --></A><H3> registerDocument</H3> <PRE> public void <B>registerDocument</B>(<A HREF="../../../net/sf/saxon/om/DocumentInfo.html" title="interface in net.sf.saxon.om">DocumentInfo</A> doc, <A HREF="../../../net/sf/saxon/om/DocumentURI.html" title="class in net.sf.saxon.om">DocumentURI</A> uri) throws <A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></PRE> <DL> <DD>Add a document to the document pool, and check that it is suitable for use in this query or transformation. This check rejects the document if document has been validated (and thus carries type annotations) but the query or transformation is not schema-aware. <p> This method is intended for internal use only. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>doc</CODE> - the root node of the document to be added. Must not be null.<DD><CODE>uri</CODE> - the document-URI property of this document. If non-null, the document is registered in the document pool with this as its document URI. <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> </DD> </DL> <HR> <A NAME="setRuleManager(net.sf.saxon.trans.RuleManager)"><!-- --></A><H3> setRuleManager</H3> <PRE> public void <B>setRuleManager</B>(<A HREF="../../../net/sf/saxon/trans/RuleManager.html" title="class in net.sf.saxon.trans">RuleManager</A> r)</PRE> <DL> <DD>Set the RuleManager, used to manage template rules for each mode. <p> This method is intended for internal use only. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>r</CODE> - the Rule Manager</DL> </DD> </DL> <HR> <A NAME="getRuleManager()"><!-- --></A><H3> getRuleManager</H3> <PRE> public <A HREF="../../../net/sf/saxon/trans/RuleManager.html" title="class in net.sf.saxon.trans">RuleManager</A> <B>getRuleManager</B>()</PRE> <DL> <DD>Get the Rule Manager. <p> This method is intended for internal use only. <P> <DD><DL> <DT><B>Returns:</B><DD>the Rule Manager, used to hold details of template rules for all modes</DL> </DD> </DL> <HR> <A NAME="setTraceListener(net.sf.saxon.lib.TraceListener)"><!-- --></A><H3> setTraceListener</H3> <PRE> public void <B>setTraceListener</B>(<A HREF="../../../net/sf/saxon/lib/TraceListener.html" title="interface in net.sf.saxon.lib">TraceListener</A> listener)</PRE> <DL> <DD>Set a TraceListener, replacing any existing TraceListener <p>This method has no effect unless the stylesheet or query was compiled with tracing enabled.</p> <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>listener</CODE> - the TraceListener to be set. May be null, in which case trace events will not be reported<DT><B>Since:</B></DT> <DD>9.2</DD> </DL> </DD> </DL> <HR> <A NAME="getTraceListener()"><!-- --></A><H3> getTraceListener</H3> <PRE> public <A HREF="../../../net/sf/saxon/lib/TraceListener.html" title="interface in net.sf.saxon.lib">TraceListener</A> <B>getTraceListener</B>()</PRE> <DL> <DD>Get the TraceListener. By default, there is no TraceListener, and this method returns null. A TraceListener may be added using the method <A HREF="../../../net/sf/saxon/Controller.html#addTraceListener(net.sf.saxon.lib.TraceListener)"><CODE>addTraceListener(net.sf.saxon.lib.TraceListener)</CODE></A>. If more than one TraceListener has been added, this method will return a composite TraceListener. Because the form this takes is implementation-dependent, this method is not part of the stable Saxon public API. <P> <DD><DL> <DT><B>Returns:</B><DD>the TraceListener used for XSLT or XQuery instruction tracing, or null if absent.</DL> </DD> </DL> <HR> <A NAME="isTracing()"><!-- --></A><H3> isTracing</H3> <PRE> public final boolean <B>isTracing</B>()</PRE> <DL> <DD>Test whether instruction execution is being traced. This will be true if (a) at least one TraceListener has been registered using the <A HREF="../../../net/sf/saxon/Controller.html#addTraceListener(net.sf.saxon.lib.TraceListener)"><CODE>addTraceListener(net.sf.saxon.lib.TraceListener)</CODE></A> method, and (b) tracing has not been temporarily paused using the <A HREF="../../../net/sf/saxon/Controller.html#pauseTracing(boolean)"><CODE>pauseTracing(boolean)</CODE></A> method. <P> <DD><DL> <DT><B>Returns:</B><DD>true if tracing is active, false otherwise<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="pauseTracing(boolean)"><!-- --></A><H3> pauseTracing</H3> <PRE> public final void <B>pauseTracing</B>(boolean pause)</PRE> <DL> <DD>Pause or resume tracing. While tracing is paused, trace events are not sent to any of the registered TraceListeners. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>pause</CODE> - true if tracing is to pause; false if it is to resume<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="addTraceListener(net.sf.saxon.lib.TraceListener)"><!-- --></A><H3> addTraceListener</H3> <PRE> public void <B>addTraceListener</B>(<A HREF="../../../net/sf/saxon/lib/TraceListener.html" title="interface in net.sf.saxon.lib">TraceListener</A> trace)</PRE> <DL> <DD>Adds the specified trace listener to receive trace events from this instance. Note that although TraceListeners can be added or removed dynamically, this has no effect unless the stylesheet or query has been compiled with tracing enabled. This is achieved by calling <A HREF="../../../net/sf/saxon/Configuration.html#setTraceListener(net.sf.saxon.lib.TraceListener)"><CODE>Configuration.setTraceListener(net.sf.saxon.lib.TraceListener)</CODE></A> or by setting the attribute <A HREF="../../../net/sf/saxon/lib/FeatureKeys.html#TRACE_LISTENER"><CODE>FeatureKeys.TRACE_LISTENER</CODE></A> on the TransformerFactory. Conversely, if this property has been set in the Configuration or TransformerFactory, the TraceListener will automatically be added to every Controller that uses that Configuration. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>trace</CODE> - the trace listener. If null is supplied, the call has no effect.<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="removeTraceListener(net.sf.saxon.lib.TraceListener)"><!-- --></A><H3> removeTraceListener</H3> <PRE> public void <B>removeTraceListener</B>(<A HREF="../../../net/sf/saxon/lib/TraceListener.html" title="interface in net.sf.saxon.lib">TraceListener</A> trace)</PRE> <DL> <DD>Removes the specified trace listener so that the listener will no longer receive trace events. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>trace</CODE> - the trace listener.<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="setTraceFunctionDestination(java.io.PrintStream)"><!-- --></A><H3> setTraceFunctionDestination</H3> <PRE> public void <B>setTraceFunctionDestination</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</A> stream)</PRE> <DL> <DD>Set the destination for output from the fn:trace() function. By default, the destination is System.err. If a TraceListener is in use, this is ignored, and the trace() output is sent to the TraceListener. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>stream</CODE> - the PrintStream to which trace output will be sent. If set to null, trace output is suppressed entirely. It is the caller's responsibility to close the stream after use.<DT><B>Since:</B></DT> <DD>9.1</DD> </DL> </DD> </DL> <HR> <A NAME="getTraceFunctionDestination()"><!-- --></A><H3> getTraceFunctionDestination</H3> <PRE> public <A HREF="http://download.oracle.com/javase/6/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</A> <B>getTraceFunctionDestination</B>()</PRE> <DL> <DD>Get the destination for output from the fn:trace() function. <P> <DD><DL> <DT><B>Returns:</B><DD>the PrintStream to which trace output will be sent. If no explicitly destination has been set, returns System.err. If the destination has been set to null to suppress trace output, returns null.<DT><B>Since:</B></DT> <DD>9.1</DD> </DL> </DD> </DL> <HR> <A NAME="setPreparedStylesheet(net.sf.saxon.PreparedStylesheet)"><!-- --></A><H3> setPreparedStylesheet</H3> <PRE> public void <B>setPreparedStylesheet</B>(<A HREF="../../../net/sf/saxon/PreparedStylesheet.html" title="class in net.sf.saxon">PreparedStylesheet</A> sheet)</PRE> <DL> <DD>Associate this Controller with a compiled stylesheet. <p> This method is intended for internal use only. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>sheet</CODE> - the compiled stylesheet</DL> </DD> </DL> <HR> <A NAME="setExecutable(net.sf.saxon.expr.instruct.Executable)"><!-- --></A><H3> setExecutable</H3> <PRE> public void <B>setExecutable</B>(<A HREF="../../../net/sf/saxon/expr/instruct/Executable.html" title="class in net.sf.saxon.expr.instruct">Executable</A> exec)</PRE> <DL> <DD>Associate this Controller with an Executable. This method is used by the XQuery processor. The Executable object is overkill in this case - the only thing it currently holds are copies of the collation table. <p> This method is intended for internal use only <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>exec</CODE> - the Executable</DL> </DD> </DL> <HR> <A NAME="defineGlobalParameters()"><!-- --></A><H3> defineGlobalParameters</H3> <PRE> public void <B>defineGlobalParameters</B>() throws <A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></PRE> <DL> <DD>Register the global parameters of the transformation or query. This should be called after a sequence of calls on <A HREF="../../../net/sf/saxon/Controller.html#setParameter(java.lang.String, java.lang.Object)"><CODE>setParameter(java.lang.String, java.lang.Object)</CODE></A>. It checks that all required parameters have been supplied, and places the values of the parameters in the Bindery to make them available for use during the query or transformation. <p> This method is intended for internal use only <P> <DD><DL> <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> </DD> </DL> <HR> <A NAME="allocateGlobalVariables(int)"><!-- --></A><H3> allocateGlobalVariables</H3> <PRE> public void <B>allocateGlobalVariables</B>(int numberOfVariables)</PRE> <DL> <DD>Allocate space in the bindery for global variables. <p>For internal use only.</p> <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>numberOfVariables</CODE> - the number of global variables for which space is required</DL> </DD> </DL> <HR> <A NAME="getUserData(java.lang.Object, java.lang.String)"><!-- --></A><H3> getUserData</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>getUserData</B>(<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> key, <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> name)</PRE> <DL> <DD>Get user data associated with a key. To retrieve user data, two objects are required: an arbitrary object that may be regarded as the container of the data (originally, and typically still, a node in a tree), and a name. The name serves to distingush data objects associated with the same node by different client applications. <p> This method is intended primarily for internal use, though it may also be used by advanced applications. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>key</CODE> - an object acting as a key for this user data value. This must be equal (in the sense of the equals() method) to the key supplied when the data value was registered using <A HREF="../../../net/sf/saxon/Controller.html#setUserData(java.lang.Object, java.lang.String, java.lang.Object)"><CODE>setUserData(java.lang.Object, java.lang.String, java.lang.Object)</CODE></A>.<DD><CODE>name</CODE> - the name of the required property <DT><B>Returns:</B><DD>the value of the required property</DL> </DD> </DL> <HR> <A NAME="setUserData(java.lang.Object, java.lang.String, java.lang.Object)"><!-- --></A><H3> setUserData</H3> <PRE> public void <B>setUserData</B>(<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> key, <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> name, <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> data)</PRE> <DL> <DD>Set user data associated with a key. To store user data, two objects are required: an arbitrary object that may be regarded as the container of the data (originally, and typically still, a node in a tree), and a name. The name serves to distingush data objects associated with the same node by different client applications. <p> This method is intended primarily for internal use, though it may also be used by advanced applications. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>key</CODE> - an object acting as a key for this user data value. This can be any object, for example a node or a string. If data for the given object and name already exists, it is overwritten.<DD><CODE>name</CODE> - the name of the required property<DD><CODE>data</CODE> - the value of the required property. If null is supplied, any existing entry for the key is removed.</DL> </DD> </DL> <HR> <A NAME="transform(javax.xml.transform.Source, javax.xml.transform.Result)"><!-- --></A><H3> transform</H3> <PRE> public void <B>transform</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, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Result.html?is-external=true" title="class or interface in javax.xml.transform">Result</A> result) throws <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/TransformerException.html?is-external=true" title="class or interface in javax.xml.transform">TransformerException</A></PRE> <DL> <DD>Perform a transformation from a Source document to a Result document. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#transform(javax.xml.transform.Source, javax.xml.transform.Result)" title="class or interface in javax.xml.transform">transform</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>source</CODE> - The input for the source tree. May be null if and only if an initial template has been supplied.<DD><CODE>result</CODE> - The destination for the result tree. <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 transformation fails. As a special case, the method throws a TerminationException (a subclass of XPathException) if the transformation was terminated using xsl:message terminate="yes". <DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/TransformerException.html?is-external=true" title="class or interface in javax.xml.transform">TransformerException</A></CODE></DL> </DD> </DL> <HR> <A NAME="prepareInputTree(javax.xml.transform.Source)"><!-- --></A><H3> prepareInputTree</H3> <PRE> public <A HREF="../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A> <B>prepareInputTree</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)</PRE> <DL> <DD>Prepare an input tree for processing. This is used when either the initial input, or a Source returned by the document() function, is a NodeInfo or a DOMSource. The preparation consists of wrapping a DOM document inside a wrapper that implements the NodeInfo interface, and/or adding a space-stripping wrapper if the stylesheet strips whitespace nodes, and/or adding a type-stripping wrapper if the stylesheet strips input type annotations. <p> This method is intended for internal use. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>source</CODE> - the input tree. Must be either a DOMSource or a NodeInfo <DT><B>Returns:</B><DD>the NodeInfo representing the input node, suitably wrapped.</DL> </DD> </DL> <HR> <A NAME="transformDocument(net.sf.saxon.om.NodeInfo, javax.xml.transform.Result)"><!-- --></A><H3> transformDocument</H3> <PRE> public void <B>transformDocument</B>(<A HREF="../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A> startNode, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Result.html?is-external=true" title="class or interface in javax.xml.transform">Result</A> result) throws <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/TransformerException.html?is-external=true" title="class or interface in javax.xml.transform">TransformerException</A></PRE> <DL> <DD>Transform a source XML document supplied as a tree. <br> <p> This method is intended for internal use. External applications should use the <A HREF="../../../net/sf/saxon/Controller.html#transform(javax.xml.transform.Source, javax.xml.transform.Result)"><CODE>transform(javax.xml.transform.Source, javax.xml.transform.Result)</CODE></A> method, which is part of the JAXP interface. Note that <code>NodeInfo</code> implements the JAXP <code>Source</code> interface, so it may be supplied directly to the transform() method. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>startNode</CODE> - A Node that identifies the source document to be transformed and the node where the transformation should start. May be null if the transformation is to start using an initial template.<DD><CODE>result</CODE> - The output destination <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 any dynamic error occurs <DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/TransformerException.html?is-external=true" title="class or interface in javax.xml.transform">TransformerException</A></CODE></DL> </DD> </DL> <HR> <A NAME="transformStream(javax.xml.transform.Source, net.sf.saxon.trans.Mode, javax.xml.transform.Result)"><!-- --></A><H3> transformStream</H3> <PRE> public void <B>transformStream</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, <A HREF="../../../net/sf/saxon/trans/Mode.html" title="class in net.sf.saxon.trans">Mode</A> mode, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Result.html?is-external=true" title="class or interface in javax.xml.transform">Result</A> result) throws <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/TransformerException.html?is-external=true" title="class or interface in javax.xml.transform">TransformerException</A></PRE> <DL> <DD>Transform a source XML document supplied as a stream, in streaming mode. <br> <p> This method is intended for internal use. External applications should use the <A HREF="../../../net/sf/saxon/Controller.html#transform(javax.xml.transform.Source, javax.xml.transform.Result)"><CODE>transform(javax.xml.transform.Source, javax.xml.transform.Result)</CODE></A> method, which is part of the JAXP interface. Note that <code>NodeInfo</code> implements the JAXP <code>Source</code> interface, so it may be supplied directly to the transform() method. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>source</CODE> - the principal input document, supplied as a <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/sax/SAXSource.html?is-external=true" title="class or interface in javax.xml.transform.sax"><CODE>SAXSource</CODE></A>, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/stream/StreamSource.html?is-external=true" title="class or interface in javax.xml.transform.stream"><CODE>StreamSource</CODE></A>, or <A HREF="../../../net/sf/saxon/event/Transmitter.html" title="class in net.sf.saxon.event"><CODE>Transmitter</CODE></A><DD><CODE>mode</CODE> - the initial mode, which must be a streaming mode<DD><CODE>result</CODE> - The output destination <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 any dynamic error occurs <DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/TransformerException.html?is-external=true" title="class or interface in javax.xml.transform">TransformerException</A></CODE></DL> </DD> </DL> <HR> <A NAME="getStreamingReceiver(net.sf.saxon.trans.Mode, javax.xml.transform.Result)"><!-- --></A><H3> getStreamingReceiver</H3> <PRE> public <A HREF="../../../net/sf/saxon/event/Receiver.html" title="interface in net.sf.saxon.event">Receiver</A> <B>getStreamingReceiver</B>(<A HREF="../../../net/sf/saxon/trans/Mode.html" title="class in net.sf.saxon.trans">Mode</A> mode, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Result.html?is-external=true" title="class or interface in javax.xml.transform">Result</A> result) throws <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/TransformerException.html?is-external=true" title="class or interface in javax.xml.transform">TransformerException</A></PRE> <DL> <DD>Get a receiver to which the input to this transformation can be supplied as a stream of events, causing the transformation to be executed in streaming mode. <br> <p> This method is intended for internal use. External applications should use the <A HREF="../../../net/sf/saxon/Controller.html#transform(javax.xml.transform.Source, javax.xml.transform.Result)"><CODE>transform(javax.xml.transform.Source, javax.xml.transform.Result)</CODE></A> method, which is part of the JAXP interface. Note that <code>NodeInfo</code> implements the JAXP <code>Source</code> interface, so it may be supplied directly to the transform() method. <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/sax/SAXSource.html?is-external=true" title="class or interface in javax.xml.transform.sax"><CODE>SAXSource</CODE></A>, <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/stream/StreamSource.html?is-external=true" title="class or interface in javax.xml.transform.stream"><CODE>StreamSource</CODE></A>, or <A HREF="../../../net/sf/saxon/event/Transmitter.html" title="class in net.sf.saxon.event"><CODE>Transmitter</CODE></A> <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>mode</CODE> - the initial mode, which must be a streaming mode<DD><CODE>result</CODE> - The output destination <DT><B>Returns:</B><DD>a receiver to which events can be streamed <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 any dynamic error occurs <DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/TransformerException.html?is-external=true" title="class or interface in javax.xml.transform">TransformerException</A></CODE></DL> </DD> </DL> <HR> <A NAME="preEvaluateGlobals(net.sf.saxon.expr.XPathContext)"><!-- --></A><H3> preEvaluateGlobals</H3> <PRE> public void <B>preEvaluateGlobals</B>(<A HREF="../../../net/sf/saxon/expr/XPathContext.html" title="interface in net.sf.saxon.expr">XPathContext</A> context) throws <A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></PRE> <DL> <DD>Pre-evaluate global variables (when debugging/tracing). <p> This method is intended for internal use. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>context</CODE> - the dynamic context for evaluating the global variables <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 a dynamic error occurs while evaluating the global variables.</DL> </DD> </DL> <HR> <A NAME="setParameter(java.lang.String, java.lang.Object)"><!-- --></A><H3> setParameter</H3> <PRE> public void <B>setParameter</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> expandedName, <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> value)</PRE> <DL> <DD>Set a parameter for the transformation. <p> The following table shows some of the classes that are supported by this method. (Others may also be supported, but continued support is not guaranteed.) Each entry in the table shows first the Java class of the supplied object, and then the type of the resulting XPath value. <p> <table> <thead> <tr><th>Java Class</th><th>XPath 2.0 type</th></tr> </thead> <tbody> <tr><td>String</td><td>xs:string</td></tr> <tr><td>Boolean</td><td>xs:boolean</td></tr> <tr><td>Integer</td><td>xs:integer</td></tr> <tr><td>Long</td><td>xs:integer</td></tr> <tr><td>Double</td><td>xs:double</td></tr> <tr><td>Float</td><td>xs:float</td></tr> <tr><td>BigDecimal</td><td>xs:decimal</td></tr> <tr><td>BigInteger</td><td>xs:integer</td></tr> <tr><td>Date</td><td>xs:dateTime</td></tr> <tr><td>Array or List of any of the above</td><td>sequence of the above</td></tr> <tr><td>null</td><td>empty sequence</td></tr> </tbody></table> <p> A node may be supplied as a <code>NodeInfo</code> object, a sequence of nodes as an array or List of <code>NodeInfo</code> objects. <p> In addition, any object that implements the Saxon <A HREF="../../../net/sf/saxon/value/Value.html" title="class in net.sf.saxon.value"><CODE>Value</CODE></A> interface may be supplied, and will be used without conversion. <p> A node belong to an external object model (such as DOM, JDOM, or XOM) may be supplied provided (a) that the external object model is registered with the Configuration, and (b) that the node is part of a document tree that has been registered in the document pool. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#setParameter(java.lang.String, java.lang.Object)" title="class or interface in javax.xml.transform">setParameter</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>expandedName</CODE> - The name of the parameter in {uri}local format<DD><CODE>value</CODE> - The value object. This must follow the rules above. Other formats in addition to those listed above may be accepted.<DT><B>Since:</B></DT> <DD>8.4</DD> </DL> </DD> </DL> <HR> <A NAME="setParameter(net.sf.saxon.om.StructuredQName, net.sf.saxon.om.ValueRepresentation)"><!-- --></A><H3> setParameter</H3> <PRE> public void <B>setParameter</B>(<A HREF="../../../net/sf/saxon/om/StructuredQName.html" title="class in net.sf.saxon.om">StructuredQName</A> qName, <A HREF="../../../net/sf/saxon/om/ValueRepresentation.html" title="interface in net.sf.saxon.om">ValueRepresentation</A> value)</PRE> <DL> <DD>Supply a parameter using Saxon-specific representations of the name and value <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>qName</CODE> - The structured representation of the parameter name<DD><CODE>value</CODE> - The value of the parameter, or null to remove a previously set value</DL> </DD> </DL> <HR> <A NAME="clearParameters()"><!-- --></A><H3> clearParameters</H3> <PRE> public void <B>clearParameters</B>()</PRE> <DL> <DD>Reset the parameters to a null list. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#clearParameters()" title="class or interface in javax.xml.transform">clearParameters</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="getParameter(java.lang.String)"><!-- --></A><H3> getParameter</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>getParameter</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> expandedName)</PRE> <DL> <DD>Get a parameter to the transformation. This returns the value of a parameter that has been previously set using the <A HREF="../../../net/sf/saxon/Controller.html#setParameter(java.lang.String, java.lang.Object)"><CODE>setParameter(java.lang.String, java.lang.Object)</CODE></A> method. The value is returned exactly as supplied, that is, before any conversion to an XPath value. <P> <DD><DL> <DT><B>Specified by:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true#getParameter(java.lang.String)" title="class or interface in javax.xml.transform">getParameter</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Transformer.html?is-external=true" title="class or interface in javax.xml.transform">Transformer</A></CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>expandedName</CODE> - the name of the required parameter, in "{uri}local-name" format <DT><B>Returns:</B><DD>the value of the parameter, if it exists, or null otherwise</DL> </DD> </DL> <HR> <A NAME="iterateParameters()"><!-- --></A><H3> iterateParameters</H3> <PRE> public <A HREF="http://download.oracle.com/javase/6/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</A> <B>iterateParameters</B>()</PRE> <DL> <DD>Get an iterator over the names of global parameters that have been defined <P> <DD><DL> <DT><B>Returns:</B><DD>an Iterator whose items are strings in the form of Clark names, that is {uri}local</DL> </DD> </DL> <HR> <A NAME="setCurrentDateTime(net.sf.saxon.value.DateTimeValue)"><!-- --></A><H3> setCurrentDateTime</H3> <PRE> public void <B>setCurrentDateTime</B>(<A HREF="../../../net/sf/saxon/value/DateTimeValue.html" title="class in net.sf.saxon.value">DateTimeValue</A> dateTime) throws <A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></PRE> <DL> <DD>Set the current date and time for this query or transformation. This method is provided primarily for testing purposes, to allow tests to be run with a fixed date and time. The supplied date/time must include a timezone, which is used as the implicit timezone. <p>Note that comparisons of date/time values currently use the implicit timezone taken from the system clock, not from the value supplied here.</p> <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>dateTime</CODE> - the date/time value to be used as the current date and time <DT><B>Throws:</B> <DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</A></CODE> - if a current date/time has already been established by calling getCurrentDateTime(), or by a previous call on setCurrentDateTime() <DD><CODE><A HREF="../../../net/sf/saxon/trans/XPathException.html" title="class in net.sf.saxon.trans">XPathException</A></CODE> - if the supplied dateTime contains no timezone</DL> </DD> </DL> <HR> <A NAME="getCurrentDateTime()"><!-- --></A><H3> getCurrentDateTime</H3> <PRE> public <A HREF="../../../net/sf/saxon/value/DateTimeValue.html" title="class in net.sf.saxon.value">DateTimeValue</A> <B>getCurrentDateTime</B>()</PRE> <DL> <DD>Get the current date and time for this query or transformation. All calls during one transformation return the same answer. <P> <DD><DL> <DT><B>Returns:</B><DD>Get the current date and time. This will deliver the same value for repeated calls within the same transformation</DL> </DD> </DL> <HR> <A NAME="getImplicitTimezone()"><!-- --></A><H3> getImplicitTimezone</H3> <PRE> public int <B>getImplicitTimezone</B>()</PRE> <DL> <DD>Get the implicit timezone for this query or transformation <P> <DD><DL> <DT><B>Returns:</B><DD>the implicit timezone as an offset in minutes</DL> </DD> </DL> <HR> <A NAME="newXPathContext()"><!-- --></A><H3> newXPathContext</H3> <PRE> public <A HREF="../../../net/sf/saxon/expr/XPathContextMajor.html" title="class in net.sf.saxon.expr">XPathContextMajor</A> <B>newXPathContext</B>()</PRE> <DL> <DD>Make an XPathContext object for expression evaluation. <p> This method is intended for internal use. <P> <DD><DL> <DT><B>Returns:</B><DD>the new XPathContext</DL> </DD> </DL> <HR> <A NAME="setRememberedNumber(net.sf.saxon.om.NodeInfo, int)"><!-- --></A><H3> setRememberedNumber</H3> <PRE> public void <B>setRememberedNumber</B>(<A HREF="../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A> node, int number)</PRE> <DL> <DD>Set the last remembered node, for node numbering purposes. <p> This method is strictly for internal use only. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>node</CODE> - the node in question<DD><CODE>number</CODE> - the number of this node</DL> </DD> </DL> <HR> <A NAME="getRememberedNumber(net.sf.saxon.om.NodeInfo)"><!-- --></A><H3> getRememberedNumber</H3> <PRE> public int <B>getRememberedNumber</B>(<A HREF="../../../net/sf/saxon/om/NodeInfo.html" title="interface in net.sf.saxon.om">NodeInfo</A> node)</PRE> <DL> <DD>Get the number of a node if it is the last remembered one. <p> This method is strictly for internal use only. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>node</CODE> - the node for which remembered information is required <DT><B>Returns:</B><DD>the number of this node if known, else -1.</DL> </DD> </DL> <HR> <A NAME="setUseDocumentProjection(net.sf.saxon.expr.parser.PathMap)"><!-- --></A><H3> setUseDocumentProjection</H3> <PRE> public void <B>setUseDocumentProjection</B>(<A HREF="../../../net/sf/saxon/expr/parser/PathMap.html" title="class in net.sf.saxon.expr.parser">PathMap</A> pathMap)</PRE> <DL> <DD>Indicate whether document projection should be used, and supply the PathMap used to control it. Note: this is available only under Saxon-EE. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>pathMap</CODE> - a path map to be used for projecting source documents</DL> </DD> </DL> <HR> <A NAME="getPathMapForDocumentProjection()"><!-- --></A><H3> getPathMapForDocumentProjection</H3> <PRE> public <A HREF="../../../net/sf/saxon/expr/parser/PathMap.html" title="class in net.sf.saxon.expr.parser">PathMap</A> <B>getPathMapForDocumentProjection</B>()</PRE> <DL> <DD>Get the path map used for document projection, if any. <P> <DD><DL> <DT><B>Returns:</B><DD>the path map to be used for document projection, if one has been supplied; otherwise null</DL> </DD> </DL> <HR> <A NAME="setClassLoader(java.lang.ClassLoader)"><!-- --></A><H3> setClassLoader</H3> <PRE> public void <B>setClassLoader</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/ClassLoader.html?is-external=true" title="class or interface in java.lang">ClassLoader</A> loader)</PRE> <DL> <DD>Set a ClassLoader to be used when loading external classes. Examples of classes that are loaded include SAX parsers, localization modules for formatting numbers and dates, extension functions, external object models. In an environment such as Eclipse that uses its own ClassLoader, this ClassLoader should be nominated to ensure that any class loaded by Saxon is identical to a class of the same name loaded by the external environment. <p> This method is for application use, but is experimental and subject to change. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>loader</CODE> - the ClassLoader to be used.</DL> </DD> </DL> <HR> <A NAME="getClassLoader()"><!-- --></A><H3> getClassLoader</H3> <PRE> public <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/ClassLoader.html?is-external=true" title="class or interface in java.lang">ClassLoader</A> <B>getClassLoader</B>()</PRE> <DL> <DD>Get the ClassLoader supplied using the method <A HREF="../../../net/sf/saxon/Controller.html#setClassLoader(java.lang.ClassLoader)"><CODE>setClassLoader(java.lang.ClassLoader)</CODE></A>. If none has been supplied, return null. <p> This method is for application use, but is experimental and subject to change. <P> <DD><DL> <DT><B>Returns:</B><DD>the ClassLoader in use.</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/Configuration.LicenseFeature.html" title="class in net.sf.saxon"><B>PREV CLASS</B></A> <A HREF="../../../net/sf/saxon/Filter.html" title="class in net.sf.saxon"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html?net/sf/saxon/Controller.html" target="_top"><B>FRAMES</B></A> <A HREF="Controller.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>