org.apache.xalan.transformer

Class TransformerImpl

public class TransformerImpl extends Transformer implements Runnable, DTMWSFilter, ExtensionsProvider, SerializerTrace

This class implements the {@link javax.xml.transform.Transformer} interface, and is the core representation of the transformation execution.

UNKNOWN: advanced

Constructor Summary
TransformerImpl(StylesheetRoot stylesheet)
Construct a TransformerImpl.
Method Summary
booleanapplyTemplateToNode(ElemTemplateElement xslInstruction, ElemTemplate template, int child)
Given an element and mode, find the corresponding template and process the contents.
voidclearParameters()
Reset the parameters to a null list.
SerializationHandlercreateSerializationHandler(Result outputTarget)
Create a result ContentHandler from a Result object, based on the current OutputProperties.
SerializationHandlercreateSerializationHandler(Result outputTarget, OutputProperties format)
Create a ContentHandler from a Result object and an OutputProperties.
booleancurrentFuncResultSeen()
Determines whether an EXSLT func:result instruction has been executed for the currently active EXSLT func:function.
booleancurrentTemplateRuleIsNull()
Tell if the current template rule is null, i.e. if we are directly within an apply-templates.
booleanelementAvailable(String ns, String elemName)
voidexecuteChildTemplates(ElemTemplateElement elem, Node context, QName mode, ContentHandler handler)
Execute each of the children of a template element.
voidexecuteChildTemplates(ElemTemplateElement elem, boolean shouldAddAttrs)
Execute each of the children of a template element.
voidexecuteChildTemplates(ElemTemplateElement elem, ContentHandler handler)
Execute each of the children of a template element.
voidexecuteFromSnapshot(TransformSnapshot ts)
This will execute the following XSLT instructions from the snapshot point, after the stylesheet execution context has been reset from the snapshot point.
ObjectextFunction(String ns, String funcName, Vector argVec, Object methodKey)
ObjectextFunction(FuncExtFunction extFunction, Vector argVec)
voidfireGenerateEvent(int eventType, char[] ch, int start, int length)
Fire off characters, cdate events.
voidfireGenerateEvent(int eventType, String name, Attributes atts)
Fire off startElement, endElement events.
voidfireGenerateEvent(int eventType, String name, String data)
Fire off processingInstruction events.
voidfireGenerateEvent(int eventType, String data)
Fire off comment and entity ref events.
voidfireGenerateEvent(int eventType)
Fire off startDocument, endDocument events.
booleanfunctionAvailable(String ns, String funcName)
StringgetBaseURLOfSource()
Get the base URL of the source.
ContentHandlergetContentHandler()
Get the content event handler.
DTMIteratorgetContextNodeList()
Get the current context node list.
CountersTablegetCountersTable()
Get the table of counters, for optimized xsl:number support.
ElemTemplateElementgetCurrentElement()
Retrieves the current ElemTemplateElement that is being executed.
intgetCurrentNode()
This method retrieves the current context node in the source tree.
ElemTemplategetCurrentTemplate()
This method retrieves the xsl:template that is in effect, which may be a matched template or a named template.
ObjectStackgetCurrentTemplateElements()
Get the count of how many elements are active.
intgetCurrentTemplateElementsCount()
Get the count of how many elements are active.
booleangetDebug()
VectorgetElementCallstack()
Get the stack of ElemTemplateElements.
ErrorListenergetErrorListener()
Get the current error event handler.
ExceptiongetExceptionThrown()
Get the exception thrown by the secondary thread (normally the transform thread).
ExtensionsTablegetExtensionsTable()
Get the extensions table object.
booleangetFeature(String name)
Look up the value of a feature.
booleangetIncremental()
ContentHandlergetInputContentHandler()
Get a SAX2 ContentHandler for the input.
ContentHandlergetInputContentHandler(boolean doDocFrag)
Get a SAX2 ContentHandler for the input.
DeclHandlergetInputDeclHandler()
Get a SAX2 DeclHandler for the input.
LexicalHandlergetInputLexicalHandler()
Get a SAX2 LexicalHandler for the input.
KeyManagergetKeyManager()
Get the KeyManager object.
intgetMatchedNode()
Retrieves the node in the source tree that matched the template obtained via getMatchedTemplate().
ElemTemplategetMatchedTemplate()
This method retrieves the xsl:template that was matched.
QNamegetMode()
NEEDSDOC Method getMode NEEDSDOC (getMode) @return
MsgMgrgetMsgMgr()
Return the message manager.
booleangetOptimize()
OutputPropertiesgetOutputFormat()
Get the output properties used for the transformation.
PropertiesgetOutputProperties()
Get a copy of the output properties for the transformation.
StringgetOutputProperty(String qnameString)
Get an output property that is in effect for the transformation.
StringgetOutputPropertyNoDefault(String qnameString)
Get the value of a property, without using the default properties.
ResultgetOutputTarget()
Get the original output target.
ObjectgetParameter(String name)
Get a parameter that was explicitly set with setParameter or setParameters.
booleangetProperty(String property)
getProperty returns the current setting of the property described by the property argument.
booleangetQuietConflictWarnings()
Get quietConflictWarnings property.
intgetRecursionLimit()
Get the recursion limit.
SerializationHandlergetResultTreeHandler()
Get the SerializationHandler object.
SerializationHandlergetSerializationHandler()
Get the SerializationHandler object.
shortgetShouldStripSpace(int elementHandle, DTM dtm)
Test whether whitespace-only text nodes are visible in the logical view of DTM.
TransformSnapshotgetSnapshot()
This will get a snapshot of the current executing context
booleangetSource_location()
StackGuardgetStackGuard()
Get the object used to guard the stack from recursion.
ObjectPoolgetStringWriterPool()
Get the StringWriter pool, so that StringWriter objects may be reused.
StylesheetRootgetStylesheet()
Get the current stylesheet for this processor.
VectorgetTemplateCallstack()
Get the call stack of xsl:template elements.
TraceManagergetTraceManager()
Get an instance of the trace manager for this transformation.
TransformergetTransformer()
Get the TrAX Transformer object in effect.
ThreadgetTransformThread()
Get the thread that the transform process is on.
URIResolvergetURIResolver()
Get an object that will be used to resolve URIs used in document(), etc.
XPathContextgetXPathContext()
Get the XPath context associated with this transformer.
booleanhasTraceListeners()
booleanhasTransformThreadErrorCatcher()
Return true if the transform was initiated from the transform method, otherwise it was probably done from a pure parse events.
voidinit(ToXMLSAXHandler h, Transformer transformer, ContentHandler realHandler)
Initializer method.
booleanisParserEventsOnMain()
Get true if the parser events should be on the main thread, false if not.
booleanisRecursiveAttrSet(ElemAttributeSet attrSet)
Check to see if this is a recursive attribute definition.
booleanisTransformDone()
Tell if the transform method is completed.
ObjectpopCurrentFuncResult()
Pops the result of the currently active EXSLT func:function.
voidpopCurrentMatched()
Pop the elements that were pushed via pushPairCurrentMatched.
voidpopCurrentTemplateRuleIsNull()
Push true if the current template rule is null, false otherwise.
voidpopElemAttributeSet()
Pop the current executing attribute set.
voidpopElemTemplateElement()
Pop the current template element.
voidpopMode()
NEEDSDOC Method popMode
VectorprocessSortKeys(ElemForEach foreach, int sourceNodeContext)
Get the keys for the xsl:sort elements.
voidpushCurrentFuncResult(Object val)
Push a funcion result for the currently active EXSLT func:function.
voidpushCurrentTemplateRuleIsNull(boolean b)
Push true if the current template rule is null, false otherwise.
voidpushElemAttributeSet(ElemAttributeSet attrSet)
Push an executing attribute set, so we can check for recursive attribute definitions.
voidpushElemTemplateElement(ElemTemplateElement elem)
Push the current template element.
voidpushMode(QName mode)
NEEDSDOC Method pushMode NEEDSDOC @param mode
voidpushPairCurrentMatched(ElemTemplateElement template, int child)
Push both the current xsl:template or xsl:for-each onto the stack, along with the child node that was matched.
voidreset()
Reset the state.
voidresetToStylesheet(TransformSnapshot ts)
This will reset the stylesheet execution context from the snapshot point.
voidrun()
Run the transform thread.
voidrunTransformThread(int priority)
Called by SourceTreeHandler to start the transformation in a separate thread NEEDSDOC @param priority
voidrunTransformThread()
Called by this.transform() if isParserEventsOnMain()==false.
static voidrunTransformThread(Runnable runnable)
Called by CoRoutineSAXParser.
voidsetBaseURLOfSource(String base)
Get the base URL of the source.
voidsetContentHandler(ContentHandler handler)
Set the content event handler.
voidsetCurrentElement(ElemTemplateElement e)
Set the top of the current template elements stack.
voidsetDebug(boolean b)
voidsetErrorListener(ErrorListener listener)
Set the error event listener.
voidsetExceptionThrown(Exception e)
Set the exception thrown by the secondary thread (normally the transform thread).
voidsetIsTransformDone(boolean done)
Set if the transform method is completed.
voidsetOutputFormat(OutputProperties oformat)
Set the output properties for the transformation.
voidsetOutputProperties(Properties oformat)
Set the output properties for the transformation.
voidsetOutputProperty(String name, String value)
This method is used to set or override the value of the effective xsl:output attribute values specified in the stylesheet.
voidsetOutputTarget(Result outputTarget)
Set the original output target.
voidsetParameter(String name, String namespace, Object value)
Set a parameter for the templates.
voidsetParameter(String name, Object value)
Set a parameter for the transformation.
voidsetParameters(Properties params)
Set a bag of parameters for the transformation.
voidsetProperty(String property, Object value)
Set a runtime property for this TransformerImpl.
voidsetQuietConflictWarnings(boolean b)
If the quietConflictWarnings property is set to true, warnings about pattern conflicts won't be printed to the diagnostics stream.
voidsetRecursionLimit(int limit)
Set the recursion limit.
voidsetSerializationHandler(SerializationHandler xoh)
voidsetShouldReset(boolean shouldReset)
NEEDSDOC Method setShouldReset NEEDSDOC @param shouldReset
voidsetSourceTreeDocForThread(int doc)
This is just a way to set the document for run().
voidsetStylesheet(StylesheetRoot stylesheetRoot)
Set the stylesheet for this processor.
voidsetTransformThread(Thread t)
Get the thread that the transform process is on.
voidsetURIResolver(URIResolver resolver)
Set an object that will be used to resolve URIs used in document(), etc.
voidsetXMLSource(Source source)
Set the input source for the source tree, which is needed if the parse thread is not the main thread, in order for the parse thread's run method to get to the input source.
voidsetXPathContext(XPathContext xcontext)
Set the execution context for XPath.
voidstopTransformation()
NEEDSDOC Method stopTransformation
voidtransform(Source source)
Process the source tree to SAX parse events.
voidtransform(Source source, boolean shouldRelease)
Process the source tree to SAX parse events.
voidtransform(Source xmlSource, Result outputTarget)
Process the source tree to the output result.
voidtransform(Source xmlSource, Result outputTarget, boolean shouldRelease)
Process the source tree to the output result.
voidtransformNode(int node, Result outputTarget)
Process the source node to the output result, if the processor supports the "http://xml.org/trax/features/dom/input" feature.
voidtransformNode(int node)
Process the source node to the output result, if the processor supports the "http://xml.org/trax/features/dom/input" feature.
inttransformToGlobalRTF(ElemTemplateElement templateParent)
Given a stylesheet element, create a result tree fragment from it's contents.
inttransformToRTF(ElemTemplateElement templateParent)
Given a stylesheet element, create a result tree fragment from it's contents.
StringtransformToString(ElemTemplateElement elem)
Take the contents of a template element, process it, and convert it to a string.
voidwaitTransformThread()
Used by SourceTreeHandler to wait until the transform completes

Constructor Detail

TransformerImpl

public TransformerImpl(StylesheetRoot stylesheet)
Construct a TransformerImpl.

Parameters: stylesheet The root of the stylesheet tree.

Method Detail

applyTemplateToNode

public boolean applyTemplateToNode(ElemTemplateElement xslInstruction, ElemTemplate template, int child)
Given an element and mode, find the corresponding template and process the contents.

Parameters: xslInstruction The calling element. template The template to use if xsl:for-each, current template for apply-imports, or null. child The source context node.

Returns: true if applied a template, false if not.

Throws: TransformerException

UNKNOWN: advanced

clearParameters

public void clearParameters()
Reset the parameters to a null list.

createSerializationHandler

public SerializationHandler createSerializationHandler(Result outputTarget)
Create a result ContentHandler from a Result object, based on the current OutputProperties.

Parameters: outputTarget Where the transform result should go, should not be null.

Returns: A valid ContentHandler that will create the result tree when it is fed SAX events.

Throws: TransformerException

createSerializationHandler

public SerializationHandler createSerializationHandler(Result outputTarget, OutputProperties format)
Create a ContentHandler from a Result object and an OutputProperties.

Parameters: outputTarget Where the transform result should go, should not be null. format The OutputProperties object that will contain instructions on how to serialize the output.

Returns: A valid ContentHandler that will create the result tree when it is fed SAX events.

Throws: TransformerException

currentFuncResultSeen

public boolean currentFuncResultSeen()
Determines whether an EXSLT func:result instruction has been executed for the currently active EXSLT func:function.

Returns: true if and only if a func:result instruction has been executed

currentTemplateRuleIsNull

public boolean currentTemplateRuleIsNull()
Tell if the current template rule is null, i.e. if we are directly within an apply-templates. Used for xsl:apply-imports.

Returns: True if the current template rule is null.

elementAvailable

public boolean elementAvailable(String ns, String elemName)

executeChildTemplates

public void executeChildTemplates(ElemTemplateElement elem, Node context, QName mode, ContentHandler handler)
Execute each of the children of a template element. This method is only for extension use.

Parameters: elem The ElemTemplateElement that contains the children that should execute. NEEDSDOC @param context mode The current mode. handler The ContentHandler to where the result events should be fed.

Throws: TransformerException

UNKNOWN: advanced

executeChildTemplates

public void executeChildTemplates(ElemTemplateElement elem, boolean shouldAddAttrs)
Execute each of the children of a template element.

Parameters: elem The ElemTemplateElement that contains the children that should execute. shouldAddAttrs true if xsl:attributes should be executed.

Throws: TransformerException

UNKNOWN: advanced

executeChildTemplates

public void executeChildTemplates(ElemTemplateElement elem, ContentHandler handler)
Execute each of the children of a template element.

Parameters: elem The ElemTemplateElement that contains the children that should execute. handler The ContentHandler to where the result events should be fed.

Throws: TransformerException

UNKNOWN: advanced

executeFromSnapshot

public void executeFromSnapshot(TransformSnapshot ts)

Deprecated: This is an internal tooling API that nobody seems to be using

This will execute the following XSLT instructions from the snapshot point, after the stylesheet execution context has been reset from the snapshot point.

Parameters: ts The snapshot of where to start execution

Throws: TransformerException

extFunction

public Object extFunction(String ns, String funcName, Vector argVec, Object methodKey)

extFunction

public Object extFunction(FuncExtFunction extFunction, Vector argVec)

fireGenerateEvent

public void fireGenerateEvent(int eventType, char[] ch, int start, int length)
Fire off characters, cdate events.

See Also: (int, char[], int, int)

fireGenerateEvent

public void fireGenerateEvent(int eventType, String name, Attributes atts)
Fire off startElement, endElement events.

See Also: SerializerTrace

fireGenerateEvent

public void fireGenerateEvent(int eventType, String name, String data)
Fire off processingInstruction events.

See Also: SerializerTrace

fireGenerateEvent

public void fireGenerateEvent(int eventType, String data)
Fire off comment and entity ref events.

See Also: SerializerTrace

fireGenerateEvent

public void fireGenerateEvent(int eventType)
Fire off startDocument, endDocument events.

See Also: SerializerTrace

functionAvailable

public boolean functionAvailable(String ns, String funcName)

getBaseURLOfSource

public String getBaseURLOfSource()
Get the base URL of the source.

Returns: The base URL of the source tree, or null.

getContentHandler

public ContentHandler getContentHandler()
Get the content event handler.

Returns: The current content handler, or null if none was set.

See Also: org.xml.sax.XMLReader#getContentHandler

getContextNodeList

public DTMIterator getContextNodeList()
Get the current context node list.

Returns: A reset clone of the context node list.

getCountersTable

public CountersTable getCountersTable()
Get the table of counters, for optimized xsl:number support.

Returns: The CountersTable, never null.

getCurrentElement

public ElemTemplateElement getCurrentElement()
Retrieves the current ElemTemplateElement that is being executed.

Returns: The current ElemTemplateElement that is executing, should not normally be null.

getCurrentNode

public int getCurrentNode()
This method retrieves the current context node in the source tree.

Returns: The current context node (should never be null?).

getCurrentTemplate

public ElemTemplate getCurrentTemplate()
This method retrieves the xsl:template that is in effect, which may be a matched template or a named template.

Please note that the ElemTemplate returned may be a default template, and thus may not have a template defined in the stylesheet.

Returns: The current xsl:template, should not be null.

getCurrentTemplateElements

public ObjectStack getCurrentTemplateElements()
Get the count of how many elements are active.

Returns: The number of active elements on the currentTemplateElements stack.

getCurrentTemplateElementsCount

public int getCurrentTemplateElementsCount()
Get the count of how many elements are active.

Returns: The number of active elements on the currentTemplateElements stack.

getDebug

public boolean getDebug()

getElementCallstack

public Vector getElementCallstack()
Get the stack of ElemTemplateElements.

Returns: A copy of stack that contains the xsl element instructions, the earliest called in index zero, and the latest called in index size()-1.

getErrorListener

public ErrorListener getErrorListener()
Get the current error event handler.

Returns: The current error handler, which should never be null.

getExceptionThrown

public Exception getExceptionThrown()
Get the exception thrown by the secondary thread (normally the transform thread).

Returns: The thrown exception, or null if no exception was thrown.

getExtensionsTable

public ExtensionsTable getExtensionsTable()
Get the extensions table object.

Returns: The extensions table.

getFeature

public boolean getFeature(String name)
Look up the value of a feature.

The feature name is any fully-qualified URI. It is possible for an TransformerFactory to recognize a feature name but to be unable to return its value; this is especially true in the case of an adapter for a SAX1 Parser, which has no way of knowing whether the underlying parser is validating, for example.

Open issues:

Should getFeature be changed to hasFeature?

Keith Visco writes: Should getFeature be changed to hasFeature? It returns a boolean which indicated whether the "state" of feature is "true or false". I assume this means whether or not a feature is supported? I know SAX is using "getFeature", but to me "hasFeature" is cleaner.

Parameters: name The feature name, which is a fully-qualified URI.

Returns: The current state of the feature (true or false).

Throws: org.xml.sax.SAXNotRecognizedException When the TransformerFactory does not recognize the feature name. org.xml.sax.SAXNotSupportedException When the TransformerFactory recognizes the feature name but cannot determine its value at this time. SAXNotRecognizedException SAXNotSupportedException

getIncremental

public boolean getIncremental()

Returns: Incremental flag

getInputContentHandler

public ContentHandler getInputContentHandler()
Get a SAX2 ContentHandler for the input.

Returns: A valid ContentHandler, which should never be null, as long as getFeature("http://xml.org/trax/features/sax/input") returns true.

getInputContentHandler

public ContentHandler getInputContentHandler(boolean doDocFrag)
Get a SAX2 ContentHandler for the input.

Parameters: doDocFrag true if a DocumentFragment should be created as the root, rather than a Document.

Returns: A valid ContentHandler, which should never be null, as long as getFeature("http://xml.org/trax/features/sax/input") returns true.

getInputDeclHandler

public DeclHandler getInputDeclHandler()
Get a SAX2 DeclHandler for the input.

Returns: A valid DeclHandler, which should never be null, as long as getFeature("http://xml.org/trax/features/sax/input") returns true.

getInputLexicalHandler

public LexicalHandler getInputLexicalHandler()
Get a SAX2 LexicalHandler for the input.

Returns: A valid LexicalHandler, which should never be null, as long as getFeature("http://xml.org/trax/features/sax/input") returns true.

getKeyManager

public KeyManager getKeyManager()
Get the KeyManager object.

Returns: A reference to the KeyManager object, which should never be null.

getMatchedNode

public int getMatchedNode()
Retrieves the node in the source tree that matched the template obtained via getMatchedTemplate().

Returns: The matched node that corresponds to the match attribute of the current xsl:template.

getMatchedTemplate

public ElemTemplate getMatchedTemplate()
This method retrieves the xsl:template that was matched. Note that this may not be the same thing as the current template (which may be from getCurrentElement()), since a named template may be in effect.

Returns: The pushed template that was pushed via pushPairCurrentMatched.

getMode

public QName getMode()
NEEDSDOC Method getMode NEEDSDOC (getMode) @return

getMsgMgr

public MsgMgr getMsgMgr()
Return the message manager.

Returns: The message manager, never null.

getOptimize

public boolean getOptimize()

Returns: Optimization flag

getOutputFormat

public OutputProperties getOutputFormat()
Get the output properties used for the transformation.

Returns: the output format that was set by the user, otherwise the output format from the stylesheet.

getOutputProperties

public Properties getOutputProperties()
Get a copy of the output properties for the transformation. These properties will override properties set in the templates with xsl:output.

Note that mutation of the Properties object returned will not effect the properties that the transformation contains.

Returns: A copy of the set of output properties in effect for the next transformation. NEEDSDOC ($objectName$) @return

getOutputProperty

public String getOutputProperty(String qnameString)
Get an output property that is in effect for the transformation. The property specified may be a property that was set with setOutputProperty, or it may be a property specified in the stylesheet. NEEDSDOC @param qnameString

Returns: The string value of the output property, or null if no property was found.

Throws: IllegalArgumentException If the property is not supported.

See Also: javax.xml.transform.OutputKeys

getOutputPropertyNoDefault

public String getOutputPropertyNoDefault(String qnameString)
Get the value of a property, without using the default properties. This can be used to test if a property has been explicitly set by the stylesheet or user. NEEDSDOC @param qnameString

Returns: The value of the property, or null if not found.

Throws: IllegalArgumentException If the property is not supported, and is not namespaced.

getOutputTarget

public Result getOutputTarget()
Get the original output target.

Returns: The Result object used to kick of the transform or null.

getParameter

public Object getParameter(String name)
Get a parameter that was explicitly set with setParameter or setParameters. NEEDSDOC @param name

Returns: A parameter that has been set with setParameter or setParameters, *not* all the xsl:params on the stylesheet (which require a transformation Source to be evaluated).

getProperty

public boolean getProperty(String property)
getProperty returns the current setting of the property described by the property argument. %REVIEW% Obsolete now that source_location is handled in the TransformerFactory?

Parameters: property a String value

Returns: a boolean value

getQuietConflictWarnings

public boolean getQuietConflictWarnings()
Get quietConflictWarnings property. If the quietConflictWarnings property is set to true, warnings about pattern conflicts won't be printed to the diagnostics stream.

Returns: True if this transformer should not report template match conflicts.

getRecursionLimit

public int getRecursionLimit()
Get the recursion limit. Used for infinite loop check. If the value is -1, do not check for infinite loops. Anyone who wants to enable that check should change the value of this variable to be the level of recursion that they want to check. Be careful setting this variable, if the number is too low, it may report an infinite loop situation, when there is none. Post version 1.0.0, we'll make this a runtime feature.

Returns: The limit on recursion, or -1 if no check is to be made.

getResultTreeHandler

public SerializationHandler getResultTreeHandler()
Get the SerializationHandler object.

Returns: The current SerializationHandler, which may not be the main result tree manager.

getSerializationHandler

public SerializationHandler getSerializationHandler()
Get the SerializationHandler object.

Returns: The current SerializationHandler, which may not be the main result tree manager.

getShouldStripSpace

public short getShouldStripSpace(int elementHandle, DTM dtm)
Test whether whitespace-only text nodes are visible in the logical view of DTM. Normally, this function will be called by the implementation of DTM; it is not normally called directly from user code.

Parameters: elementHandle int Handle of the element.

Returns: one of NOTSTRIP, STRIP, or INHERIT.

getSnapshot

public TransformSnapshot getSnapshot()

Deprecated: This is an internal tooling API that nobody seems to be using

This will get a snapshot of the current executing context

Returns: TransformSnapshot object, snapshot of executing context

getSource_location

public boolean getSource_location()

Returns: Source location flag

getStackGuard

public StackGuard getStackGuard()
Get the object used to guard the stack from recursion.

Returns: The StackGuard object, which should never be null.

UNKNOWN: internal

getStringWriterPool

public ObjectPool getStringWriterPool()
Get the StringWriter pool, so that StringWriter objects may be reused.

Returns: The string writer pool, not null.

UNKNOWN: internal

getStylesheet

public final StylesheetRoot getStylesheet()
Get the current stylesheet for this processor.

Returns: The stylesheet that is associated with this transformer.

getTemplateCallstack

public Vector getTemplateCallstack()
Get the call stack of xsl:template elements.

Returns: A copy of stack that contains the xsl:template (ElemTemplate) instructions, the earliest called in index zero, and the latest called in index size()-1.

getTraceManager

public TraceManager getTraceManager()
Get an instance of the trace manager for this transformation. This object can be used to set trace listeners on various events during the transformation.

Returns: A reference to the TraceManager, never null.

getTransformer

public Transformer getTransformer()
Get the TrAX Transformer object in effect.

Returns: This object.

getTransformThread

public Thread getTransformThread()
Get the thread that the transform process is on.

Returns: The thread that the transform process is on, or null.

UNKNOWN: internal

getURIResolver

public URIResolver getURIResolver()
Get an object that will be used to resolve URIs used in document(), etc.

Returns: An object that implements the URIResolver interface, or null.

getXPathContext

public final XPathContext getXPathContext()
Get the XPath context associated with this transformer.

Returns: The XPathContext reference, never null.

hasTraceListeners

public boolean hasTraceListeners()

See Also: hasTraceListeners

hasTransformThreadErrorCatcher

public boolean hasTransformThreadErrorCatcher()
Return true if the transform was initiated from the transform method, otherwise it was probably done from a pure parse events. NEEDSDOC ($objectName$) @return

init

public void init(ToXMLSAXHandler h, Transformer transformer, ContentHandler realHandler)
Initializer method.

Parameters: transformer non-null transformer instance realHandler Content Handler instance

isParserEventsOnMain

public boolean isParserEventsOnMain()
Get true if the parser events should be on the main thread, false if not. Experimental. Can not be set right now.

Returns: true if the parser events should be on the main thread, false if not.

UNKNOWN: experimental

isRecursiveAttrSet

public boolean isRecursiveAttrSet(ElemAttributeSet attrSet)
Check to see if this is a recursive attribute definition.

Parameters: attrSet A non-null ElemAttributeSet reference.

Returns: true if the attribute set is recursive.

isTransformDone

public boolean isTransformDone()
Tell if the transform method is completed.

Returns: True if transformNode has completed, or an exception was thrown.

popCurrentFuncResult

public Object popCurrentFuncResult()
Pops the result of the currently active EXSLT func:function.

Returns: the value of the func:function

popCurrentMatched

public void popCurrentMatched()
Pop the elements that were pushed via pushPairCurrentMatched.

popCurrentTemplateRuleIsNull

public void popCurrentTemplateRuleIsNull()
Push true if the current template rule is null, false otherwise.

popElemAttributeSet

public void popElemAttributeSet()
Pop the current executing attribute set.

popElemTemplateElement

public void popElemTemplateElement()
Pop the current template element.

popMode

public void popMode()
NEEDSDOC Method popMode

processSortKeys

public Vector processSortKeys(ElemForEach foreach, int sourceNodeContext)
Get the keys for the xsl:sort elements. Note: Should this go into ElemForEach?

Parameters: foreach Valid ElemForEach element, not null. sourceNodeContext The current node context in the source tree, needed to evaluate the Attribute Value Templates.

Returns: A Vector of NodeSortKeys, or null.

Throws: TransformerException

UNKNOWN: advanced

pushCurrentFuncResult

public void pushCurrentFuncResult(Object val)
Push a funcion result for the currently active EXSLT func:function.

Parameters: val the result of executing an EXSLT func:result instruction for the current func:function.

pushCurrentTemplateRuleIsNull

public void pushCurrentTemplateRuleIsNull(boolean b)
Push true if the current template rule is null, false otherwise.

Parameters: b True if the we are executing an xsl:for-each (or xsl:call-template?).

pushElemAttributeSet

public void pushElemAttributeSet(ElemAttributeSet attrSet)
Push an executing attribute set, so we can check for recursive attribute definitions.

Parameters: attrSet A non-null ElemAttributeSet reference.

pushElemTemplateElement

public void pushElemTemplateElement(ElemTemplateElement elem)
Push the current template element.

Parameters: elem The current ElemTemplateElement (may be null, and then set via setCurrentElement).

pushMode

public void pushMode(QName mode)
NEEDSDOC Method pushMode NEEDSDOC @param mode

pushPairCurrentMatched

public void pushPairCurrentMatched(ElemTemplateElement template, int child)
Push both the current xsl:template or xsl:for-each onto the stack, along with the child node that was matched. (Note: should this only be used for xsl:templates?? -sb)

Parameters: template xsl:template or xsl:for-each. child The child that was matched.

reset

public void reset()
Reset the state. This needs to be called after a process() call is invoked, if the processor is to be used again.

resetToStylesheet

public void resetToStylesheet(TransformSnapshot ts)

Deprecated: This is an internal tooling API that nobody seems to be using

This will reset the stylesheet execution context from the snapshot point.

Parameters: ts The snapshot of where to start execution

run

public void run()
Run the transform thread.

runTransformThread

public void runTransformThread(int priority)
Called by SourceTreeHandler to start the transformation in a separate thread NEEDSDOC @param priority

runTransformThread

public void runTransformThread()
Called by this.transform() if isParserEventsOnMain()==false. Similar with runTransformThread(), but no priority is set and setTransformThread is not set.

runTransformThread

public static void runTransformThread(Runnable runnable)
Called by CoRoutineSAXParser. Launches the CoroutineSAXParser in a thread, and prepares it to invoke the parser from that thread upon request.

setBaseURLOfSource

public void setBaseURLOfSource(String base)
Get the base URL of the source. NEEDSDOC @param base

Returns: The base URL of the source tree, or null.

setContentHandler

public void setContentHandler(ContentHandler handler)
Set the content event handler. NEEDSDOC @param handler

Throws: java.lang.NullPointerException If the handler is null.

See Also: org.xml.sax.XMLReader#setContentHandler

setCurrentElement

public void setCurrentElement(ElemTemplateElement e)
Set the top of the current template elements stack.

Parameters: e The current ElemTemplateElement about to be executed.

setDebug

public void setDebug(boolean b)

setErrorListener

public void setErrorListener(ErrorListener listener)
Set the error event listener.

Parameters: listener The new error listener.

Throws: IllegalArgumentException if

setExceptionThrown

public void setExceptionThrown(Exception e)
Set the exception thrown by the secondary thread (normally the transform thread).

Parameters: e The thrown exception, or null if no exception was thrown.

setIsTransformDone

public void setIsTransformDone(boolean done)
Set if the transform method is completed.

Parameters: done True if transformNode has completed, or an exception was thrown.

setOutputFormat

public void setOutputFormat(OutputProperties oformat)
Set the output properties for the transformation. These properties will override properties set in the templates with xsl:output.

Parameters: oformat A valid OutputProperties object (which will not be mutated), or null.

setOutputProperties

public void setOutputProperties(Properties oformat)
Set the output properties for the transformation. These properties will override properties set in the templates with xsl:output.

If argument to this function is null, any properties previously set will be removed.

Parameters: oformat A set of output properties that will be used to override any of the same properties in effect for the transformation.

Throws: IllegalArgumentException if any of the argument keys are not recognized and are not namespace qualified.

See Also: javax.xml.transform.OutputKeys java.util.Properties

setOutputProperty

public void setOutputProperty(String name, String value)
This method is used to set or override the value of the effective xsl:output attribute values specified in the stylesheet.

The recognized standard output properties are:

For example:

   tran.setOutputProperty("standalone", "yes");
 

In the case of the cdata-section-elements property, the value should be a whitespace separated list of element names. The element name is the local name of the element, if it is in no namespace, or, the URI in braces followed immediately by the local name if the element is in that namespace. For example:

 tran.setOutputProperty(
   "cdata-section-elements", 
   "elem1 {http://example.uri}elem2 elem3");
 

The recognized Xalan extension elements are:

These must be in the extension namespace of "http://xml.apache.org/xalan". This is accomplished by putting the namespace URI in braces before the property name, for example:

   tran.setOutputProperty(
     "{http://xml.apache.org/xalan}line-separator" ,
     "\n");
 

Parameters: name The property name. value The requested value for the property.

Throws: IllegalArgumentException if the property name is not legal.

setOutputTarget

public void setOutputTarget(Result outputTarget)
Set the original output target. This is useful when using a SAX transform and supplying a ContentHandler or when the URI of the output target should not be the same as the systemID of the original output target. NEEDSDOC @param outputTarget

setParameter

public void setParameter(String name, String namespace, Object value)
Set a parameter for the templates.

Parameters: name The name of the parameter. namespace The namespace of the parameter. value The value object. This can be any valid Java object -- it's up to the processor to provide the proper coersion to the object, or simply pass it on for use in extensions.

setParameter

public void setParameter(String name, Object value)
Set a parameter for the transformation.

Parameters: name The name of the parameter, which may have a namespace URI. value The value object. This can be any valid Java object -- it's up to the processor to provide the proper coersion to the object, or simply pass it on for use in extensions.

setParameters

public void setParameters(Properties params)
Set a bag of parameters for the transformation. Note that these will not be additive, they will replace the existing set of parameters. NEEDSDOC @param params

setProperty

public void setProperty(String property, Object value)
Set a runtime property for this TransformerImpl. %REVIEW% Obsolete now that source_location is handled in the TransformerFactory?

Parameters: property a String value value an Object value

setQuietConflictWarnings

public void setQuietConflictWarnings(boolean b)
If the quietConflictWarnings property is set to true, warnings about pattern conflicts won't be printed to the diagnostics stream. False by default. (Currently setting this property will have no effect.)

Parameters: b true if conflict warnings should be suppressed.

setRecursionLimit

public void setRecursionLimit(int limit)
Set the recursion limit. Used for infinite loop check. If the value is -1, do not check for infinite loops. Anyone who wants to enable that check should change the value of this variable to be the level of recursion that they want to check. Be careful setting this variable, if the number is too low, it may report an infinite loop situation, when there is none. Post version 1.0.0, we'll make this a runtime feature.

Parameters: limit A number that represents the limit of recursion, or -1 if no checking is to be done.

setSerializationHandler

public void setSerializationHandler(SerializationHandler xoh)

setShouldReset

public void setShouldReset(boolean shouldReset)
NEEDSDOC Method setShouldReset NEEDSDOC @param shouldReset

setSourceTreeDocForThread

public void setSourceTreeDocForThread(int doc)
This is just a way to set the document for run().

Parameters: doc A non-null reference to the root of the tree to be transformed.

setStylesheet

public void setStylesheet(StylesheetRoot stylesheetRoot)
Set the stylesheet for this processor. If this is set, then the process calls that take only the input .xml will use this instead of looking for a stylesheet PI. Also, setting the stylesheet is needed if you are going to use the processor as a SAX ContentHandler.

Parameters: stylesheetRoot A non-null StylesheetRoot object, or null if you wish to clear the stylesheet reference.

setTransformThread

public void setTransformThread(Thread t)
Get the thread that the transform process is on.

Parameters: t The transform thread, may be null.

UNKNOWN: internal

setURIResolver

public void setURIResolver(URIResolver resolver)
Set an object that will be used to resolve URIs used in document(), etc.

Parameters: resolver An object that implements the URIResolver interface, or null.

setXMLSource

public void setXMLSource(Source source)
Set the input source for the source tree, which is needed if the parse thread is not the main thread, in order for the parse thread's run method to get to the input source.

Parameters: source The input source for the source tree.

setXPathContext

public void setXPathContext(XPathContext xcontext)
Set the execution context for XPath.

Parameters: xcontext A non-null reference to the XPathContext associated with this transformer.

UNKNOWN: internal

stopTransformation

public void stopTransformation()
NEEDSDOC Method stopTransformation

transform

public void transform(Source source)
Process the source tree to SAX parse events.

Parameters: source The input for the source tree.

Throws: TransformerException

transform

public void transform(Source source, boolean shouldRelease)
Process the source tree to SAX parse events.

Parameters: source The input for the source tree. shouldRelease Flag indicating whether to release DTMManager.

Throws: TransformerException

transform

public void transform(Source xmlSource, Result outputTarget)
Process the source tree to the output result.

Parameters: xmlSource The input for the source tree. outputTarget The output source target.

Throws: TransformerException

transform

public void transform(Source xmlSource, Result outputTarget, boolean shouldRelease)
Process the source tree to the output result.

Parameters: xmlSource The input for the source tree. outputTarget The output source target. shouldRelease Flag indicating whether to release DTMManager.

Throws: TransformerException

transformNode

public void transformNode(int node, Result outputTarget)
Process the source node to the output result, if the processor supports the "http://xml.org/trax/features/dom/input" feature. %REVIEW% Do we need a Node version of this?

Parameters: node The input source node, which can be any valid DTM node. outputTarget The output source target.

Throws: TransformerException

transformNode

public void transformNode(int node)
Process the source node to the output result, if the processor supports the "http://xml.org/trax/features/dom/input" feature. %REVIEW% Do we need a Node version of this?

Parameters: node The input source node, which can be any valid DTM node.

Throws: TransformerException

transformToGlobalRTF

public int transformToGlobalRTF(ElemTemplateElement templateParent)
Given a stylesheet element, create a result tree fragment from it's contents. The fragment will also use the shared DTM system, but will obtain its space from the global variable pool rather than the dynamic variable stack. This allows late binding of XUnresolvedVariables without the risk that their content will be discarded when the variable stack is popped.

Parameters: templateParent The template element that holds the fragment.

Returns: the NodeHandle for the root node of the resulting RTF.

Throws: TransformerException

UNKNOWN: advanced

transformToRTF

public int transformToRTF(ElemTemplateElement templateParent)
Given a stylesheet element, create a result tree fragment from it's contents. The fragment will be built within the shared RTF DTM system used as a variable stack.

Parameters: templateParent The template element that holds the fragment.

Returns: the NodeHandle for the root node of the resulting RTF.

Throws: TransformerException

UNKNOWN: advanced

transformToString

public String transformToString(ElemTemplateElement elem)
Take the contents of a template element, process it, and convert it to a string.

Parameters: elem The parent element whose children will be output as a string.

Returns: The stringized result of executing the elements children.

Throws: TransformerException

UNKNOWN: advanced

waitTransformThread

public void waitTransformThread()
Used by SourceTreeHandler to wait until the transform completes

Throws: SAXException

Copyright B) 2005 Apache XML Project. All Rights Reserved.