Xalan-C++ API Documentation

The Xalan C++ XSL Transformer Version 1.1

Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members  

XSLTEngineImpl Class Reference

It's the responsibility of the XSLTEngineImpl class, collaborating 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. More...

#include <XSLTEngineImpl.hpp>

Inheritance diagram for XSLTEngineImpl

Inheritance graph

[legend]
Collaboration diagram for XSLTEngineImpl:

Collaboration graph

[legend]
List of all members.

Public Types

Public Methods

Static Public Methods

Protected Methods

Protected Attributes

Static Protected Methods


Detailed Description

It's the responsibility of the XSLTEngineImpl class, collaborating 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.

The process method is the primary public entry points.

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


Member Typedef Documentation

typedef std::map<XalanDOMString, int> XSLTEngineImpl::AttributeKeysMapType
 

typedef std::vector<bool> XSLTEngineImpl::BoolVectorType
 

typedef std::map<const void*, clock_t> XSLTEngineImpl::DurationsTableMapType
 

typedef std::map<XalanDOMString, int> XSLTEngineImpl::ElementKeysMapType
 

typedef std::vector<const Locator*> XSLTEngineImpl::LocatorStack
 

typedef StylesheetExecutionContext::ParamVectorType XSLTEngineImpl::ParamVectorType
 

typedef std::vector<TraceListener*> XSLTEngineImpl::TraceListenerVectorType
 

typedef Function::XObjectArgVectorType XSLTEngineImpl::XObjectArgVectorType
 

typedef XalanAutoPtr<XPathProcessor> XSLTEngineImpl::XPathProcessorPtrType
 


Constructor & Destructor Documentation

XSLTEngineImpl::XSLTEngineImpl ( XMLParserLiaison & parserLiaison,
XPathEnvSupport & xpathEnvSupport,
DOMSupport & domSupport,
XObjectFactory & xobjectFactory,
XPathFactory & xpathFactory )
 

Construct an XSL processor that can call back to a XML processor, so it can handle included files, and the like.

You must create a new instance of the XSLTEngineImpl class each time you run a transformation.

Parameters:
XMLParserLiaison   liaison to an object that can help with a specific parser implementation
xpathEnvSupport   An XPathEnvSupport instance
domSupport   A DOMSupport instance for the DOM being used
xobjectFactory   object responsible for XObject objects
xpathFactory   object responsible for XPath objects

virtual XSLTEngineImpl::~XSLTEngineImpl ( ) [virtual]
 


Member Function Documentation

void XSLTEngineImpl::addResultAttribute ( const XalanDOMString & aname,
const XalanDOMString & value ) []
 

Add attribute to pending attributes list, and if it is a namespace, add it to the namespaces stack.

Parameters:
aname   name of attribute
value   value of attribute

void XSLTEngineImpl::addResultAttribute ( AttributeListImpl & attList,
const XalanDOMString & aname,
const XalanDOMString & value )
 

Add attribute to attribute list, and if it is a namespace, add it to the namespaces stack.

Parameters:
attList   attribute list added to
aname   name of attribute
value   value of attribute

void XSLTEngineImpl::addResultNamespaceDecl ( const XalanDOMString & prefix,
const XalanDOMString & namespaceVal )
 

Add a namespace declaration to the namespace stack.

Parameters:
prefix   namespace prefix
namespaceVal   value of namespace

virtual void XSLTEngineImpl::addTraceListener ( TraceListener * tl ) [virtual]
 

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

Parameters:
tl   pointer to listener to add

Reimplemented from XSLTProcessor.

void XSLTEngineImpl::cdata ( const XMLCh *const ch,
const unsigned int start,
const unsigned int length ) [virtual]
 

Receive notification of cdata.

The Parser will call this method to report each chunk of character data. SAX parsers may return all contiguous character data in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity, so that the Locator provides useful information.

The application must not attempt to read from the array outside of the specified range.

Note that some parsers will report whitespace using the ignorableWhitespace() method rather than this one (validating parsers must do so).

Parameters:
ch   pointer to characters from the XML document
start   start position in the array
length   number of characters to read from the array
Exceptions:
SAXException  

virtual void XSLTEngineImpl::characters ( const XMLCh *const chars,
const unsigned int length ) [virtual]
 

void XSLTEngineImpl::characters ( const XMLCh *const ch,
const unsigned int start,
const unsigned int length ) [virtual]
 

Receive notification of character data.

The Parser will call this method to report each chunk of character data. SAX parsers may return all contiguous character data in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity, so that the Locator provides useful information.

The application must not attempt to read from the array outside of the specified range.

Note that some parsers will report whitespace using the ignorableWhitespace() method rather than this one (validating parsers must do so).

NOTE: This method is only provided for compatibility with existing code

Parameters:
ch   pointer to characters from the XML document
start   startng offset in 'ch' array
length   number of characters to read from the array
Deprecated:

void XSLTEngineImpl::charactersRaw ( const XMLCh *const ch,
const unsigned int start,
const unsigned int length ) [virtual]
 

Receive notification of character data.

If available, when the disable-output-escaping attribute is used, output raw text without escaping.

Parameters:
ch   pointer to characters from the XML document
start   start position in the array
length   number of characters to read from the array
Exceptions:
SAXException  

void XSLTEngineImpl::clearTopLevelParams ( ) []
 

Reset the vector of top level parameters.

void XSLTEngineImpl::cloneToResultTree ( XalanNode & node,
bool isLiteral,
bool overrideStrip,
bool shouldCloneAttributes )
 

Clone an element with or without children.

Parameters:
node   node to clone
isLiteral   true if a literal element
overrideStrip   false if white space stripping should be done
shouldCloneAttributes   true if attributes should be cloned

void XSLTEngineImpl::comment ( const XMLCh *const data ) [virtual]
 

Called when a Comment is to be constructed.

Parameters:
data   pointer to comment data
Exceptions:
SAXException  

void XSLTEngineImpl::copyAttributeToTarget ( const XalanAttr & attr,
XalanNode * contextNode,
const Stylesheet * stylesheetTree,
AttributeListImpl & attrList,
const XalanElement & namespaceContext )
 

Copy an attribute to the created output element, executing attribute templates as need be, and processing the 'xsl:use' attribute.

Parameters:
attr   attribute to copy
contextNode   current context node
stylesheetTree   associated stylesheet object
attrList   attribute list added to
namespaceContext   context for namespace
Exceptions:
XSLProcessorException  

void XSLTEngineImpl::copyAttributesToAttList ( XalanNode * contextNode,
const Stylesheet * stylesheetTree,
const XalanElement & templateChild,
AttributeListImpl & attList ) [protected]
 

Copy the attributes from the XSL element to the created output element, executing attribute templates and processing the xsl:use attribute as need be.

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

void XSLTEngineImpl::copyNamespaceAttributes ( const XalanNode & src )
 

Copy XMLNS: attributes in if not already in scope.

Parameters:
src   source node

const XPath * XSLTEngineImpl::createMatchPattern ( const XalanDOMString & str,
const PrefixResolver & resolver )
 

Create and initialize an xpath and return it.

Parameters:
str   string for XPath
resolver   resolver for namespace resolution
Returns:
pointer to XPath created

void XSLTEngineImpl::diag ( const char * s ) const
 

Print a diagnostics string to the output device.

Parameters:
s   string to print

void XSLTEngineImpl::diag ( const XalanDOMString & s ) const
 

Print a diagnostics string to the output device.

Parameters:
s   string to print

void XSLTEngineImpl::displayDuration ( const XalanDOMString & info,
const void * key ) const
 

Display the duration since pushTime was called for element in milliseconds, and a descriptive message.

Parameters:
info   message to display
key   pointer to element involved

bool XSLTEngineImpl::doDiagnosticsOutput ( ) []
 

Whether diagnostic output is to be generated.

Returns:
true for diagnostics output

virtual void XSLTEngineImpl::endDocument ( ) [virtual]
 

virtual void XSLTEngineImpl::endElement ( const XMLCh *const name ) [virtual]
 

void XSLTEngineImpl::entityReference ( const XMLCh *const data ) [virtual]
 

Receive notification of a entityReference.

Parameters:
data   pointer to characters from the XML document
Exceptions:
SAXException  

void XSLTEngineImpl::error ( const char * msg,
const XalanNode * styleNode = 0,
const XalanNode * sourceNode = 0 ) const [virtual]
 

Tell the user of an error, and probably throw an exception.

Parameters:
msg   text of message to output
sourceNode   node in source where error occurred
styleNode   node in stylesheet where error occurred
Exceptions:
XSLProcessorException  

void XSLTEngineImpl::error ( const XalanDOMString & msg,
const XalanNode * styleNode = 0,
const XalanNode * sourceNode = 0 ) const [virtual]
 

Tell the user of an error, and probably throw an exception.

Parameters:
msg   text of message to output
sourceNode   node in source where error occurred
styleNode   node in stylesheet where error occurred
Exceptions:
XSLProcessorException  

Reimplemented from XSLTProcessor.

double XSLTEngineImpl::evalMatchPatternStr ( const XalanDOMString & str,
XalanNode * context,
XPathExecutionContext & executionContext )
 

Evaluate an xpath string and return the result as a numberic score.

Parameters:
str   string to evaluate
context   context node
executionContext   current execution context
Returns:
score number, higher representing better match

const XObjectPtr XSLTEngineImpl::evalXPathStr ( const XalanDOMString & str,
XalanNode * contextNode,
const XalanElement & prefixResolver,
XPathExecutionContext & executionContext )
 

Evaluate an xpath string and return the result.

Parameters:
str   string to evaluate
contextNode   context node
prefixResolver   prefix resolver to use
executionContext   current execution context
Returns:
pointer to XObject result

const XObjectPtr XSLTEngineImpl::evalXPathStr ( const XalanDOMString & str,
XalanNode * contextNode,
const PrefixResolver & prefixResolver,
XPathExecutionContext & executionContext )
 

Evaluate an xpath string and return the result.

Parameters:
str   string to evaluate
contextNode   context node
prefixResolver   prefix resolver to use
executionContext   current execution context
Returns:
pointer to XObject result

const XObjectPtr XSLTEngineImpl::evalXPathStr ( const XalanDOMString & str,
XPathExecutionContext & executionContext )
 

Evaluate an xpath string and return the result.

Parameters:
str   string to evaluate
executionContext   current execution context
Returns:
pointer to XObject result

virtual XalanDOMString XSLTEngineImpl::evaluateAttrVal ( XalanNode * contextNode,
const PrefixResolver & namespaceContext,
const XalanDOMString & stringedValue,
XPathExecutionContext & executionContext ) [virtual]
 

Evaluates attribute values for attribute templates (Stuff in curly {} braces that hold expressions).

Parameters:
contextNode   current node in the source tree
namespaceContext   current namespace context for the pattern-by-example structures when parsing expressions
stringedValue   attribute value to be processed
executionContext   current execution context
Returns:
processed stringedValue with attribute templates resolved
Exceptions:
XSLProcessorException  

Reimplemented from XSLTProcessor.

XalanElement * XSLTEngineImpl::findElementByAttribute ( XalanElement & elem,
const XalanDOMString & targetElementName,
const XalanDOMString & targetAttributeName,
const XalanDOMString & targetAttributeValue ) [static, protected]
 

Given a tag name, an attribute name, and an attribute value, do a very crude recursive search and locate the first match.

virtual void XSLTEngineImpl::fireGenerateEvent ( const GenerateEvent & ge ) [virtual]
 

Fire a generate event.

Parameters:
ge   generate event to fire

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::fireSelectEvent ( const SelectionEvent & se ) [virtual]
 

Fire a selection event.

Parameters:
se   selection event to fire

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::fireTraceEvent ( const TracerEvent & te ) [virtual]
 

Fire a trace event.

Parameters:
te   trace event to fire

Reimplemented from XSLTProcessor.

void XSLTEngineImpl::flushPending ( )
 

Flush the pending element.

int XSLTEngineImpl::getAttrTok ( const XalanDOMString & name ) [static]
 

Given an XSL tag name, return an integer token that corresponds to ELEMNAME_XXX constants defined in Constants.hpp.

Parameters:
name   a probable xsl:xxx element
Returns:
Constants.ELEMNAME_XXX token, -1 if in XSL or Xalan namespace, or -2 if not in known namespace

const AttributeKeysMapType & XSLTEngineImpl::getAttributeKeys ( ) [static]
 

Accessor method for hash table of XSLT IDs for attribute names.

Returns:
hash table of key names and IDs

XalanDocument * XSLTEngineImpl::getDOMFactory ( ) const [virtual]
 

Get a DOM document, primarily for creating result tree fragments.

Reimplemented from XSLTProcessor.

const ElementKeysMapType & XSLTEngineImpl::getElementKeys ( ) [static]
 

Accessor method for hash table of XSLT IDs for element names.

Returns:
hash table of key names and IDs

int XSLTEngineImpl::getElementToken ( const XalanDOMString & name ) [static]
 

Given an XSL tag name, return an integer token that corresponds to ELEMNAME_XXX constants defined in Constants.hpp.

Parameters:
name   a probable xsl:xxx element
Returns:
Constants.ELEMNAME_XXX token, -1 if in XSL or Xalan namespace, or -2 if not in known namespace

virtual FormatterListener* XSLTEngineImpl::getFormatterListener ( ) const [virtual]
 

Get the current formatter listener.

Returns:
pointer to formatter listener

Reimplemented from XSLTProcessor.

FormatterListener * XSLTEngineImpl::getFormatterListenerImpl ( ) const [protected]
 

bool XSLTEngineImpl::getHasPendingStartDocument ( ) const []
 

bool XSLTEngineImpl::getHasPendingStartDocumentImpl ( ) const [protected]
 

const Locator * XSLTEngineImpl::getLocatorFromStack ( ) const []
 

Get the locator from the top of the locator stack.

Returns:
A pointer to the Locator, or 0 if there is nothing on the stack.

bool XSLTEngineImpl::getMustFlushPendingStartDocument ( ) const []
 

bool XSLTEngineImpl::getMustFlushPendingStartDocumentImpl ( ) const [protected]
 

const XalanDOMString & XSLTEngineImpl::getNamespaceForPrefix ( const XalanDOMString & prefix ) const [virtual]
 

Retrieve a namespace corresponding to a prefix.

This assumes that the PrevixResolver hold's its own namespace context, or is a namespace context itself.

Parameters:
prefix   Prefix to resolve
Returns:
namespace that prefix resolves to, or null if prefix is not found

Reimplemented from PrefixResolver.

const AttributeList & XSLTEngineImpl::getPendingAttributes ( ) const []
 

Get the list of attributes yet to be processed.

Returns:
attribute list

AttributeListImpl & XSLTEngineImpl::getPendingAttributesImpl ( ) [protected]
 

Get the list of attributes yet to be processed.

Returns:
attribute list

const AttributeListImpl & XSLTEngineImpl::getPendingAttributesImpl ( ) const [protected]
 

Get the list of attributes yet to be processed.

Returns:
attribute list

const XalanDOMString & XSLTEngineImpl::getPendingElementName ( ) const []
 

Retrieve name of the pending element currently being processed.

Returns:
element name

XalanDOMString & XSLTEngineImpl::getPendingElementNameImpl ( ) [protected]
 

Retrieve name of the pending element currently being processed.

Returns:
element name

const XalanDOMString & XSLTEngineImpl::getPendingElementNameImpl ( ) const [protected]
 

Retrieve name of the pending element currently being processed.

Returns:
element name

ProblemListener * XSLTEngineImpl::getProblemListener ( ) const []
 

Get the problem listener property.

The XSL class can have a single listener that can be informed of errors and warnings, and can normally control if an exception is thrown or not (or the problem listeners can throw their own RuntimeExceptions).

Returns:
pointer to ProblemListener interface

bool XSLTEngineImpl::getQuietConflictWarnings ( ) const []
 

Whether to warn about pattern match conflicts.

Returns:
true to not warn about pattern match conflicts

const XalanDOMString & XSLTEngineImpl::getResultNamespaceForPrefix ( const XalanDOMString & prefix ) const
 

Retrieve the result namespace corresponding to a prefix.

Parameters:
prefix   prefix for namespace
Returns:
string for namespace URI

const XalanDOMString & XSLTEngineImpl::getResultPrefixForNamespace ( const XalanDOMString & theNamespace ) const
 

Retrieve the result prefix corresponding to a namespace.

Parameters:
theNamespace   namespace for prefix
Returns:
string for namespace prefix

XalanNode * XSLTEngineImpl::getSourceNode ( ) const []
 

Returns the current input node that is being processed.

virtual XalanNode* XSLTEngineImpl::getSourceTreeFromInput ( const XSLTInputSource & inputSource ) [virtual]
 

Given an input source, get the source tree.

Parameters:
inputSource   pointer to input source
Returns:
source tree

Reimplemented from XSLTProcessor.

Stylesheet * XSLTEngineImpl::getStylesheetFromPIURL ( const XalanDOMString & xslURLString,
XalanNode & fragBase,
const XalanDOMString & xmlBaseIdent,
bool isRoot,
StylesheetConstructionContext & constructionContext )
 

Reset the state of the XSL processor by reading in a new XSL stylesheet from a processing instruction.

Parameters:
xslURLString   valid URI to an XSL stylesheet
fragBase   base of tree if URI represents document fragment
xmlBaseIdent   base identifier for stylesheet URI
isRoot   true if stylesheet is root of tree
constructionContext   context for construction of object
Returns:
pointer to stylesheet

const StylesheetRoot * XSLTEngineImpl::getStylesheetRoot ( ) const [virtual]
 

Retrieve the root stylesheet.

Returns:
pointer to root stylesheet

Reimplemented from XSLTProcessor.

virtual unsigned long XSLTEngineImpl::getTraceListeners ( ) const [virtual]
 

Determine the number of trace listeners.

Returns:
number of listeners

Reimplemented from XSLTProcessor.

virtual bool XSLTEngineImpl::getTraceSelects ( ) const [virtual]
 

If this is set to true, simple traces of template calls are made.

Returns:
true if traces made

Reimplemented from XSLTProcessor.

const XalanDOMString & XSLTEngineImpl::getURI ( ) const [virtual]
 

Retrieve the base URI for the resolver.

Returns:
URI string

Reimplemented from PrefixResolver.

virtual void XSLTEngineImpl::getUniqueNamespaceValue ( XalanDOMString & theValue ) const [virtual]
 

Generate a random namespace prefix guaranteed to be unique.

Parameters:
theValue   A string for returning the new prefix

Reimplemented from XSLTProcessor.

virtual const XalanDOMString XSLTEngineImpl::getUniqueNamespaceValue ( ) const [virtual]
 

Generate a random namespace prefix guaranteed to be unique.

Returns:
unique namespace prefix

Reimplemented from XSLTProcessor.

virtual XMLParserLiaison& XSLTEngineImpl::getXMLParserLiaison ( ) const [virtual]
 

Get the XML Parser Liaison that this processor uses.

Returns:
XML parser liaison object

Reimplemented from XSLTProcessor.

XPathEnvSupport & XSLTEngineImpl::getXPathEnvSupport ( ) []
 

Retrieve the XPath environment support object.

Returns:
XPath environment support object

XPathFactory & XSLTEngineImpl::getXPathFactory ( ) []
 

Get the factory for making xpaths.

Returns:
XPath factory object

XPathProcessor & XSLTEngineImpl::getXPathProcessor ( ) []
 

Get the XPath processor object.

Returns:
XPathProcessor interface being used

const XalanDOMString & XSLTEngineImpl::getXSLNameSpaceURL ( ) [static]
 

Retrieve the URI for the current XSL namespace, for example, "http://www.w3.org/1999/XSL/Transform".

Returns:
URI string

double XSLTEngineImpl::getXSLTVerSupported ( ) [static]
 

Get the latest XSLT version currently supported.

Returns:
XSLT version number

int XSLTEngineImpl::getXSLToken ( const XalanNode & node ) const
 

Given an XSL tag name, return an integer token that corresponds to ELEMNAME_XXX constants defined in Constants.java.

Parameters:
node   a probable xsl:xxx element.
Returns:
Constants.ELEMNAME_XXX token, -1 if in XSL or Xalan namespace, or -2 if not in known namespace

const XalanDOMString & XSLTEngineImpl::getXalanXSLNameSpaceURL ( ) [static]
 

Special Xalan namespace for built-in extensions.

Returns:
Xalan namespace for extensions

virtual void XSLTEngineImpl::ignorableWhitespace ( const XMLCh *const ch,
const unsigned int length ) [virtual]
 

void XSLTEngineImpl::initialize ( ) [static]
 

Perform initialization of statics -- must be called before any processing occurs.

See class XSLTInit.

bool XSLTEngineImpl::isCDataResultElem ( const XalanDOMString & elementName ) const
 

Tell if a given element name should output it's text as cdata.

Parameters:
elementName   name of element
Returns:
true if it should output as cdata

bool XSLTEngineImpl::isElementPending ( ) const []
 

bool XSLTEngineImpl::isXSLTagOfType ( const XalanNode & node,
int tagType ) const
 

Find the type of an element using this method.

Parameters:
node   a probable xsl:xxx element
tagType   Constants.ELEMNAME_XXX token
Returns:
true if node is of tagType

virtual void XSLTEngineImpl::message ( const char * msg,
const XalanNode * styleNode = 0,
const XalanNode * sourceNode = 0 ) const [virtual]
 

virtual void XSLTEngineImpl::message ( const XalanDOMString & msg,
const XalanNode * styleNode = 0,
const XalanNode * sourceNode = 0 ) const [virtual]
 

Give the user a message.

Parameters:
msg   text of message to output
sourceNode   node in source where message occurred
styleNode   node in stylesheet where message occurred

Reimplemented from XSLTProcessor.

void XSLTEngineImpl::outputResultTreeFragment ( StylesheetExecutionContext & executionContext,
const XObject & theTree )
 

Given a result tree fragment, walk the tree and output it to the result stream.

Parameters:
theTree   result tree fragment

virtual void XSLTEngineImpl::outputToResultTree ( StylesheetExecutionContext & executionContext,
const XObject & xobj ) [virtual]
 

Output an object to the result tree by doing the right conversions.

This is public for access by extensions.

Parameters:
executionContext   current execution context
obj   the XObject to output

Reimplemented from XSLTProcessor.

XalanDocument * XSLTEngineImpl::parseXML ( const XalanDOMString & urlString,
DocumentHandler * docHandler,
XalanDocument * docToRegister )
 

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:
urlString   location of the XML
docHandler   pointer to SAX event handler
docToRegister   if using a SAX event handler, the object to register in the source docs table.
Returns:
document object, which represents the parsed XML
Exceptions:
SAXException  

clock_t XSLTEngineImpl::popDuration ( const void * key ) const
 

Returns the duration since pushTime was called for element in milliseconds.

Parameters:
key   pointer to element involved

void XSLTEngineImpl::popLocatorStack ( ) []
 

Pop the locator from the top of the locator stack.

void XSLTEngineImpl::popOutputContext ( ) []
 

virtual void XSLTEngineImpl::process ( const XSLTInputSource & inputSource,
XSLTResultTarget & outputTarget,
StylesheetExecutionContext & executionContext ) [virtual]
 

Transform the source tree to the output in the given result tree target.

This function does not create a stylesheet tree, it assumes the provided StylesheetExecutionContext has the stylesheet tree to use. This is set by calling StylesheetExecutionContext::setStylesheetRoot().

Parameters:
inputSource   input source
outputTarget   output source tree
executionContext   current execution context
Exceptions:
XSLProcessorException  

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::process ( const XSLTInputSource & inputSource,
const XSLTInputSource & stylesheetSource,
XSLTResultTarget & outputTarget,
StylesheetConstructionContext & constructionContext,
StylesheetExecutionContext & executionContext ) [virtual]
 

Transform the source tree to the output in the given result tree target.

The processor will process the input source, the stylesheet source, and transform to the output target.

Parameters:
inputSource   input source
stylesheetSource   stylesheet source
outputTarget   output source tree
constructionContext   context for construction of objects
executionContext   current execution context
Exceptions:
XSLProcessorException  

Reimplemented from XSLTProcessor.

virtual StylesheetRoot* XSLTEngineImpl::processStylesheet ( const XalanDOMString & xsldocURLString,
StylesheetConstructionContext & constructionContext ) [virtual]
 

Given a URI to an XSL stylesheet, compile the stylesheet into an internal representation.

Parameters:
xmldocURLString   URI to the input XML document
constructionContext   context for construction of objects
Returns:
pointer to compiled stylesheet object
Exceptions:
XSLProcessorException  

Reimplemented from XSLTProcessor.

virtual StylesheetRoot* XSLTEngineImpl::processStylesheet ( const XSLTInputSource & stylesheetSource,
StylesheetConstructionContext & constructionContext ) [virtual]
 

Given a stylesheet input source, compile the stylesheet into an internal representation.

Parameters:
stylesheetSource   input source for the stylesheet
constructionContext   context for construction of objects
Returns:
pointer to the compiled stylesheet object
Exceptions:
XSLProcessorException  

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::processingInstruction ( const XMLCh *const target,
const XMLCh *const data ) [virtual]
 

void XSLTEngineImpl::pushLocatorOnStack ( const Locator * locator ) []
 

Push a locator on to the locator stack.

Parameters:
A   pointer to the Locator to push.

void XSLTEngineImpl::pushOutputContext ( FormatterListener * theListener ) []
 

void XSLTEngineImpl::pushTime ( const void * key ) const
 

Mark the time, so that displayDuration can later display the elapsed clock ticks.

Parameters:
theKey   pointer to element to push

bool XSLTEngineImpl::qnameEqualsResultElemName ( const QName & qname,
const XalanDOMString & elementName ) const
 

Tell if a qualified name equals the current result tree name.

Parameters:
qname   QName to compare to
elementName   current result tree element
Returns:
true if names are the same

virtual void XSLTEngineImpl::removeTraceListener ( TraceListener * tl ) [virtual]
 

Remove a trace listener.

Parameters:
tl   Trace listener to be removed.

Reimplemented from XSLTProcessor.

void XSLTEngineImpl::replacePendingAttribute ( const XalanDOMChar * theName,
const XalanDOMChar * theNewType,
const XalanDOMChar * theNewValue ) []
 

Replace the contents of a pending attribute.

Parameters:
theName   name of attribute
theNewType   type of attribute
theNewValue   new value of attribute

void XSLTEngineImpl::reset ( ) [virtual]
 

Reset the state.

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

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::resetCurrentState ( XalanNode * sourceTree,
XalanNode * xmlNode ) [virtual]
 

Reset the state of execution to node 'xmlNode' in source tree 'sourceTree.'.

Parameters:
sourceTree   source tree for execution
xmlNode   node to execute

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::resetDocument ( ) [virtual]
 

virtual void XSLTEngineImpl::resolveTopLevelParams ( StylesheetExecutionContext & executionContext ) [virtual]
 

Resolve the params that were pushed by the caller.

Reimplemented from XSLTProcessor.

void XSLTEngineImpl::returnXPath ( const XPath * xpath )
 

Return the xpath created by createXPath() or createMatchPattern().

Parameters:
xpath   The XPath to return.

virtual void XSLTEngineImpl::setDiagnosticsOutput ( PrintWriter * pw ) [virtual]
 

If this is set, diagnostics will be written to the m_diagnosticsPrintWriter stream.

If the value is null, then diagnostics will be turned off.

Parameters:
pw   pointer to print writer

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::setDocumentLocator ( const Locator *const locator ) [virtual]
 

void XSLTEngineImpl::setExecutionContext ( StylesheetExecutionContext * theExecutionContext ) [virtual]
 

Set the execution context.

Parameters:
theExecutionContext   pointer to new execution context.

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::setFormatterListener ( FormatterListener * flistener ) [virtual]
 

Set the current formatter listener.

Parameters:
flistener   pointer to new formatter listener

Reimplemented from XSLTProcessor.

void XSLTEngineImpl::setFormatterListenerImpl ( FormatterListener * flistener ) [protected]
 

void XSLTEngineImpl::setHasPendingStartDocument ( bool b ) []
 

void XSLTEngineImpl::setHasPendingStartDocumentImpl ( bool b ) [protected]
 

void XSLTEngineImpl::setMustFlushPendingStartDocument ( bool b ) []
 

void XSLTEngineImpl::setMustFlushPendingStartDocumentImpl ( bool b ) [protected]
 

void XSLTEngineImpl::setPendingAttributes ( const AttributeList & pendingAttributes ) []
 

Set the list of attributes yet to be processed.

Parameters:
pendingAttributes   The attribute list

void XSLTEngineImpl::setPendingAttributesImpl ( const AttributeList & pendingAttributes ) [protected]
 

Set the list of attributes yet to be processed.

Parameters:
pendingAttributes   The attribute list

void XSLTEngineImpl::setPendingElementName ( const XalanDOMChar * elementName ) []
 

void XSLTEngineImpl::setPendingElementName ( const XalanDOMString & elementName ) []
 

Changes the currently pending element name.

Parameters:
elementName   new name of element

void XSLTEngineImpl::setPendingElementNameImpl ( const XalanDOMChar * elementName ) [protected]
 

Changes the currently pending element name.

Parameters:
elementName   new name of element

void XSLTEngineImpl::setPendingElementNameImpl ( const XalanDOMString & elementName ) [protected]
 

Changes the currently pending element name.

Parameters:
elementName   new name of element

void XSLTEngineImpl::setProblemListener ( ProblemListener * l ) []
 

Set the problem listener property.

The XSL class can have a single listener that can be informed of errors and warnings, and can normally control if an exception is thrown or not (or the problem listeners can throw their own RuntimeExceptions).

Parameters:
l   pointer to ProblemListener interface

virtual void XSLTEngineImpl::setQuietConflictWarnings ( bool b ) [virtual]
 

If the quietConflictWarnings property is set to true, warnings about pattern conflicts won't be printed to the diagnostics stream.

True by default.

Parameters:
b   true if conflict warnings should be suppressed.

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::setStylesheetParam ( const XalanDOMString & key,
XObjectPtr value ) [virtual]
 

Push a top-level stylesheet parameter.

This value can be evaluated via xsl:param-variable.

Parameters:
key   name of the parameter
value   XObject value for parameter

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::setStylesheetParam ( const XalanDOMString & key,
const XalanDOMString & expression ) [virtual]
 

Push a top-level stylesheet parameter.

This value can be evaluated via xsl:param-variable.

Parameters:
key   name of the param
expression   expression that will be evaluated

Reimplemented from XSLTProcessor.

void XSLTEngineImpl::setStylesheetRoot ( const StylesheetRoot * theStylesheet ) [virtual]
 

Set the root stylesheet.

Parameters:
theStylesheet   pointer to new root stylesheet

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::setTraceSelects ( bool b ) [virtual]
 

virtual bool XSLTEngineImpl::shouldStripSourceNode ( XPathExecutionContext & executionContext,
const XalanNode & node ) const [virtual]
 

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.

Literal elements from template elements should not be tested with this function.

Parameters:
executionContext   current execution context
node   text node from the source tree
Returns:
true if the text node should be stripped of extra whitespace

$$$ ToDo: This has no business being here in the engine...

Reimplemented from XSLTProcessor.

virtual void XSLTEngineImpl::startDocument ( ) [virtual]
 

virtual void XSLTEngineImpl::startElement ( const XMLCh *const name,
AttributeList & atts ) [virtual]
 

void XSLTEngineImpl::startElement ( const XMLCh *const name ) [virtual]
 

Receive notification of the beginning of an element with an empty attribute list.

Parameters:
name   element type name
Exceptions:
SAXException  

void XSLTEngineImpl::terminate ( ) [static]
 

Perform termination of statics.

See class XSLTInit.

virtual void XSLTEngineImpl::traceSelect ( const XalanElement & theTemplate,
const NodeRefListBase & nl ) const [virtual]
 

Compose a diagnostic trace of the current selection.

Parameters:
theTemplate   current context node
nl   list of selected nodes

Reimplemented from XSLTProcessor.

void XSLTEngineImpl::warn ( const char * msg,
const XalanNode * styleNode = 0,
const XalanNode * sourceNode = 0 ) const [virtual]
 

Tell the user of an warning, and probably throw an exception.

Parameters:
msg   text of message to output
sourceNode   node in source where error occurred
styleNode   node in stylesheet where error occurred
Exceptions:
XSLProcessorException  

void XSLTEngineImpl::warn ( const XalanDOMString & msg,
const XalanNode * styleNode = 0,
const XalanNode * sourceNode = 0 ) const [virtual]
 

Tell the user of an warning, and probably throw an exception.

Parameters:
msg   text of message to output
sourceNode   node in source where error occurred
styleNode   node in stylesheet where error occurred
Exceptions:
XSLProcessorException  

Reimplemented from XSLTProcessor.


Member Data Documentation

BoolVectorType XSLTEngineImpl::m_cdataStack [protected]
 

Stack of Booleans to keep track of if we should be outputting cdata instead of escaped text.

## Optimization: use array stack instead of object stack.

XalanNode * XSLTEngineImpl::m_currentNode [protected]
 

XalanDocument * XSLTEngineImpl::m_domResultTreeFactory [mutable, protected]
 

The factory that will be used to create DOM-based result tree fragments.

bool XSLTEngineImpl::m_outputCarriageReturns [protected]
 

If true, output carriage returns.

bool XSLTEngineImpl::m_outputLinefeeds [protected]
 

If true, output linefeeds.

XalanDOMString XSLTEngineImpl::m_resultNameSpacePrefix [protected]
 

The namespace that the result tree conforms to.

A null value indicates that result-ns is not used and there is no checking. A empty string indicates that the result tree conforms to the default namespace.

XalanDOMString XSLTEngineImpl::m_resultNameSpaceURL [protected]
 

The URL that belongs to the result namespace.

bool XSLTEngineImpl::m_useDOMResultTreeFactory [protected]
 

If true, build DOM-based result tree fragments.

XObjectFactory & XSLTEngineImpl::m_xobjectFactory [protected]
 

XPathFactory & XSLTEngineImpl::m_xpathFactory [protected]
 

XPathProcessorPtrType XSLTEngineImpl::m_xpathProcessor [protected]
 


The documentation for this class was generated from the following file:

Interpreting class diagrams

Doxygen and GraphViz are used to generate this API documentation from the Xalan-C header files.

Xalan-C++ XSL Transformer Version 1.1
Copyright © 2000, 2001 The Apache Software Foundation. All Rights Reserved.