Package com.saxonica.config

Class StreamingTransformerFactory

java.lang.Object

javax.xml.transform.TransformerFactory

javax.xml.transform.sax.SAXTransformerFactory

net.sf.saxon.jaxp.SaxonTransformerFactory

net.sf.saxon.TransformerFactoryImpl

com.saxonica.config.ProfessionalTransformerFactory

com.saxonica.config.EnterpriseTransformerFactory

com.saxonica.config.StreamingTransformerFactory

All Implemented Interfaces:

Configuration.ApiProvider

public class StreamingTransformerFactory
extends EnterpriseTransformerFactory

The is a customized JAXP TransformerFactory implementation for the enterprise edition of Saxon. It is designed specifically for running XSLT 3.0 streaming transformations, where the Source object supplied to the Transformer.transform() method is supplied as a SAXSource or StreamSource. Because it is designed for streaming, the source document does not become the global context item (specifically, if a global variable references the value of the context item ".", a dynamic error XPDY0002 occurs). This means that this JAXP TransformerFactory is not a 100% compatible replacement for a "standard" TransformerFactory.

Field Summary

Fields inherited from class javax.xml.transform.sax.SAXTransformerFactory

FEATURE, FEATURE_XMLFILTER

Constructor Summary

Constructors

Constructor	Description
StreamingTransformerFactory()	Create a StreamingTransformerFactory.
StreamingTransformerFactory(EnterpriseConfiguration config)	Construct a StreamingTransformerFactory using an existing Configuration.

Method Summary

Modifier and Type	Method	Description
Templates	newTemplates(Source source)	Process the Source into a Templates object, which is a a compiled representation of the source.
Templates	newTemplates(Source source, CompilerInfo info)	Process the Source into a Templates object, which is a a compiled representation of the source.
TransformerHandler	newTransformerHandler(Templates templates)	Get a TransformerHandler object that can process SAX ContentHandler events into a Result, based on the Templates argument.
void	setConfiguration(Configuration config)	Set the configuration.

Methods inherited from class com.saxonica.config.EnterpriseTransformerFactory

addSchema, setAttribute

Methods inherited from class net.sf.saxon.jaxp.SaxonTransformerFactory

getAssociatedStylesheet, getAttribute, getConfiguration, getErrorListener, getFeature, getProcessor, getURIResolver, newTemplatesHandler, newTransformer, newTransformer, newTransformerHandler, newTransformerHandler, newXMLFilter, newXMLFilter, setErrorListener, setFeature, setURIResolver

Methods inherited from class javax.xml.transform.TransformerFactory

newDefaultInstance, newInstance, newInstance

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

StreamingTransformerFactory

public StreamingTransformerFactory()

Create a StreamingTransformerFactory. An EnterpriseConfiguration will be created automatically.

StreamingTransformerFactory

public StreamingTransformerFactory(EnterpriseConfiguration config)

Construct a StreamingTransformerFactory using an existing Configuration.

Parameters:

config - the configuration to be used. This must be an EnterpriseConfiguration.

Method Details

setConfiguration

public void setConfiguration(Configuration config)

Description copied from class: SaxonTransformerFactory

Set the configuration. This can also be done using the JAXP method setAttribute, with the attribute name FeatureKeys.CONFIGURATION

Overrides:

setConfiguration in class SaxonTransformerFactory

Parameters:

config - the Saxon configuration

newTemplates

public Templates newTemplates(Source source)
                       throws TransformerConfigurationException

Description copied from class: EnterpriseTransformerFactory

Process the Source into a Templates object, which is a a compiled representation of the source. This Templates object may then be used concurrently across multiple threads. Creating a Templates object allows the TransformerFactory to do detailed performance optimization of transformation instructions, without penalizing runtime transformation.

Overrides:

newTemplates in class EnterpriseTransformerFactory

Parameters:

source - An object that holds a URL, input stream, etc.

Returns:

A Templates object capable of being used for transformation purposes, never null.

Throws:

TransformerConfigurationException - May throw this during the parse when it is constructing the Templates object and fails.

newTemplates

public Templates newTemplates(Source source,
 CompilerInfo info)
                       throws TransformerConfigurationException

Description copied from class: EnterpriseTransformerFactory

Process the Source into a Templates object, which is a a compiled representation of the source. This Templates object may then be used concurrently across multiple threads. Creating a Templates object allows the TransformerFactory to do detailed performance optimization of transformation instructions, without penalizing runtime transformation.

Overrides:

newTemplates in class EnterpriseTransformerFactory

Parameters:

source - An object that holds a URL, input stream, etc.

info - compile-time options for this stylesheet compilation

Returns:

A Templates object capable of being used for transformation purposes, never null.

Throws:

TransformerConfigurationException - May throw this during the parse when it is constructing the Templates object and fails.

newTransformerHandler

public TransformerHandler newTransformerHandler(Templates templates)
                                         throws TransformerConfigurationException

Get a TransformerHandler object that can process SAX ContentHandler events into a Result, based on the Templates argument.

Overrides:

newTransformerHandler in class SaxonTransformerFactory

Parameters:

templates - The compiled transformation instructions.

Returns:

TransformerHandler ready to transform SAX events.

Throws:

TransformerConfigurationException - If for some reason the TransformerHandler can not be created.