<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.6.0_18) on Fri Dec 09 20:48:45 GMT 2011 -->
<TITLE>
SaxonXQDataSource
</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="SaxonXQDataSource";
}
}
</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/xqj/SaxonXQDataFactory.html" title="class in net.sf.saxon.xqj"><B>PREV CLASS</B></A>
<A HREF="../../../../net/sf/saxon/xqj/SaxonXQDynamicContext.html" title="class in net.sf.saxon.xqj"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?net/sf/saxon/xqj/SaxonXQDataSource.html" target="_top"><B>FRAMES</B></A>
<A HREF="SaxonXQDataSource.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.xqj</FONT>
<BR>
Class SaxonXQDataSource</H2>
<PRE>
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</A>
<IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>net.sf.saxon.xqj.SaxonXQDataSource</B>
</PRE>
<DL>
<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></DD>
</DL>
<HR>
<DL>
<DT><PRE>public class <B>SaxonXQDataSource</B><DT>extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A><DT>implements <A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></DL>
</PRE>
<P>
Saxon implementation of the XQJ XQDataSource interface. The first action of a client application
is to instantiate a SaxonXQDataSource. This is done directly: there is no factory class as with JAXP.
An application that does not want compile-time references to the Saxon XQJ implementation can instantiate
this class dynamically using the reflection API (class.newInstance()).
<p>
For full Javadoc descriptions of the public methods, see the XQJ specification.
<P>
<P>
<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/xqj/SaxonXQDataSource.html#SaxonXQDataSource()">SaxonXQDataSource</A></B>()</CODE>
<BR>
Create a SaxonXQDataSource using a default configuration.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xqj/SaxonXQDataSource.html#SaxonXQDataSource(net.sf.saxon.Configuration)">SaxonXQDataSource</A></B>(<A HREF="../../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A> config)</CODE>
<BR>
Create a Saxon XQDataSource with a specific configuration</TD>
</TR>
</TABLE>
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Method Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="http://download.oracle.com/javase/6/docs/api/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/xqj/SaxonXQDataSource.html#getAllowExternalFunctions()">getAllowExternalFunctions</A></B>()</CODE>
<BR>
Ask whether queries are allowed to call external functions.</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/xqj/SaxonXQDataSource.html#getConfiguration()">getConfiguration</A></B>()</CODE>
<BR>
Get the Saxon Configuration in use.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../javax/xml/xquery/XQConnection.html" title="interface in javax.xml.xquery">XQConnection</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xqj/SaxonXQDataSource.html#getConnection()">getConnection</A></B>()</CODE>
<BR>
Attempts to create a connection to an XML datasource.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../javax/xml/xquery/XQConnection.html" title="interface in javax.xml.xquery">XQConnection</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xqj/SaxonXQDataSource.html#getConnection(java.sql.Connection)">getConnection</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/sql/Connection.html?is-external=true" title="class or interface in java.sql">Connection</A> con)</CODE>
<BR>
Get a connection based on an underlying JDBC connection</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> <A HREF="../../../../javax/xml/xquery/XQConnection.html" title="interface in javax.xml.xquery">XQConnection</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xqj/SaxonXQDataSource.html#getConnection(java.lang.String, java.lang.String)">getConnection</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> username,
<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> password)</CODE>
<BR>
Get a connection, by supplying a username and password.</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/xqj/SaxonXQDataSource.html#getDtdValidation()">getDtdValidation</A></B>()</CODE>
<BR>
Ask whether source documents are to be parsed with DTD validation enabled</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/xqj/SaxonXQDataSource.html#getExpandAttributeDefaults()">getExpandAttributeDefaults</A></B>()</CODE>
<BR>
Ask whether fixed or default values defined in a schema or DTD will be expanded</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/xqj/SaxonXQDataSource.html#getExpandXInclude()">getExpandXInclude</A></B>()</CODE>
<BR>
Ask whether XInclude processing is to be applied to source 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/xqj/SaxonXQDataSource.html#getLoginTimeout()">getLoginTimeout</A></B>()</CODE>
<BR>
Gets the maximum time in seconds that this datasource can wait while
attempting to connect to a database.</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/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xqj/SaxonXQDataSource.html#getLogWriter()">getLogWriter</A></B>()</CODE>
<BR>
Retrieves the log writer for this <code>XQDataSource</code> object.</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/xqj/SaxonXQDataSource.html#getProperty(java.lang.String)">getProperty</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 a configuration property setting.</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/xqj/SaxonXQDataSource.html#getRetainLineNumbers()">getRetainLineNumbers</A></B>()</CODE>
<BR>
Ask whether line and column information will be retained for source documents</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/xqj/SaxonXQDataSource.html#getSchemaValidationMode()">getSchemaValidationMode</A></B>()</CODE>
<BR>
Ask whether source documents will be validated against a schema</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/xqj/SaxonXQDataSource.html#getStripWhitespace()">getStripWhitespace</A></B>()</CODE>
<BR>
Ask whether whitespace will be stripped when loading source documents</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/xqj/SaxonXQDataSource.html#getSupportedPropertyNames()">getSupportedPropertyNames</A></B>()</CODE>
<BR>
Returns an array containing the property names supported by this
<code>XQDataSource</code>.</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/xqj/SaxonXQDataSource.html#getUseXsiSchemaLocation()">getUseXsiSchemaLocation</A></B>()</CODE>
<BR>
Ask whether the schema processor is to take account of xsi:schemaLocation and
xsi:noNamespaceSchemaLocation attributes encountered in an instance document being validated</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/xqj/SaxonXQDataSource.html#getXmlVersion()">getXmlVersion</A></B>()</CODE>
<BR>
Ask whether XML 1.0 or XML 1.1 rules for XML names are to be followed</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/xqj/SaxonXQDataSource.html#getXsdVersion()">getXsdVersion</A></B>()</CODE>
<BR>
Ask whether XML Schema 1.0 syntax must be used or whether XML Schema 1.1 features are allowed</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/xqj/SaxonXQDataSource.html#registerExtensionFunction(net.sf.saxon.lib.ExtensionFunctionDefinition)">registerExtensionFunction</A></B>(<A HREF="../../../../net/sf/saxon/lib/ExtensionFunctionDefinition.html" title="class in net.sf.saxon.lib">ExtensionFunctionDefinition</A> function)</CODE>
<BR>
Register an extension function that is to be made available within any query.</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/xqj/SaxonXQDataSource.html#setAllowExternalFunctions(java.lang.String)">setAllowExternalFunctions</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> value)</CODE>
<BR>
Say whether queries are allowed to call external functions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xqj/SaxonXQDataSource.html#setDtdValidation(java.lang.String)">setDtdValidation</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> value)</CODE>
<BR>
Say whether source documents are to be parsed with DTD validation enabled</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/xqj/SaxonXQDataSource.html#setExpandAttributeDefaults(java.lang.String)">setExpandAttributeDefaults</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> value)</CODE>
<BR>
Say whether whether fixed and default values defined
in a schema or DTD will be expanded.</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/xqj/SaxonXQDataSource.html#setExpandXInclude(java.lang.String)">setExpandXInclude</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> value)</CODE>
<BR>
Say whether XInclude processing is to be applied to source 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/xqj/SaxonXQDataSource.html#setLoginTimeout(int)">setLoginTimeout</A></B>(int seconds)</CODE>
<BR>
Sets the maximum time in seconds that this datasource will wait while
attempting to connect to a database.</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/xqj/SaxonXQDataSource.html#setLogWriter(java.io.PrintWriter)">setLogWriter</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</A> out)</CODE>
<BR>
Sets the log writer for this <code>XQDataSource</code> object to the given
<code>java.io.PrintWriter</code> object.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../net/sf/saxon/xqj/SaxonXQDataSource.html#setProperties(java.util.Properties)">setProperties</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> props)</CODE>
<BR>
Sets the data source properties from the specified <code>Properties</code>
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/xqj/SaxonXQDataSource.html#setProperty(java.lang.String, java.lang.String)">setProperty</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 a configuration property.</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/xqj/SaxonXQDataSource.html#setRetainLineNumbers(java.lang.String)">setRetainLineNumbers</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> value)</CODE>
<BR>
Say whether source documents should have line and column information retained.</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/xqj/SaxonXQDataSource.html#setSchemaValidationMode(java.lang.String)">setSchemaValidationMode</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> value)</CODE>
<BR>
Say whether source documents should be validated against a schema</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/xqj/SaxonXQDataSource.html#setStripWhitespace(java.lang.String)">setStripWhitespace</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> value)</CODE>
<BR>
Say whether whitespace should be stripped when loading source 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/xqj/SaxonXQDataSource.html#setUseXsiSchemaLocation(java.lang.String)">setUseXsiSchemaLocation</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> value)</CODE>
<BR>
Say whether the schema processor is to take account of xsi:schemaLocation and
xsi:noNamespaceSchemaLocation attributes encountered in an instance document being validated</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/xqj/SaxonXQDataSource.html#setXmlVersion(java.lang.String)">setXmlVersion</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> value)</CODE>
<BR>
Say whether XML 1.0 or XML 1.1 rules for XML names are to be followed</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/xqj/SaxonXQDataSource.html#setXsdVersion(java.lang.String)">setXsdVersion</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> value)</CODE>
<BR>
Say whether XML Schema 1.0 syntax must be used or whether XML Schema 1.1 features are allowed</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="SaxonXQDataSource()"><!-- --></A><H3>
SaxonXQDataSource</H3>
<PRE>
public <B>SaxonXQDataSource</B>()</PRE>
<DL>
<DD>Create a SaxonXQDataSource using a default configuration.
The Configuration will be an EE, PE, or HE configuration depending on the
edition.properties file contained in the JAR build
<P>
</DL>
<HR>
<A NAME="SaxonXQDataSource(net.sf.saxon.Configuration)"><!-- --></A><H3>
SaxonXQDataSource</H3>
<PRE>
public <B>SaxonXQDataSource</B>(<A HREF="../../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A> config)</PRE>
<DL>
<DD>Create a Saxon XQDataSource with a specific configuration
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>config</CODE> - The Saxon configuration to be used</DL>
</DL>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="getConfiguration()"><!-- --></A><H3>
getConfiguration</H3>
<PRE>
public <A HREF="../../../../net/sf/saxon/Configuration.html" title="class in net.sf.saxon">Configuration</A> <B>getConfiguration</B>()</PRE>
<DL>
<DD>Get the Saxon Configuration in use. Changes made to this Configuration will affect this
data source and XQJ connections created from it (either before or afterwards). Equally,
changes made to this SaxonXQDataSource are reflected in the Configuration object (which means
they also impact any other SaxonXQDataSource objects that share the same Configuration).
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the configuration in use.</DL>
</DD>
</DL>
<HR>
<A NAME="getConnection()"><!-- --></A><H3>
getConnection</H3>
<PRE>
public <A HREF="../../../../javax/xml/xquery/XQConnection.html" title="interface in javax.xml.xquery">XQConnection</A> <B>getConnection</B>()
throws <A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getConnection()">XQDataSource</A></CODE></B></DD>
<DD>Attempts to create a connection to an XML datasource.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getConnection()">getConnection</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>a connection to the XML datasource
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if a datasource access error occurs</DL>
</DD>
</DL>
<HR>
<A NAME="getConnection(java.sql.Connection)"><!-- --></A><H3>
getConnection</H3>
<PRE>
public <A HREF="../../../../javax/xml/xquery/XQConnection.html" title="interface in javax.xml.xquery">XQConnection</A> <B>getConnection</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/sql/Connection.html?is-external=true" title="class or interface in java.sql">Connection</A> con)
throws <A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Get a connection based on an underlying JDBC connection
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getConnection(java.sql.Connection)">getConnection</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>con</CODE> - the JDBC connection
<DT><B>Returns:</B><DD>a connection based on an underlying JDBC connection
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - The Saxon implementation of this method always throws
an XQException, indicating that Saxon does not support connection to a JDBC data source.</DL>
</DD>
</DL>
<HR>
<A NAME="getConnection(java.lang.String, java.lang.String)"><!-- --></A><H3>
getConnection</H3>
<PRE>
public <A HREF="../../../../javax/xml/xquery/XQConnection.html" title="interface in javax.xml.xquery">XQConnection</A> <B>getConnection</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> username,
<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> password)
throws <A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Get a connection, by supplying a username and password. The Saxon implementation of this is equivalent
to the default constructor: the username and password are ignored.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getConnection(java.lang.String, java.lang.String)">getConnection</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>username</CODE> - the user name<DD><CODE>password</CODE> - the password
<DT><B>Returns:</B><DD>a connection
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getLoginTimeout()"><!-- --></A><H3>
getLoginTimeout</H3>
<PRE>
public int <B>getLoginTimeout</B>()</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getLoginTimeout()">XQDataSource</A></CODE></B></DD>
<DD>Gets the maximum time in seconds that this datasource can wait while
attempting to connect to a database.
A value of zero means that the timeout is the default system timeout
if there is one; otherwise, it means that there is no timeout.
When a XQDataSource object is created, the login timeout is
initially zero.
It is implementation-defined whether the returned login timeout is
actually used by the data source implementation.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getLoginTimeout()">getLoginTimeout</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the datasource login time limit</DL>
</DD>
</DL>
<HR>
<A NAME="getLogWriter()"><!-- --></A><H3>
getLogWriter</H3>
<PRE>
public <A HREF="http://download.oracle.com/javase/6/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</A> <B>getLogWriter</B>()</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getLogWriter()">XQDataSource</A></CODE></B></DD>
<DD>Retrieves the log writer for this <code>XQDataSource</code> object.
The log writer is a character output stream to which all logging and
tracing messages for this datasource will be printed. This includes
messages printed by the methods of this object, messages printed by
methods of other objects manufactured by this object, and so on.
When a <code>XQDataSource</code> object is created, the log writer is
initially <code>null</code>; in other words, the default is for logging
to be disabled.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getLogWriter()">getLogWriter</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>the log writer for this datasource or
<code>null</code> if logging is disabled</DL>
</DD>
</DL>
<HR>
<A NAME="getProperty(java.lang.String)"><!-- --></A><H3>
getProperty</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>getProperty</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)
throws <A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Get a configuration property setting. The properties that are supported, and their meanings, are the
same as the properties that can be obtained using "get" methods; for example
<code>getProperty("dtdValidation")</code> returns the same result as <code>getDtdValidation()</code>.
<p>Further Saxon configuration properties are available using the URIs defined as constants in
<A HREF="../../../../net/sf/saxon/lib/FeatureKeys.html" title="class in net.sf.saxon.lib"><CODE>FeatureKeys</CODE></A></p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getProperty(java.lang.String)">getProperty</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the configuration property
<DT><B>Returns:</B><DD>the value of the configuration property. Note that in the case of on/off properties this
will be returned as the string true/false
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="getSupportedPropertyNames()"><!-- --></A><H3>
getSupportedPropertyNames</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>getSupportedPropertyNames</B>()</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getSupportedPropertyNames()">XQDataSource</A></CODE></B></DD>
<DD>Returns an array containing the property names supported by this
<code>XQDataSource</code>.
Implementations that support user name and password must recognize
the user name and password properties listed below.
<br>
<br>
<table>
<tr><td><code>user</code></td>
<td>the user name to use for creating a connection</td></tr>
<tr><td><code>password</code></td>
<td>the password to use for creating a connection</td></tr>
</table>
<br>
Any additional properties are implementation-defined.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#getSupportedPropertyNames()">getSupportedPropertyNames</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD><code>String[]</code> an array of property names
supported by this implementation</DL>
</DD>
</DL>
<HR>
<A NAME="setLoginTimeout(int)"><!-- --></A><H3>
setLoginTimeout</H3>
<PRE>
public void <B>setLoginTimeout</B>(int seconds)
throws <A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#setLoginTimeout(int)">XQDataSource</A></CODE></B></DD>
<DD>Sets the maximum time in seconds that this datasource will wait while
attempting to connect to a database. A value of zero specifies that
the timeout is the default system timeout if there is one; otherwise,
it specifies that there is no timeout. When a <code>XQDataSource</code>
object is created, the login timeout is initially zero.
It is implementation-defined whether the specified login timeout is
actually used by the data source implementation. If the connection is
created over an existing JDBC connection, then the login timeout
value from the underlying JDBC connection may be used.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#setLoginTimeout(int)">setLoginTimeout</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>seconds</CODE> - the datasource login time limit
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if a datasource access error occurs</DL>
</DD>
</DL>
<HR>
<A NAME="setLogWriter(java.io.PrintWriter)"><!-- --></A><H3>
setLogWriter</H3>
<PRE>
public void <B>setLogWriter</B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</A> out)
throws <A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#setLogWriter(java.io.PrintWriter)">XQDataSource</A></CODE></B></DD>
<DD>Sets the log writer for this <code>XQDataSource</code> object to the given
<code>java.io.PrintWriter</code> object. The log writer is a character output
stream to which all logging and tracing messages for this datasource
will be printed. This includes messages printed by the methods of this
object, messages printed by methods of other objects manufactured by
this object, and so on. When a <code>XQDataSource</code> object is created
the log writer is initially <code>null</code>; in other words, the default
is for logging to be disabled.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#setLogWriter(java.io.PrintWriter)">setLogWriter</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>out</CODE> - the new log writer; to disable logging, set to
<code>null</code>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if a datasource access error occurs</DL>
</DD>
</DL>
<HR>
<A NAME="setProperties(java.util.Properties)"><!-- --></A><H3>
setProperties</H3>
<PRE>
public void <B>setProperties</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> props)
throws <A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#setProperties(java.util.Properties)">XQDataSource</A></CODE></B></DD>
<DD>Sets the data source properties from the specified <code>Properties</code>
instance. Properties set before this call will still apply but
those with the same name as any of these properties will be replaced.
Properties set after this call also apply and may
replace properties set during this call.<p>
If the implementation does not support one or more of the given
property names, or if it can determine that the value given for a
specific property is invalid, then an exception is thrown. If an
exception is thrown, then no previous value is overwritten.
is invalid, then an exception is raised.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#setProperties(java.util.Properties)">setProperties</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>props</CODE> - the list of properties to set
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE> - if (1) a given property is not recognized,
(2) the value for a given property is
determined to be invalid, or (3) the
<code>props</code> parameter is <code>null</code></DL>
</DD>
</DL>
<HR>
<A NAME="setProperty(java.lang.String, java.lang.String)"><!-- --></A><H3>
setProperty</H3>
<PRE>
public void <B>setProperty</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)
throws <A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></PRE>
<DL>
<DD>Set a configuration property. The properties that are supported, and their meanings, are the
same as the properties that can be obtained using "set" methods; for example
<code>setProperty("dtdValidation", "true")</code> has the same effect as
<code>setDtdValidation("true")</code>.
<p>Further Saxon configuration properties are available using the URIs defined as constants in
<A HREF="../../../../net/sf/saxon/lib/FeatureKeys.html" title="class in net.sf.saxon.lib"><CODE>FeatureKeys</CODE></A></p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html#setProperty(java.lang.String, java.lang.String)">setProperty</A></CODE> in interface <CODE><A HREF="../../../../javax/xml/xquery/XQDataSource.html" title="interface in javax.xml.xquery">XQDataSource</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the configuration property<DD><CODE>value</CODE> - the value of the configuration property
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../javax/xml/xquery/XQException.html" title="class in javax.xml.xquery">XQException</A></CODE></DL>
</DD>
</DL>
<HR>
<A NAME="setAllowExternalFunctions(java.lang.String)"><!-- --></A><H3>
setAllowExternalFunctions</H3>
<PRE>
public void <B>setAllowExternalFunctions</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> value)</PRE>
<DL>
<DD>Say whether queries are allowed to call external functions.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - set to "true" if external function calls are allowed (default) or "false" otherwise</DL>
</DD>
</DL>
<HR>
<A NAME="getAllowExternalFunctions()"><!-- --></A><H3>
getAllowExternalFunctions</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>getAllowExternalFunctions</B>()</PRE>
<DL>
<DD>Ask whether queries are allowed to call external functions.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>"true" if external function calls are allowed, "false" otherwise</DL>
</DD>
</DL>
<HR>
<A NAME="setDtdValidation(java.lang.String)"><!-- --></A><H3>
setDtdValidation</H3>
<PRE>
public void <B>setDtdValidation</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> value)</PRE>
<DL>
<DD>Say whether source documents are to be parsed with DTD validation enabled
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - "true" if DTD validation is to be enabled, otherwise "false". Default is "false".</DL>
</DD>
</DL>
<HR>
<A NAME="getDtdValidation()"><!-- --></A><H3>
getDtdValidation</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>getDtdValidation</B>()</PRE>
<DL>
<DD>Ask whether source documents are to be parsed with DTD validation enabled
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>"true" if DTD validation is to be enabled, otherwise "false". Default is "false".</DL>
</DD>
</DL>
<HR>
<A NAME="setExpandAttributeDefaults(java.lang.String)"><!-- --></A><H3>
setExpandAttributeDefaults</H3>
<PRE>
public void <B>setExpandAttributeDefaults</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> value)</PRE>
<DL>
<DD>Say whether whether fixed and default values defined
in a schema or DTD will be expanded. By default, or if the value is "true" (and for conformance with the
specification) validation against a DTD or schema will cause default values defined in the schema
or DTD to be inserted into the document. Setting this feature to "false" suppresses this behaviour. In
the case of DTD-defined defaults this only works if the XML parser reports whether each attribute was
specified in the source or generated by expanding a default value. Not all XML parsers report this
information.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - "true" if default values are to be expanded, otherwise "false". Default is "true".</DL>
</DD>
</DL>
<HR>
<A NAME="getExpandAttributeDefaults()"><!-- --></A><H3>
getExpandAttributeDefaults</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>getExpandAttributeDefaults</B>()</PRE>
<DL>
<DD>Ask whether fixed or default values defined in a schema or DTD will be expanded
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>"true" if such values will be expanded, otherwise "false"</DL>
</DD>
</DL>
<HR>
<A NAME="setExpandXInclude(java.lang.String)"><!-- --></A><H3>
setExpandXInclude</H3>
<PRE>
public void <B>setExpandXInclude</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> value)</PRE>
<DL>
<DD>Say whether XInclude processing is to be applied to source documents
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - "true" if XInclude directives are to expanded, otherwise "false". Default is "false".</DL>
</DD>
</DL>
<HR>
<A NAME="getExpandXInclude()"><!-- --></A><H3>
getExpandXInclude</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>getExpandXInclude</B>()</PRE>
<DL>
<DD>Ask whether XInclude processing is to be applied to source documents
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>"true" if XInclude directives are to expanded, otherwise "false". Default is "false".</DL>
</DD>
</DL>
<HR>
<A NAME="setRetainLineNumbers(java.lang.String)"><!-- --></A><H3>
setRetainLineNumbers</H3>
<PRE>
public void <B>setRetainLineNumbers</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> value)</PRE>
<DL>
<DD>Say whether source documents should have line and column information retained. This
information is available via extension functions <code>saxon:line-number()</code> and
<code>saxon:column-number()</code>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - "true" if line and column information is to be retained, otherwise "false". Default is "false".</DL>
</DD>
</DL>
<HR>
<A NAME="getRetainLineNumbers()"><!-- --></A><H3>
getRetainLineNumbers</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>getRetainLineNumbers</B>()</PRE>
<DL>
<DD>Ask whether line and column information will be retained for source documents
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>"true" if line and column information is retained, otherwise "false"</DL>
</DD>
</DL>
<HR>
<A NAME="setSchemaValidationMode(java.lang.String)"><!-- --></A><H3>
setSchemaValidationMode</H3>
<PRE>
public void <B>setSchemaValidationMode</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> value)</PRE>
<DL>
<DD>Say whether source documents should be validated against a schema
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - set to "strict" if source documents are to be subjected to strict validation,
"lax" if source documents are to be subjected to lax validation, "skip" if source documents
are not to be subjected to schema validation</DL>
</DD>
</DL>
<HR>
<A NAME="getSchemaValidationMode()"><!-- --></A><H3>
getSchemaValidationMode</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>getSchemaValidationMode</B>()</PRE>
<DL>
<DD>Ask whether source documents will be validated against a schema
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>"strict" if source documents are to be subjected to strict validation,
"lax" if source documents are to be subjected to lax validation, "skip" if source documents
are not to be subjected to schema validation</DL>
</DD>
</DL>
<HR>
<A NAME="setStripWhitespace(java.lang.String)"><!-- --></A><H3>
setStripWhitespace</H3>
<PRE>
public void <B>setStripWhitespace</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> value)</PRE>
<DL>
<DD>Say whether whitespace should be stripped when loading source documents
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - "all" if all whitespace text nodes are to be stripped, "ignorable" if
only whitespace text nodes in elements defined in a schema or DTD as having element-only
content are to be stripped, "none" if no whitespace text nodes are to be stripped</DL>
</DD>
</DL>
<HR>
<A NAME="getStripWhitespace()"><!-- --></A><H3>
getStripWhitespace</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>getStripWhitespace</B>()</PRE>
<DL>
<DD>Ask whether whitespace will be stripped when loading source documents
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>"all" if all whitespace text nodes are to be stripped, "ignorable" if
only whitespace text nodes in elements defined in a schema or DTD as having element-only
content are to be stripped, "none" if no whitespace text nodes are to be stripped</DL>
</DD>
</DL>
<HR>
<A NAME="setUseXsiSchemaLocation(java.lang.String)"><!-- --></A><H3>
setUseXsiSchemaLocation</H3>
<PRE>
public void <B>setUseXsiSchemaLocation</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> value)</PRE>
<DL>
<DD>Say whether the schema processor is to take account of xsi:schemaLocation and
xsi:noNamespaceSchemaLocation attributes encountered in an instance document being validated
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - set to "true" if these attributes are to be recognized (default) or "false" otherwise</DL>
</DD>
</DL>
<HR>
<A NAME="getUseXsiSchemaLocation()"><!-- --></A><H3>
getUseXsiSchemaLocation</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>getUseXsiSchemaLocation</B>()</PRE>
<DL>
<DD>Ask whether the schema processor is to take account of xsi:schemaLocation and
xsi:noNamespaceSchemaLocation attributes encountered in an instance document being validated
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>"true" if these attributes are to be recognized (default) or "false" otherwise</DL>
</DD>
</DL>
<HR>
<A NAME="setXmlVersion(java.lang.String)"><!-- --></A><H3>
setXmlVersion</H3>
<PRE>
public void <B>setXmlVersion</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> value)</PRE>
<DL>
<DD>Say whether XML 1.0 or XML 1.1 rules for XML names are to be followed
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - "1.0" (default) if XML 1.0 rules are to be used, "1.1" if XML 1.1
rules apply</DL>
</DD>
</DL>
<HR>
<A NAME="getXmlVersion()"><!-- --></A><H3>
getXmlVersion</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>getXmlVersion</B>()</PRE>
<DL>
<DD>Ask whether XML 1.0 or XML 1.1 rules for XML names are to be followed
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>"1.0" if XML 1.0 rules are to be used, "1.1" if XML 1.1
rules apply</DL>
</DD>
</DL>
<HR>
<A NAME="setXsdVersion(java.lang.String)"><!-- --></A><H3>
setXsdVersion</H3>
<PRE>
public void <B>setXsdVersion</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> value)</PRE>
<DL>
<DD>Say whether XML Schema 1.0 syntax must be used or whether XML Schema 1.1 features are allowed
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>value</CODE> - "1.0" (default) if XML Schema 1.0 rules are to be followed, "1.1" if XML Schema 1.1
features may be used</DL>
</DD>
</DL>
<HR>
<A NAME="getXsdVersion()"><!-- --></A><H3>
getXsdVersion</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>getXsdVersion</B>()</PRE>
<DL>
<DD>Ask whether XML Schema 1.0 syntax must be used or whether XML Schema 1.1 features are allowed
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>"1.0" (default) if XML Schema 1.0 rules are to be followed, "1.1" if XML Schema 1.1
features may be used</DL>
</DD>
</DL>
<HR>
<A NAME="registerExtensionFunction(net.sf.saxon.lib.ExtensionFunctionDefinition)"><!-- --></A><H3>
registerExtensionFunction</H3>
<PRE>
public void <B>registerExtensionFunction</B>(<A HREF="../../../../net/sf/saxon/lib/ExtensionFunctionDefinition.html" title="class in net.sf.saxon.lib">ExtensionFunctionDefinition</A> function)</PRE>
<DL>
<DD>Register an extension function that is to be made available within any query. This method
allows deep integration of an extension function implemented as an instance of
<A HREF="../../../../net/sf/saxon/lib/ExtensionFunctionDefinition.html" title="class in net.sf.saxon.lib"><CODE>ExtensionFunctionDefinition</CODE></A>, using an arbitrary name and namespace.
This supplements the ability to call arbitrary Java methods using a namespace and local name
that are related to the Java class and method name.
<p><i>This method is a Saxon extension to the XQJ interface</i></p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>function</CODE> - the class that implements the extension function. This must be a class that extends
<A HREF="../../../../net/sf/saxon/lib/ExtensionFunctionCall.html" title="class in net.sf.saxon.lib"><CODE>ExtensionFunctionCall</CODE></A>, and it must have a public zero-argument
constructor
<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 class cannot be instantiated or does not extend
<A HREF="../../../../net/sf/saxon/lib/ExtensionFunctionCall.html" title="class in net.sf.saxon.lib"><CODE>ExtensionFunctionCall</CODE></A><DT><B>Since:</B></DT>
<DD>9.2</DD>
</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/xqj/SaxonXQDataFactory.html" title="class in net.sf.saxon.xqj"><B>PREV CLASS</B></A>
<A HREF="../../../../net/sf/saxon/xqj/SaxonXQDynamicContext.html" title="class in net.sf.saxon.xqj"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../../index.html?net/sf/saxon/xqj/SaxonXQDataSource.html" target="_top"><B>FRAMES</B></A>
<A HREF="SaxonXQDataSource.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>
