<!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:55 GMT 2011 --> <TITLE> Deprecated List </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="Deprecated List"; } } </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"> <FONT CLASS="NavBarFont1">Package</FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="overview-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Deprecated</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR> </TABLE> </TD> <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> </EM> </TD> </TR> <TR> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> PREV NEXT</FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="index.html?deprecated-list.html" target="_top"><B>FRAMES</B></A> <A HREF="deprecated-list.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> </TABLE> <A NAME="skip-navbar_top"></A> <!-- ========= END OF TOP NAVBAR ========= --> <HR> <CENTER> <H2> <B>Deprecated API</B></H2> </CENTER> <HR SIZE="4" NOSHADE> <B>Contents</B><UL> <LI><A HREF="#class">Deprecated Classes</A> <LI><A HREF="#field">Deprecated Fields</A> <LI><A HREF="#method">Deprecated Methods</A> <LI><A HREF="#constructor">Deprecated Constructors</A> </UL> <A NAME="class"><!-- --></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>Deprecated Classes</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/dom/DocumentBuilderFactoryImpl.html" title="class in net.sf.saxon.dom">net.sf.saxon.dom.DocumentBuilderFactoryImpl</A> <BR> <I>since 9.3. The DOM created by this class is a DOM wrapper around (typically) a Saxon Tiny Tree. There is little point in constructing such an object. If the tree is primarily for use by Saxon XSLT and XQuery, it is better to construct a Tiny Tree directly and omit the DOM wrapper; if it is primarily for other DOM applications, it is better to construct a fully- functional DOM using (for example) Apache Xerces.</I> </TD> </TR> </TABLE> <P> <A NAME="field"><!-- --></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>Deprecated Fields</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/lib/SaxonOutputKeys.html#SAXON_SUPPRESS_INDENTATION">net.sf.saxon.lib.SaxonOutputKeys.SAXON_SUPPRESS_INDENTATION</A> <BR> <I>use SUPPRESS_INDENTATION (the output property has been adopted as a standard property in XSLT 3.0, it is no longer Saxon-specific)</I> </TD> </TR> </TABLE> <P> <A NAME="method"><!-- --></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>Deprecated Methods</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/query/StaticQueryContext.html#buildDocument(javax.xml.transform.Source)">net.sf.saxon.query.StaticQueryContext.buildDocument(Source)</A> <BR> <I>since 9.2: use <A HREF="net/sf/saxon/Configuration.html#buildDocument(javax.xml.transform.Source)"><CODE>Configuration.buildDocument(javax.xml.transform.Source)</CODE></A></I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/query/StaticQueryContext.html#clearPassiveNamespaces()">net.sf.saxon.query.StaticQueryContext.clearPassiveNamespaces()</A> <BR> <I>since 9.0 - use <A HREF="net/sf/saxon/query/StaticQueryContext.html#clearNamespaces()"><CODE>StaticQueryContext.clearNamespaces()</CODE></A></I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/xpath/XPathEvaluator.html#createExpression(java.lang.String)">net.sf.saxon.xpath.XPathEvaluator.createExpression(String)</A> <BR> <I>since Saxon 8.9 - use <A HREF="net/sf/saxon/xpath/XPathEvaluator.html#compile(java.lang.String)"><CODE>XPathEvaluator.compile(String)</CODE></A></I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/query/StaticQueryContext.html#declarePassiveNamespace(java.lang.String, java.lang.String, boolean)">net.sf.saxon.query.StaticQueryContext.declarePassiveNamespace(String, String, boolean)</A> <BR> <I>since 9.0. Use <A HREF="net/sf/saxon/query/StaticQueryContext.html#declareNamespace(java.lang.String, java.lang.String)"><CODE>StaticQueryContext.declareNamespace(java.lang.String, java.lang.String)</CODE></A></I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/xpath/XPathExpressionImpl.html#evaluate()">net.sf.saxon.xpath.XPathExpressionImpl.evaluate()</A> <BR> <I>since 9.0. This method is not present in the JAXP interface. Either use the JAXP methods such as <A HREF="net/sf/saxon/xpath/XPathExpressionImpl.html#evaluate(java.lang.Object, javax.xml.namespace.QName)"><CODE>XPathExpressionImpl.evaluate(Object, QName)</CODE></A>, or use the Saxon XPath API instead of JAXP.</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/xpath/XPathExpressionImpl.html#evaluateSingle()">net.sf.saxon.xpath.XPathExpressionImpl.evaluateSingle()</A> <BR> <I>since 9.0. This method is not present in the JAXP interface. Either use the JAXP methods such as <A HREF="net/sf/saxon/xpath/XPathExpressionImpl.html#evaluate(java.lang.Object, javax.xml.namespace.QName)"><CODE>XPathExpressionImpl.evaluate(Object, QName)</CODE></A>, or use the Saxon XPath API instead of JAXP.</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="com/saxonica/schema/UserDefinedType.html#getLocalName()">com.saxonica.schema.UserDefinedType.getLocalName()</A> <BR> <I>since 9.0: use the equivalent method <A HREF="com/saxonica/schema/UserDefinedType.html#getName()"><CODE>UserDefinedType.getName()</CODE></A></I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="com/saxonica/schema/AttributeDecl.html#getNamespace()">com.saxonica.schema.AttributeDecl.getNamespace()</A> <BR> <I>since 9.0: use the renamed method getTargetNamespace()</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/Controller.html#getTreeModel()">net.sf.saxon.Controller.getTreeModel()</A> <BR> <I>since 9.2: use <A HREF="net/sf/saxon/Controller.html#getModel()"><CODE>Controller.getModel()</CODE></A></I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/lib/AugmentedSource.html#getTreeModel()">net.sf.saxon.lib.AugmentedSource.getTreeModel()</A> <BR> <I>since 9.2: use <A HREF="net/sf/saxon/lib/AugmentedSource.html#getModel()"><CODE>AugmentedSource.getModel()</CODE></A></I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="com/saxonica/config/ProfessionalConfiguration.html#isSchemaAware(int)">com.saxonica.config.ProfessionalConfiguration.isSchemaAware(int)</A> <BR> <I>since 9.2: use isLicensedFeature() instead</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/Configuration.html#isSchemaAware(int)">net.sf.saxon.Configuration.isSchemaAware(int)</A> <BR> <I>since 9.2: use isLicensedFeature() instead</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/Configuration.html#makeSchemaAwareConfiguration(java.lang.ClassLoader, java.lang.String)">net.sf.saxon.Configuration.makeSchemaAwareConfiguration(ClassLoader, String)</A> <BR> <I>since 9.2. Use <A HREF="net/sf/saxon/Configuration.html#makeLicensedConfiguration(java.lang.ClassLoader, java.lang.String)"><CODE>Configuration.makeLicensedConfiguration(java.lang.ClassLoader, java.lang.String)</CODE></A> instead.</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/s9api/XdmItem.html#newAtomicValue(java.lang.String, net.sf.saxon.s9api.ItemType)">net.sf.saxon.s9api.XdmItem.newAtomicValue(String, ItemType)</A> <BR> <I>since 9.1. This factory method duplicates the constructor <A HREF="net/sf/saxon/s9api/XdmAtomicValue.html#XdmAtomicValue(java.lang.String, net.sf.saxon.s9api.ItemType)"><CODE>XdmAtomicValue.XdmAtomicValue(String, ItemType)</CODE></A> which should be used in preference</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/value/DurationValue.html#normalizeDuration()">net.sf.saxon.value.DurationValue.normalizeDuration()</A> <BR> <I>since 9.0 - the method does nothing</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/dom/DocumentBuilderImpl.html#parse(org.xml.sax.InputSource)">net.sf.saxon.dom.DocumentBuilderImpl.parse(InputSource)</A> <BR> <I>since 9.3. The DOM created by this class is a DOM wrapper around (typically) a Saxon Tiny Tree. There is little point in constructing such an object. If the tree is primarily for use by Saxon XSLT and XQuery, it is better to construct a Tiny Tree directly and omit the DOM wrapper; if it is primarily for other DOM applications, it is better to construct a fully- functional DOM using (for example) Apache Xerces.</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/sxpath/XPathExpression.html#rawIterator(javax.xml.transform.Source)">net.sf.saxon.sxpath.XPathExpression.rawIterator(Source)</A> <BR> <I>since 8.9 - use <A HREF="net/sf/saxon/sxpath/XPathExpression.html#iterate(net.sf.saxon.sxpath.XPathDynamicContext)"><CODE>XPathExpression.iterate(net.sf.saxon.sxpath.XPathDynamicContext)</CODE></A></I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/query/QueryResult.html#serialize(net.sf.saxon.om.NodeInfo, javax.xml.transform.Result, java.util.Properties, net.sf.saxon.Configuration)">net.sf.saxon.query.QueryResult.serialize(NodeInfo, Result, Properties, Configuration)</A> <BR> <I>since 8.9; use <A HREF="net/sf/saxon/query/QueryResult.html#serialize(net.sf.saxon.om.NodeInfo, javax.xml.transform.Result, java.util.Properties)"><CODE>QueryResult.serialize(NodeInfo, Result, Properties)</CODE></A> instead.</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/query/DynamicQueryContext.html#setContextNode(net.sf.saxon.om.NodeInfo)">net.sf.saxon.query.DynamicQueryContext.setContextNode(NodeInfo)</A> <BR> <I>From Saxon 8.7, the method <A HREF="net/sf/saxon/query/DynamicQueryContext.html#setContextItem(net.sf.saxon.om.Item)"><CODE>DynamicQueryContext.setContextItem(Item)</CODE></A> is preferred</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/xpath/XPathExpressionImpl.html#setContextNode(net.sf.saxon.om.NodeInfo)">net.sf.saxon.xpath.XPathExpressionImpl.setContextNode(NodeInfo)</A> <BR> <I>since 9.0. Using this method is not thread-safe. Use a method instead such as <A HREF="net/sf/saxon/xpath/XPathExpressionImpl.html#evaluate(java.lang.Object, javax.xml.namespace.QName)"><CODE>XPathExpressionImpl.evaluate(Object, QName)</CODE></A> that allows the context node to be specified as a parameter to the call.</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/xpath/XPathEvaluator.html#setContextNode(net.sf.saxon.om.NodeInfo)">net.sf.saxon.xpath.XPathEvaluator.setContextNode(NodeInfo)</A> <BR> <I>since Saxon 8.9 - use the various method defined in the JAXP interface definition, which allow a NodeInfo object to be supplied as the value of the Source argument</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/Configuration.html#setRetainDTDAttributeTypes(boolean)">net.sf.saxon.Configuration.setRetainDTDAttributeTypes(boolean)</A> <BR> <I>since 9.2 This feature was dropped from the final XDM specification and will be dropped in a future Saxon release. The facility is supported only in Saxon-EE. Use an XSD schema to define the attribute types instead.</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/xpath/XPathExpressionImpl.html#setSortKey(net.sf.saxon.xpath.XPathExpressionImpl)">net.sf.saxon.xpath.XPathExpressionImpl.setSortKey(XPathExpressionImpl)</A> <BR> <I>since 9.0. This method is not present in the JAXP interface. The recommended way to get a sorted result is to use XQuery instead of XPath.</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/xpath/XPathEvaluator.html#setStripSpace(boolean)">net.sf.saxon.xpath.XPathEvaluator.setStripSpace(boolean)</A> <BR> <I>since 8.9. The preferred way to define options for the way in which source documents are built is to use the class <A HREF="net/sf/saxon/lib/AugmentedSource.html" title="class in net.sf.saxon.lib"><CODE>AugmentedSource</CODE></A> for any of the methods expecting a <A HREF="http://download.oracle.com/javase/6/docs/api/javax/xml/transform/Source.html?is-external=true" title="class or interface in javax.xml.transform"><CODE>Source</CODE></A> object.</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/Controller.html#setTreeModel(int)">net.sf.saxon.Controller.setTreeModel(int)</A> <BR> <I>since 9.2: use <A HREF="net/sf/saxon/Controller.html#setModel(net.sf.saxon.om.TreeModel)"><CODE>Controller.setModel(net.sf.saxon.om.TreeModel)</CODE></A></I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/lib/AugmentedSource.html#setTreeModel(int)">net.sf.saxon.lib.AugmentedSource.setTreeModel(int)</A> <BR> <I>since 9.2: use <A HREF="net/sf/saxon/lib/AugmentedSource.html#setModel(net.sf.saxon.om.TreeModel)"><CODE>AugmentedSource.setModel(net.sf.saxon.om.TreeModel)</CODE></A></I> </TD> </TR> </TABLE> <P> <A NAME="constructor"><!-- --></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>Deprecated Constructors</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/query/StaticQueryContext.html#StaticQueryContext(net.sf.saxon.Configuration)">net.sf.saxon.query.StaticQueryContext(Configuration)</A> <BR> <I>since 9.2. Use config.newStaticQueryContext(). This will create a StaticQueryContext with capabilities appropriate to the configuration (for example, offering XQuery 1.1 support).</I> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><A HREF="net/sf/saxon/expr/XPathContextMajor.html#XPathContextMajor(net.sf.saxon.om.Item, net.sf.saxon.Configuration)">net.sf.saxon.expr.XPathContextMajor(Item, Configuration)</A> <BR> <I>since 9.0 - use <A HREF="net/sf/saxon/expr/XPathContextMajor.html#XPathContextMajor(net.sf.saxon.om.Item, net.sf.saxon.expr.instruct.Executable)"><CODE>XPathContextMajor.XPathContextMajor(Item, Executable)</CODE></A></I> </TD> </TR> </TABLE> <P> <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"> <FONT CLASS="NavBarFont1">Package</FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="overview-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Deprecated</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR> </TABLE> </TD> <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> </EM> </TD> </TR> <TR> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> PREV NEXT</FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="index.html?deprecated-list.html" target="_top"><B>FRAMES</B></A> <A HREF="deprecated-list.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> </TABLE> <A NAME="skip-navbar_bottom"></A> <!-- ======== END OF BOTTOM NAVBAR ======= --> <HR> Copyright (c) 2004-2011 Saxonica Limited. All rights reserved. </BODY> </HTML>