## Deprecated API

Contents

- Deprecated Classes
- Deprecated Fields
- Deprecated Methods
- Deprecated Constructors

Deprecated Classes

net.sf.saxon.dom.DocumentBuilderFactoryImpl
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.

Deprecated Fields
net.sf.saxon.lib.SaxonOutputKeys.SAXON_SUPPRESS_INDENTATION use SUPPRESS_INDENTATION (the output property has been adopted as a standard property in XSLT 3.0, it is no longer Saxon-specific)

Deprecated Methods
net.sf.saxon.event.Builder.build(Source, RuleBasedStripper, Configuration) since Saxon 9.2: use `Configuration.buildDocument(javax.xml.transform.Source)`. The method was also changed in 9.2 to ignore the stripper parameter.
net.sf.saxon.event.Builder.build(Source, RuleBasedStripper, PipelineConfiguration) since Saxon 9.2: use `Configuration.buildDocument(javax.xml.transform.Source)`. The method was also changed in 9.2 to ignore the stripper parameter.
net.sf.saxon.query.StaticQueryContext.buildDocument(Source) since 9.2: use `Configuration.buildDocument(javax.xml.transform.Source)`
net.sf.saxon.query.StaticQueryContext.clearPassiveNamespaces() since 9.0 - use `StaticQueryContext.clearNamespaces()`
net.sf.saxon.xpath.XPathEvaluator.createExpression(String) since Saxon 8.9 - use `XPathEvaluator.compile(String)`
net.sf.saxon.query.StaticQueryContext.declarePassiveNamespace(String, String, boolean) since 9.0. Use `StaticQueryContext.declareNamespace(java.lang.String, java.lang.String)`
net.sf.saxon.xpath.XPathExpressionImpl.evaluate() since 9.0. This method is not present in the JAXP interface. Either use the JAXP methods such as `XPathExpressionImpl.evaluate(Object, QName)`, or use the Saxon XPath API instead of JAXP.
net.sf.saxon.xpath.XPathExpressionImpl.evaluateSingle() since 9.0. This method is not present in the JAXP interface. Either use the JAXP methods such as `XPathExpressionImpl.evaluate(Object, QName)`, or use the Saxon XPath API instead of JAXP.
com.saxonica.schema.UserDefinedType.getLocalName() since 9.0: use the equivalent method `UserDefinedType.getName()`
com.saxonica.schema.AttributeDecl.getNamespace() since 9.0: use the renamed method getTargetNamespace()
com.saxonica.schema.ElementDecl.getNamespaceURI() since 9.0: use the renamed method getTargetNamespace()
net.sf.saxon.Controller.getTreeModel() since 9.2: use `Controller.getModel()`
net.sf.saxon.lib.AugmentedSource.getTreeModel() since 9.2: use `AugmentedSource.getModel()`
com.saxonica.config.ProfessionalConfiguration.isSchemaAware(int) since 9.2: use isLicensedFeature() instead
net.sf.saxon.Configuration.isSchemaAware(int) since 9.2: use isLicensedFeature() instead
net.sf.saxon.Configuration.makeSchemaAwareConfiguration(ClassLoader, String) since 9.2. Use `Configuration.makeLicensedConfiguration(java.lang.ClassLoader, java.lang.String)` instead.
net.sf.saxon.s9api.XdmItem.newAtomicValue(String, ItemType) since 9.1. This factory method duplicates the constructor `XdmAtomicValue.XdmAtomicValue(String, ItemType)` which should be used in preference
net.sf.saxon.value.DurationValue.normalizeDuration() since 9.0 - the method does nothing

net.sf.saxon.dom.DocumentBuilderImpl.parse(InputSource)
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.

net.sf.saxon.sxpath.XPathExpression.rawIterator(Source) since 8.9 - use `XPathExpression.iterate(net.sf.saxon.sxpath.XPathDynamicContext)`
net.sf.saxon.query.QueryResult.serialize(NodeInfo, Result, Properties, Configuration) since 8.9; use `QueryResult.serialize(NodeInfo, Result, Properties)` instead.
net.sf.saxon.query.DynamicQueryContext.setContextNode(NodeInfo) From Saxon 8.7, the method `DynamicQueryContext.setContextItem(Item)` is preferred
net.sf.saxon.xpath.XPathExpressionImpl.setContextNode(NodeInfo) since 9.0. Using this method is not thread-safe. Use a method instead such as `XPathExpressionImpl.evaluate(Object, QName)` that allows the context node to be specified as a parameter to the call.
net.sf.saxon.xpath.XPathEvaluator.setContextNode(NodeInfo) 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
net.sf.saxon.Configuration.setRetainDTDAttributeTypes(boolean) 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.
net.sf.saxon.xpath.XPathExpressionImpl.setSortKey(XPathExpressionImpl) 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.
net.sf.saxon.xpath.XPathEvaluator.setStripSpace(boolean) since 8.9. The preferred way to define options for the way in which source documents are built is to use the class `AugmentedSource` for any of the methods expecting a `Source` object.
net.sf.saxon.Controller.setTreeModel(int) since 9.2: use `Controller.setModel(net.sf.saxon.om.TreeModel)`
net.sf.saxon.lib.AugmentedSource.setTreeModel(int) since 9.2: use `AugmentedSource.setModel(net.sf.saxon.om.TreeModel)`

Deprecated Constructors
net.sf.saxon.lib.StandardURIResolver() since 8.7
net.sf.saxon.query.StaticQueryContext(Configuration) since 9.2. Use config.newStaticQueryContext(). This will create a StaticQueryContext with capabilities appropriate to the configuration (for example, offering XQuery 1.1 support).
net.sf.saxon.expr.XPathContextMajor(Item, Configuration) since 9.0 - use `XPathContextMajor.XPathContextMajor(Item, Executable)`

Copyright (c) 2004-2010 Saxonica Limited. All rights reserved.