WebLogic Server 6.0sp2 API Reference: Class XSLTEngineImpl

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

BEA Systems, Inc.

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

WebLogic Server 6.0sp2 API Reference

weblogic.apache.xalan.xslt
Class XSLTEngineImpl

java.lang.Object
  |
  +--weblogic.apache.xalan.xslt.XSLTEngineImpl

public class XSLTEngineImpl
extends java.lang.Object
implements XPathEnvSupport, XSLTProcessor

The Xalan workhorse -- Collaborates with the XML parser liaison, the DOM, and the XPath engine, to transform a source tree of nodes into a result tree according to instructions and templates specified by a stylesheet tree. We suggest you use one of the static XSLTProcessorFactory getProcessor() methods to instantiate the processor and return an interface that greatly simplifies the process of manipulating XSLTEngineImpl.

The methods process(...) are the primary public entry points. The best way to perform transformations is to use the XSLTProcessor.process(XSLTInputSource, XSLTInputSource, XSLTResultTarget) method, but you may use any of process methods defined in XSLTEngineImpl.

Please note that this class is not safe per instance over multiple threads. If you are in a multithreaded environment, you should keep a pool of these objects, or create a new one each time. In a multithreaded environment, the right way to do things is to create a StylesheetRoot via processStylesheet, and then reuse this object over multiple threads.

If you reuse the processor instance, you should call reset() between transformations.

This class is based on an implementation from the Apache XML Project. In future releases the XML parser, XSLT processor, and associated classes will likely be updated to be based on a later version of the Apache implementations. Since Apache does not guarantee backwards compatibility between versions of their software, we cannot guarantee backwards compatibility of any of the classes contained in the weblogic.apache package or sub-packages.

Author:: Copyright © 2001 BEA Systems, Inc. All Rights Reserved.
See Also:: XSLTProcessorFactory, XSLTProcessor

Field Summary
`protected org.w3c.dom.Node`	`m_currentNode` The current input element that is being processed.
`protected java.lang.String`	`m_pendingElementName` The pending element.
`protected boolean`	`m_pendingStartDoc` Flag to tell if a StartDocument event is pending.
`static int`	`m_recursionLimit` Used for infinite loop check.
`protected java.util.Stack`	`m_resultNameSpaces` A stack to keep track of the result tree namespaces.

Constructor Summary
`protected`	`XSLTEngineImpl()` Construct an XSLT processor that uses the default DTM (Document Table Model) liaison and XML parser.
	`XSLTEngineImpl(java.lang.String parserLiaisonClassName)` Construct an XSLT processor that uses the the given parser liaison.
	`XSLTEngineImpl(XMLParserLiaison parserLiason)` Construct an XSL processor that uses the the given parser liaison.

Method Summary
`void`	`addTraceListener(TraceListener tl)` Add a trace listener for the purposes of debugging and diagnosis.
`void`	`associateXLocatorToNode(org.w3c.dom.Node node, XLocator xlocator)` Associate an XLocator provider to a node.
`void`	`characters(char[] ch, int start, int length)` Implement the characters event.
`void`	`charactersRaw(char[] ch, int start, int length)` Implement the characters event.
`protected void`	`cloneToResultTree(Stylesheet stylesheetTree, org.w3c.dom.Node node, boolean shouldCloneWithChildren, boolean overrideStrip, boolean shouldCloneAttributes)` Clone an element with or without children.
`void`	`comment(char[] ch, int start, int length)` Report an XML comment anywhere in the document.
`protected void`	`copyAttributesToAttList(org.w3c.dom.Element contextNode, Stylesheet stylesheetTree, MutableAttrListImpl attList)` Copy the attributes from the XSL element to the created output element, executing attribute templates and processing the xsl:use attribute as need be.
`protected void`	`copyAttributeToTarget(org.w3c.dom.Attr attr, org.w3c.dom.Node contextNode, Stylesheet stylesheetTree, MutableAttrListImpl attrList, org.w3c.dom.Element namespaceContext)` Copy an attribute to the created output element, executing attribute templates as need be, and processing the xsl:use attribute.
`XMLParserLiaison`	`createLiaison()` Get a Liaison class, as specified by parserLiaisonClassName property Patch from Costin Manolache
`StylesheetRoot`	`createStylesheetRoot(java.lang.String baseIdentifier)` Bottleneck the creation of the stylesheet for derivation purposes.
`XBoolean`	`createXBoolean(boolean b)` Convenience function to create an XBoolean.
`XMLParserLiaison`	`createXercesLiaison()` Create a Xerces Liaison - used for special handling of DTM Patch from Costin Manolache
`XNodeSet`	`createXNodeSet(org.w3c.dom.Node n)` Convenience function to create an XNodeSet from a node.
`XNodeSet`	`createXNodeSet(org.w3c.dom.NodeList nl)` Convenience function to create an XNodeSet.
`XNull`	`createXNull()` Convenience function to create an XNull.
`XNumber`	`createXNumber(double d)` Convenience function to create an XNumber.
`XObject`	`createXObject(java.lang.Object o)` Convenience function to create an XObject.
`XString`	`createXString(java.lang.String s)` Convenience function to create an XString.
`void`	`deassociateXLocatorToNode(org.w3c.dom.Node node)` Deassociate an XLocator provider to a node.
`protected void`	`diag(java.lang.String s)` Bottleneck output of diagnostics.
`protected void`	`diagnoseTemplateChildren(org.w3c.dom.Node templateChild, org.w3c.dom.Node sourceNode)` Print some diagnostics about the current template child.
`protected void`	`displayDuration(java.lang.String info, java.lang.Object key)` Display the duration since pushTime was called.
`boolean`	`elementAvailable(java.lang.String namespace, java.lang.String extensionName)` Execute the element-available() function.
`void`	`endCDATA()` Report the end of a CDATA section.
`void`	`endDocument()` Implement the endDocument event.
`void`	`endDTD()` Report the end of DTD declarations.
`void`	`endElement(java.lang.String name)` Implement the endElement event.
`void`	`endEntity(java.lang.String name)` Report the end of an entity.
`void`	`error(int msg)` Tell the user of an error, and probably throw an exception.
`void`	`error(int msg, java.lang.Exception e)` Tell the user of an error, and probably throw an exception.
`void`	`error(int msg, java.lang.Object[] args)` Tell the user of an error, and probably throw an exception.
`void`	`error(int msg, java.lang.Object[] args, java.lang.Exception e)` Tell the user of an error, and probably throw an exception.
`void`	`error(org.w3c.dom.Node styleNode, org.w3c.dom.Node sourceNode, int msg)` Tell the user of an error, and probably throw an exception.
`void`	`error(org.w3c.dom.Node styleNode, org.w3c.dom.Node sourceNode, int msg, java.lang.Object[] args)` Tell the user of an error, and probably throw an exception.
`void`	`error(java.lang.String msg)` Tell the user of an error, and probably throw an exception.
`java.lang.Object`	`extFunction(java.lang.String namespace, java.lang.String extensionName, java.util.Vector argVec, java.lang.Object methodKey)` Handle an extension function.
`protected org.w3c.dom.Element`	`findElementByAttribute(org.w3c.dom.Node elem, java.lang.String targetElementName, java.lang.String targetAttributeName, java.lang.String targetAttributeValue)` Given a tag name, an attribute name, and an attribute value, do a very crude recursive search and locate the first match.
`java.lang.String`	`findURIFromDoc(org.w3c.dom.Document doc)` Given a DOM Document, tell what URI was used to parse it.
`protected void`	`flushPending()` Flush the pending element.
`boolean`	`functionAvailable(java.lang.String namespace, java.lang.String extensionName)` Execute the function-available() function.
`StylesheetSpec`	`getAssociatedStylesheet(XSLTInputSource source, java.lang.String media, java.lang.String charset)` Get the preferred InputSource specification that is associated with a given document specified in the source param, via the xml-stylesheet processing instruction (see http://www.w3.org/TR/xml-stylesheet/), and that matches the given criteria.
`java.util.Vector`	`getAssociatedStylesheets(XSLTInputSource source, java.lang.String mediaRequest, java.lang.String charsetRequest)` Get the InputSource specifications that are associated with a given document specified in the source param, via the xml-stylesheet processing instruction (see http://www.w3.org/TR/xml-stylesheet/), and that matches the given criteria.
`org.xml.sax.DocumentHandler`	`getDocumentHandler()` Get the current DocumentHandler.
`org.w3c.dom.Document`	`getDOMFactory()` Get a DOM document, primarily for creating result tree fragments.
`XPathSupport`	`getExecContext()` Get the execution context for XPath.
`org.xml.sax.DocumentHandler`	`getFormatterListener()` Get the current formatter listener.
`org.w3c.dom.NodeList`	`getNodeSetByKey(org.w3c.dom.Node doc, java.lang.String name, java.lang.String ref, PrefixResolver nscontext)` Given a valid element key, return the corresponding node list.
`java.lang.String`	`getOutputFileName()` Get the filename of the output document, if it was set.
`ProblemListener`	`getProblemListener()` Get the problem listener property.
`java.util.Hashtable`	`getSourceDocsTable()` Get table of source tree documents.
`org.w3c.dom.Node`	`getSourceNode()` Returns the current input node that is being processed.
`org.w3c.dom.Node`	`getSourceNode(java.lang.String selectPattern, PrefixResolver namespaceContext)` Returns the current input node that is being processed.
`org.w3c.dom.Node`	`getSourceTreeFromInput(XSLTInputSource inputSource)` Given an input source, get the source tree.
`StylesheetRoot`	`getStylesheet()` Get the current stylesheet for this processor.
`java.lang.String`	`getStyleSheetURIfromDoc(org.w3c.dom.Node sourceTree)` Deprecated.
`java.net.URL`	`getURLFromString(java.lang.String urlString, java.lang.String base)` Take a user string and try and parse XML, and also return the url.
`XObject`	`getVariable(QName qname)` Given a name, locate a variable in the current context, and return the Object.
`XLocator`	`getXLocatorFromNode(org.w3c.dom.Node node)` Get an XLocator provider keyed by node.
`XMLParserLiaison`	`getXMLProcessorLiaison()` Get the XML Parser Liaison that this processor uses.
`void`	`ignorableWhitespace(char[] ch, int start, int length)` Implement the ignorableWhitespace event.
`void`	`message(org.w3c.dom.Node styleNode, org.w3c.dom.Node sourceNode, java.lang.String msg)` Warn the user of an problem.
`void`	`message(java.lang.String msg)` Warn the user of an problem.
`void`	`outputResultTreeFragment(XObject obj, XPathSupport support)` Given a result tree fragment, walk the tree and output it to the result stream.
`void`	`outputToResultTree(Stylesheet stylesheetTree, java.lang.Object obj)` Output an object to the result tree by doing the right conversions.
`org.w3c.dom.Document`	`parseXML(java.net.URL url, org.xml.sax.DocumentHandler docHandler, org.w3c.dom.Document docToRegister)` Read in the XML file, either producing a Document or calling SAX events, and register the document in a table.
`void`	`process(XSLTInputSource inputSource, XSLTInputSource stylesheetSource, XSLTResultTarget outputTarget)` Transform the source tree to the output in the given result tree target.
`void`	`processingInstruction(java.lang.String target, java.lang.String data)` Implement the processingInstruction event.
`StylesheetRoot`	`processStylesheet(java.lang.String xsldocURLString)` Given a URI to an XSL stylesheet, Compile the stylesheet into an internal representation.
`StylesheetRoot`	`processStylesheet(XSLTInputSource stylesheetSource)` Given a URI to an XSL stylesheet, Compile the stylesheet into an internal representation.
`void`	`removeTraceListener(TraceListener tl)` Remove a trace listener.
`void`	`reset()` Reset the state.
`protected void`	`resetCurrentState(org.w3c.dom.Node xmlNode)` Reset the current element state
`void`	`setDiagnosticsOutput(java.io.OutputStream out)` If this is set, diagnostics will be written to the m_diagnosticsPrintWriter stream.
`void`	`setDiagnosticsOutput(java.io.PrintWriter pw)` If this is set, diagnostics will be written to the m_diagnosticsPrintWriter stream.
`void`	`setDocumentHandler(org.xml.sax.DocumentHandler listener)` Set the current DocumentHandler.
`void`	`setDocumentLocator(org.xml.sax.Locator locator)` Implement the setDocumentLocator event.
`void`	`setDOMFactory(org.w3c.dom.Document doc)` Set a DOM document factory, primarily for creating result tree fragments.
`void`	`setExecContext(XMLParserLiaison liaison)` Set the execution context for XPath.
`void`	`setFormatterListener(org.xml.sax.DocumentHandler flistener)` Set the current formatter listener.
`void`	`setOutputFileName(java.lang.String filename)` Set the filename of the output document.
`void`	`setOutputStream(java.io.OutputStream os)` Set the output stream that will be used.
`void`	`setProblemListener(ProblemListener l)` Set the problem listener property.
`void`	`setQuietConflictWarnings(boolean b)` If the quietConflictWarnings property is set to true, warnings about pattern conflicts won't be printed to the diagnostics stream.
`void`	`setSourceDocument(java.lang.String uri, org.w3c.dom.Document doc)` Set a source document.
`void`	`setStylesheet(StylesheetRoot stylesheetRoot)` Set the stylesheet for this processor.
`void`	`setStylesheetParam(java.lang.String key, java.lang.String expression)` Push a top-level stylesheet parameter.
`void`	`setStylesheetParam(java.lang.String key, XObject value)` Push a top-level stylesheet parameter.
`void`	`setTraceSelect(boolean b)` If this is set to true, simple traces of template calls are made.
`void`	`setTraceTemplateChildren(boolean b)` If this is set to true, debug diagnostics about template children as they are being constructed will be written to the m_diagnosticsPrintWriter stream.
`void`	`setTraceTemplates(boolean b)` If this is set to true, simple traces of template calls are made.
`boolean`	`shouldStripSourceNode(org.w3c.dom.Node textNode)` Tells, through the combination of the default-space attribute on xsl:stylesheet, xsl:strip-space, xsl:preserve-space, and the xml:space attribute, whether or not extra whitespace should be stripped from the node.
`void`	`startCDATA()` Report the start of a CDATA section.
`void`	`startDocument()` Implement the startDocument event.
`void`	`startDTD(java.lang.String name, java.lang.String publicId, java.lang.String systemId)` Report the start of DTD declarations, if any.
`void`	`startElement(java.lang.String name, org.xml.sax.AttributeList atts)` Implement the startElement event.
`void`	`startEntity(java.lang.String name)` Report the beginning of an entity.
`protected void`	`traceSelect(org.w3c.dom.Element template, org.w3c.dom.NodeList nl)` Print a trace of a selection being made.
`protected void`	`traceTemplate(org.w3c.dom.Node templateNode)` Print a trace of a template that is being called, either by a match, name, or as part of for-each.
`void`	`warn(int msg)` Warn the user of an problem.
`void`	`warn(int msg, java.lang.Object[] args)` Warn the user of an problem.
`void`	`warn(org.w3c.dom.Node styleNode, org.w3c.dom.Node sourceNode, int msg)` Warn the user of an problem.
`void`	`warn(org.w3c.dom.Node styleNode, org.w3c.dom.Node sourceNode, int msg, java.lang.Object[] args)` Warn the user of an problem.
`void`	`writeChildren(org.xml.sax.DocumentHandler flistener, Stylesheet stylesheetTree, ElemTemplateElement templateParent, org.w3c.dom.Node sourceTree, org.w3c.dom.Node sourceNode, QName mode)` Write the children of a stylesheet element to the given listener.

Methods inherited from class java.lang.Object

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

Field Detail

m_pendingElementName

protected java.lang.String m_pendingElementName

The pending element. We have to delay the call to m_flistener.startElement(name, atts) because of the xsl:attribute and xsl:copy calls. In other words, the attributes have to be fully collected before you can call startElement.

m_pendingStartDoc

protected boolean m_pendingStartDoc

Flag to tell if a StartDocument event is pending.

m_resultNameSpaces

protected java.util.Stack m_resultNameSpaces

A stack to keep track of the result tree namespaces.

m_currentNode

protected org.w3c.dom.Node m_currentNode

The current input element that is being processed.

m_recursionLimit

public static int m_recursionLimit

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.

Constructor Detail

XSLTEngineImpl

protected XSLTEngineImpl()
                  throws org.xml.sax.SAXException

Construct an XSLT processor that uses the default DTM (Document Table Model) liaison and XML parser. As a general rule, you should use XSLTProcessorFactory to create an instance of this class and provide access to the instance via the XSLTProcessor interface.

See Also:: XSLTProcessorFactory, XSLTProcessor

XSLTEngineImpl

public XSLTEngineImpl(java.lang.String parserLiaisonClassName)
               throws org.xml.sax.SAXException

Construct an XSLT processor that uses the the given parser liaison. As a general rule, you should use XSLTProcessorFactory to create an instance of this class and provide access to the instance via the XSLTProcessor interface.

See Also:: XSLTProcessorFactory, XSLTProcessor

XSLTEngineImpl

public XSLTEngineImpl(XMLParserLiaison parserLiason)

Construct an XSL processor that uses the the given parser liaison. As a general rule, you should use XSLTProcessorFactory to create an instance of this class and provide access to the instance via the XSLTProcessor interface.

Parameters:: XMLParserLiaison - A liaison to an XML parser.
See Also:: XMLParserLiaison, XSLTProcessorFactory, XSLTProcessor

Method Detail

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.

Specified by:: reset in interface XSLTProcessor

createLiaison

public XMLParserLiaison createLiaison()
                               throws org.xml.sax.SAXException

Get a Liaison class, as specified by parserLiaisonClassName property Patch from Costin Manolache

createXercesLiaison

public XMLParserLiaison createXercesLiaison()
                                     throws org.xml.sax.SAXException

Create a Xerces Liaison - used for special handling of DTM Patch from Costin Manolache

process

public void process(XSLTInputSource inputSource,
                    XSLTInputSource stylesheetSource,
                    XSLTResultTarget outputTarget)
             throws org.xml.sax.SAXException

Transform the source tree to the output in the given result tree target. As a general rule, we recommend you use the XSLTProcessor#Process(XSLTInputSource, XSLTInputSource, XSLTResultTarget) method.

Specified by:: process in interface XSLTProcessor
Parameters:: inputSource - The input source.; stylesheetSource - The stylesheet source. May be null if source has a xml-stylesheet PI.; outputTarget - The output source tree.
Throws:: XSLProcessorException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.

createStylesheetRoot

public StylesheetRoot createStylesheetRoot(java.lang.String baseIdentifier)
                                    throws java.net.MalformedURLException,
                                           java.io.FileNotFoundException,
                                           java.io.IOException,
                                           org.xml.sax.SAXException

Bottleneck the creation of the stylesheet for derivation purposes.

processStylesheet

public StylesheetRoot processStylesheet(XSLTInputSource stylesheetSource)
                                 throws org.xml.sax.SAXException

Given a URI to an XSL stylesheet, Compile the stylesheet into an internal representation. This calls reset() before processing if the stylesheet root has been set to non-null.

Specified by:: processStylesheet in interface XSLTProcessor
Parameters:: xmldocURLString - The URL to the input XML document.
Returns:: The compiled stylesheet object.
Throws:: XSLProcessorException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.

processStylesheet

public StylesheetRoot processStylesheet(java.lang.String xsldocURLString)
                                 throws org.xml.sax.SAXException

Given a URI to an XSL stylesheet, Compile the stylesheet into an internal representation. This calls reset() before processing if the stylesheet root has been set to non-null.

Specified by:: processStylesheet in interface XSLTProcessor
Parameters:: xmldocURLString - The URL to the input XML document.
Returns:: The compiled stylesheet object.
Throws:: XSLProcessorException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.

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 DocumentHandler.

Specified by:: setStylesheet in interface XSLTProcessor

getStylesheet

public StylesheetRoot getStylesheet()

Get the current stylesheet for this processor.

Specified by:: getStylesheet in interface XSLTProcessor

getOutputFileName

public java.lang.String getOutputFileName()

Get the filename of the output document, if it was set. This is for use by multiple output documents, to determine the base directory for the output document. It needs to be set by the caller.

setOutputFileName

public void setOutputFileName(java.lang.String filename)

Set the filename of the output document. This is for use by multiple output documents, to determine the base directory for the output document. It needs to be set by the caller.

getURLFromString

public java.net.URL getURLFromString(java.lang.String urlString,
                                     java.lang.String base)
                              throws org.xml.sax.SAXException

Take a user string and try and parse XML, and also return the url.

Throws:: XSLProcessorException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.

getSourceTreeFromInput

public org.w3c.dom.Node getSourceTreeFromInput(XSLTInputSource inputSource)
                                        throws org.xml.sax.SAXException

Given an input source, get the source tree.

Specified by:: getSourceTreeFromInput in interface XSLTProcessor

parseXML

public org.w3c.dom.Document parseXML(java.net.URL url,
                                     org.xml.sax.DocumentHandler docHandler,
                                     org.w3c.dom.Document docToRegister)
                              throws org.xml.sax.SAXException,
                                     java.io.IOException

Read in the XML file, either producing a Document or calling SAX events, and register the document in a table. If the document has already been read in, it will not be reparsed.

Parameters:: url - The location of the XML.; docHandler - The SAX event handler.; docToRegister - If using a SAX event handler, the object to register in the source docs table.
Returns:: lcom.ms.xml.om.Document object, which represents the parsed XML.
Throws:: org.xml.sax.SAXException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.

getAssociatedStylesheet

public StylesheetSpec getAssociatedStylesheet(XSLTInputSource source,
                                              java.lang.String media,
                                              java.lang.String charset)
                                       throws org.xml.sax.SAXException

Get the preferred InputSource specification that is associated with a given document specified in the source param, via the xml-stylesheet processing instruction (see http://www.w3.org/TR/xml-stylesheet/), and that matches the given criteria. Does not yet handle the LINK REL="stylesheet" syntax.

Specified by:: getAssociatedStylesheet in interface XSLTProcessor
Parameters:: media - The media attribute to be matched. May be null, in which case the prefered stylesheet will be used (i.e. alternate = no).; title - The value of the title attribute to match. May be null.; charset - The value of the charset attribute to match. May be null.

getAssociatedStylesheets

public java.util.Vector getAssociatedStylesheets(XSLTInputSource source,
                                                 java.lang.String mediaRequest,
                                                 java.lang.String charsetRequest)
                                          throws org.xml.sax.SAXException

Get the InputSource specifications that are associated with a given document specified in the source param, via the xml-stylesheet processing instruction (see http://www.w3.org/TR/xml-stylesheet/), and that matches the given criteria. Does not yet handle the LINK REL="stylesheet" syntax.

Specified by:: getAssociatedStylesheets in interface XSLTProcessor
Parameters:: media - The media attribute to be matched. May be null, in which case the prefered stylesheet will be used (i.e. alternate = no).; title - The value of the title attribute to match. May be null.; charset - The value of the charset attribute to match. May be null.

findURIFromDoc

public java.lang.String findURIFromDoc(org.w3c.dom.Document doc)

Given a DOM Document, tell what URI was used to parse it.

Specified by:: findURIFromDoc in interface XPathEnvSupport

getSourceDocsTable

public java.util.Hashtable getSourceDocsTable()

Get table of source tree documents. Document objects are keyed by URL string.

Specified by:: getSourceDocsTable in interface XPathEnvSupport

setSourceDocument

public void setSourceDocument(java.lang.String uri,
                              org.w3c.dom.Document doc)

Set a source document. Every time a source document is requested through either xsl:uri or in a process call, the processor will first consult table of supplied documents before trying to load and parse the corresponding document from the Net.

outputToResultTree

public void outputToResultTree(Stylesheet stylesheetTree,
                               java.lang.Object obj)
                        throws org.xml.sax.SAXException,
                               java.net.MalformedURLException,
                               java.io.FileNotFoundException,
                               java.io.IOException

Output an object to the result tree by doing the right conversions. This is public for access by extensions.

Parameters:: obj - the Java object to output. If its of an X type then that conversion is done first and then sent out.

functionAvailable

public boolean functionAvailable(java.lang.String namespace,
                                 java.lang.String extensionName)

Execute the function-available() function.

Specified by:: functionAvailable in interface XPathEnvSupport

elementAvailable

public boolean elementAvailable(java.lang.String namespace,
                                java.lang.String extensionName)

Execute the element-available() function.

Specified by:: elementAvailable in interface XPathEnvSupport

extFunction

public java.lang.Object extFunction(java.lang.String namespace,
                                    java.lang.String extensionName,
                                    java.util.Vector argVec,
                                    java.lang.Object methodKey)
                             throws org.xml.sax.SAXException

Handle an extension function.

Specified by:: extFunction in interface XPathEnvSupport

addTraceListener

public void addTraceListener(TraceListener tl)
                      throws java.util.TooManyListenersException

Add a trace listener for the purposes of debugging and diagnosis.

Specified by:: addTraceListener in interface XSLTProcessor
Parameters:: tl - Trace listener to be added.

removeTraceListener

public void removeTraceListener(TraceListener tl)

Remove a trace listener.

Specified by:: removeTraceListener in interface XSLTProcessor
Parameters:: tl - Trace listener to be removed.

message

public void message(java.lang.String msg)
             throws org.xml.sax.SAXException

Warn the user of an problem. This is public for access by extensions.

Throws:: XSLProcessorException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.

message

public void message(org.w3c.dom.Node styleNode,
                    org.w3c.dom.Node sourceNode,
                    java.lang.String msg)
             throws org.xml.sax.SAXException

Warn the user of an problem. This is public for access by extensions.

Throws:: XSLProcessorException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.

warn

public void warn(int msg)
          throws org.xml.sax.SAXException

Warn the user of an problem.

Throws:: XSLProcessorException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.

warn

public void warn(int msg,
                 java.lang.Object[] args)
          throws org.xml.sax.SAXException

Warn the user of an problem.

Throws:: XSLProcessorException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.

warn

public void warn(org.w3c.dom.Node styleNode,
                 org.w3c.dom.Node sourceNode,
                 int msg)
          throws org.xml.sax.SAXException

Warn the user of an problem.

Throws:: XSLProcessorException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.

warn

public void warn(org.w3c.dom.Node styleNode,
                 org.w3c.dom.Node sourceNode,
                 int msg,
                 java.lang.Object[] args)
          throws org.xml.sax.SAXException

Warn the user of an problem.

Throws:: XSLProcessorException - thrown if the active ProblemListener and XMLParserLiaison decide the error condition is severe enough to halt processing.