net.sf.saxon

Class PreparedStylesheet

java.lang.Object

net.sf.saxon.expr.instruct.Executable

net.sf.saxon.PreparedStylesheet

public class PreparedStylesheet
extends Executable

This PreparedStylesheet class represents a Stylesheet that has been prepared for execution (or "compiled").

Note that the PreparedStylesheet object does not contain a reference to the source stylesheet tree (rooted at an XSLStyleSheet object). This allows the source tree to be garbage-collected when it is no longer required.

The PreparedStylesheet in XSLT 3.0 represents the set of all packages making up an executable stylesheet.

Field Summary

Fields inherited from class net.sf.saxon.expr.instruct.Executable

schemaAware

Constructor Summary

Constructors

Constructor and Description
PreparedStylesheet(Compilation compilation) Constructor - deliberately protected

Method Summary

Modifier and Type	Method and Description
void	explain(ExpressionPresenter presenter) Produce an XML representation of the compiled and optimized stylesheet, as a human-readable entity
void	explainNamedTemplates(ExpressionPresenter presenter) Explain the expression tree for named templates in a stylesheet
PreparedStylesheet	getCachedStylesheet(java.lang.String href, java.lang.String baseURI) Get a "next in chain" stylesheet.
GlobalParameterSet	getCompileTimeParams() Get the parameters that were set at compile time.
Component	getComponent(SymbolicName name)
NamedTemplate	getNamedTemplate(StructuredQName qName) Get the named template with a given name.
java.util.Properties	getOutputProperties() Get the properties for xsl:output.
RuleManager	getRuleManager() Get the RuleManager which handles template rules
StylesheetPackage	getTopLevelPackage()
java.util.Iterator<NamedTemplate>	iterateNamedTemplates() Iterate over all the named templates defined in this Executable
Controller	newController() Make a Controller from this stylesheet object.
void	putCachedStylesheet(java.lang.String href, java.lang.String baseURI, PreparedStylesheet pss) Save a "next in chain" stylesheet in compiled form, so that it can be reused repeatedly.
void	putNamedTemplate(StructuredQName templateName, NamedTemplate template) Register the named template with a given name
void	setComponentIndex(java.util.Map<SymbolicName,Component> index) Register the index of components
void	setRuleManager(RuleManager rm) Set the RuleManager that handles template rules

Methods inherited from class net.sf.saxon.expr.instruct.Executable

addPackage, addQueryLibraryModule, addQueryLocationHintProcessed, checkAllRequiredParamsArePresent, checkInitialContextItem, createsSecondaryResult, explainGlobalVariables, fixupQueryModules, getCharacterMapIndex, getCompilerService, getConfiguration, getDefaultOutputProperties, getFunctionLibrary, getGlobalContextRequirement, getGlobalParameters, getHostLanguage, getKeyManager, getOutputProperties, getPackages, getQueryLibraryModules, getQueryLibraryModules, getQueryModuleWithSystemId, isQueryLocationHintProcessed, isSchemaAware, obtainCompilerService, registerGlobalParameter, setCharacterMapIndex, setCompilerService, setConfiguration, setCreatesSecondaryResult, setDefaultOutputProperties, setFunctionLibrary, setGlobalContextRequirement, setHostLanguage, setKeyManager, setOutputProperties, setSchemaAware, setTopLevelPackage

Methods inherited from class java.lang.Object

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

Constructor Detail

PreparedStylesheet

public PreparedStylesheet(Compilation compilation)

Constructor - deliberately protected

Parameters:

compilation - Compilation options

Method Detail

newController

public Controller newController()

Make a Controller from this stylesheet object.

Returns:

the new Controller

See Also:

Controller

getCompileTimeParams

public GlobalParameterSet getCompileTimeParams()

Get the parameters that were set at compile time. These will generally be static parameters, but it is also permitted to set non-static parameters at compile time.

Returns:

the parameters that were set prior to XSLT compilation

getTopLevelPackage

public StylesheetPackage getTopLevelPackage()

Overrides:

getTopLevelPackage in class Executable

setRuleManager

public void setRuleManager(RuleManager rm)

Set the RuleManager that handles template rules

Parameters:

rm - the RuleManager containing details of all the template rules

getRuleManager

public RuleManager getRuleManager()

Get the RuleManager which handles template rules

Returns:

the RuleManager registered with setRuleManager

getNamedTemplate

public NamedTemplate getNamedTemplate(StructuredQName qName)

Get the named template with a given name.

Parameters:

qName - The template name

Returns:

The template (of highest import precedence) with this name if there is one; null if none is found.

putNamedTemplate

public void putNamedTemplate(StructuredQName templateName,
                             NamedTemplate template)

Register the named template with a given name

Parameters:

templateName - the name of a named XSLT template

template - the template

setComponentIndex

public void setComponentIndex(java.util.Map<SymbolicName,Component> index)

Register the index of components

Parameters:

index - the component index

getComponent

public Component getComponent(SymbolicName name)

iterateNamedTemplates

public java.util.Iterator<NamedTemplate> iterateNamedTemplates()

Iterate over all the named templates defined in this Executable

Returns:

an iterator, the items returned being of class NamedTemplate

explainNamedTemplates

public void explainNamedTemplates(ExpressionPresenter presenter)
                           throws XPathException

Explain the expression tree for named templates in a stylesheet

Parameters:

presenter - destination for the explanatory output

Throws:

XPathException

getOutputProperties

public java.util.Properties getOutputProperties()

Get the properties for xsl:output. JAXP method. The object returned will be a clone of the internal values, and thus it can be mutated without mutating the Templates object, and then handed in to the process method.

In Saxon, the properties object is a new, empty, Properties object that is backed by the live properties to supply default values for missing properties. This means that the property values must be read using the getProperty() method. Calling the get() method on the underlying Hashtable will return null.

In Saxon 8.x, this method gets the output properties for the unnamed output format in the stylesheet.

Returns:

A Properties object reflecting the output properties defined for the default (unnamed) output format in the stylesheet. It may be mutated and supplied to the setOutputProperties() method of the Transformer, without affecting other transformations that use the same stylesheet.

See Also:

Transformer.setOutputProperties(java.util.Properties)

getCachedStylesheet

public PreparedStylesheet getCachedStylesheet(java.lang.String href,
                                              java.lang.String baseURI)

Get a "next in chain" stylesheet. This method is intended for internal use.

Parameters:

href - the relative URI of the next-in-chain stylesheet

baseURI - the baseURI against which this relativeURI is to be resolved

Returns:

the cached stylesheet if present in the cache, or null if not

putCachedStylesheet

public void putCachedStylesheet(java.lang.String href,
                                java.lang.String baseURI,
                                PreparedStylesheet pss)

Save a "next in chain" stylesheet in compiled form, so that it can be reused repeatedly. This method is intended for internal use.

Parameters:

href - the relative URI of the stylesheet

baseURI - the base URI against which the relative URI is resolved

pss - the prepared stylesheet object to be cached

explain

public void explain(ExpressionPresenter presenter)
             throws XPathException

Produce an XML representation of the compiled and optimized stylesheet, as a human-readable entity

Parameters:

presenter - defines the destination and format of the output

Throws:

XPathException