Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
net.sf.saxon.lib.CollectionURIResolver since 9.7: use CollectionFinder.

Deprecated Methods

Method and Description
net.sf.saxon.s9api.XsltCompiler.addCompilePackages(Iterable<Source>, boolean) since 9.8. Multiple packages may be supplied in the form of a PackageLibrary registered with the underlying CompilerInfo, or may be listed in the configuration file. Alternatively they can be imported explicitly (taking care over the order of importing) using XsltCompiler.importPackage(XsltPackage).
net.sf.saxon.Configuration.buildDocument(Source) since 9.7: use Configuration.buildDocumentTree(Source).
net.sf.saxon.query.StaticQueryContext.buildDocument(Source) since 9.2: use Configuration.buildDocumentTree(javax.xml.transform.Source)
net.sf.saxon.Configuration.buildDocument(Source, ParseOptions) since 9.7: use Configuration.buildDocumentTree(Source, ParseOptions).
net.sf.saxon.s9api.XsltCompiler.compilePackages(Iterable<Source>) since 9.8. Multiple packages may be supplied in the form of a PackageLibrary registered with the underlying CompilerInfo, or may be listed in the configuration file. Alternatively they can be imported explicitly (taking care over the order of importing) using XsltCompiler.importPackage(XsltPackage).
net.sf.saxon.s9api.XsltCompiler.declareCollation(String, Collator) since 9.6. Collations are now held globally. If this method is called, the effect is to update the pool of collations held globally by the Processor.
net.sf.saxon.s9api.XQueryCompiler.declareCollation(String, Collator) since 9.6. Collations are now held globally. If this method is called, the effect is to update the pool of collations held globally by the Processor.
net.sf.saxon.s9api.XPathCompiler.declareCollation(String, Collator) since 9.6. Collations are now held globally at the level of the Processor (in fact, at the level of the Processor's underlying Configuration, which can in principle be shared by multiple Processors). If this method is called, the effect will be to reset the relevant collation at the global Configuration level.
net.sf.saxon.query.StaticQueryContext.declareCollation(String, Comparator) since 9.6. All collations are now registered at the level of the Configuration. If this method is called, the effect is that the supplied collation is registered with the configuration
net.sf.saxon.query.StaticQueryContext.declareCollation(String, StringCollator) since 9.6. All collations are now registered at the level of the Configuration. If this method is called, the effect is that the supplied collation is registered with the configuration
net.sf.saxon.sxpath.AbstractStaticContext.declareCollation(String, StringCollator, boolean) since 9.6. All collations are now registered at the level of the Configuration. If this method is called, the effect is (a) the supplied collation is registered with the configuration, and (b) if isDefault=true, the collation becomes the default collation for this static context
net.sf.saxon.expr.instruct.ConditionalBlock.getChildren() since 9.7 - use the operands() iterator instead
net.sf.saxon.query.StaticQueryContext.getCollation(String) since 9.6. Collations are now all held globally at the level of the Configuration. Calling this method will get the relevant collation held in the Configuration.
net.sf.saxon.Controller.getCollectionURIResolver() since 9.7. Use Controller.getCollectionFinder()
net.sf.saxon.Configuration.getCollectionURIResolver() since 9.7. Use Configuration.getCollectionFinder()
net.sf.saxon.sxpath.XPathDynamicContext.getCollectionURIResolver() since 9.7 - use XPathDynamicContext.getCollectionFinder()
net.sf.saxon.lib.ParseOptions.getStripSpace() since 9.8. Use ParseOptions.getSpaceStrippingRule()
net.sf.saxon.lib.AugmentedSource.getStripSpace() since 9.8 - use getParseOptions().getSpaceStrippingRules()
net.sf.saxon.trans.CompilerInfo.getXsltVersion() since 9.8 (always returns 30)
net.sf.saxon.event.StreamWriterToReceiver.isInventPrefixes() since 9.7.0.2
net.sf.saxon.Configuration.isVersionWarning() since 9.8.0.2: the method now always returns false. See bug 3278.
net.sf.saxon.trans.CompilerInfo.isVersionWarning() since 9.8.0.2. Always now returns false. See bug 3278.
net.sf.saxon.query.XQueryExpression.pull(DynamicQueryContext, Result, Properties) since 9.8.
net.sf.saxon.query.XQueryExpression.pull(DynamicQueryContext, SequenceReceiver) since 9.8.
net.sf.saxon.Controller.setCollectionURIResolver(CollectionURIResolver) since 9.7. Use Controller.setCollectionFinder(CollectionFinder)
net.sf.saxon.Configuration.setCollectionURIResolver(CollectionURIResolver) since 9.7. Use Configuration.setCollectionFinder(CollectionFinder)
net.sf.saxon.sxpath.XPathDynamicContext.setCollectionURIResolver(CollectionURIResolver) since 9.7 - use XPathDynamicContext.setCollectionFinder(CollectionFinder)
net.sf.saxon.query.XQueryParser.setDisableCycleChecks(boolean) in 9.8, the XQUery 3.0+ rules for cycles are always used, and the old 1.0 cycle checks never happen.
net.sf.saxon.trans.CompilerInfo.setExtensionFunctionLibrary(FunctionLibrary) since 9.7. Any extension function library set using this mechanism will not be available if the package is saved and reloaded.
net.sf.saxon.s9api.Xslt30Transformer.setInitialContextItem(XdmItem) since 9.8 - use Xslt30Transformer.setGlobalContextItem(net.sf.saxon.s9api.XdmItem)
net.sf.saxon.s9api.Xslt30Transformer.setInitialContextNode(XdmNode) since 9.7.0.1 - use Xslt30Transformer.setGlobalContextItem(net.sf.saxon.s9api.XdmItem)
net.sf.saxon.event.StreamWriterToReceiver.setInventPrefixes(boolean) since 9.7.0.2. In normal use this class feeds its output into a NamespaceReducer which performs the equivalent of "namespace repairing" or "prefix invention": that is, it ensures that when elements or attributes are written in a specific namespace, there is no need for an explicit StreamWriterToReceiver.writeNamespace(String, String) call to create the namespace declaration.
net.sf.saxon.s9api.XQueryCompiler.setLanguageVersion(String) in 9.8; the only XQuery version supported is "3.1", and any other value is ignored with a warning.
net.sf.saxon.Configuration.setStripsAllWhiteSpace(boolean) since 9.8: use getParseOptions().setSpaceStrippingRule(AllElementsSpaceStrippingRule.getInstance())
net.sf.saxon.lib.ParseOptions.setStripSpace(int) since 9.8. Use ParseOptions.setSpaceStrippingRule(net.sf.saxon.om.SpaceStrippingRule)
net.sf.saxon.lib.AugmentedSource.setStripSpace(int) since 9.8 - use getParseOptions().setSpaceStrippingRules()
net.sf.saxon.Configuration.setStripsWhiteSpace(int) since 9.8: use getParseOptions().setSpaceStrippingRule(AllElementsSpaceStrippingRule.getInstance())
net.sf.saxon.Configuration.setVersionWarning(boolean) since 9.8.0.2: the method no longer has any effect. See bug 3278.
net.sf.saxon.trans.CompilerInfo.setVersionWarning(boolean) since 9.8.0.2. The method no longer has any effect. See bug 3278.
net.sf.saxon.s9api.XsltCompiler.setXsltLanguageVersion(String) Has no effect from Saxon 9.8.
net.sf.saxon.trans.CompilerInfo.setXsltVersion(int) since Saxon 9.8 (has no effect).

Deprecated Constructors

Constructor and Description
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).