Xalan-C++ API Documentation
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
[legend]Collaboration diagram for XSLTEngineImpl:
[legend]List of all members.Public Types
Public Methods
- 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. More...
- virtual ~XSLTEngineImpl ()
- virtual void process ( const XSLTInputSource& inputSource, const XSLTInputSource& stylesheetSource, XSLTResultTarget& outputTarget, StylesheetConstructionContext& constructionContext, StylesheetExecutionContext& executionContext)
- Transform the source tree to the output in the given result tree target. More...
- virtual void process ( const XSLTInputSource& inputSource, XSLTResultTarget& outputTarget, StylesheetExecutionContext& executionContext)
- Transform the source tree to the output in the given result tree target. More...
- virtual StylesheetRoot* processStylesheet ( const XSLTInputSource& stylesheetSource, StylesheetConstructionContext& constructionContext)
- Given a stylesheet input source, compile the stylesheet into an internal representation. More...
- virtual StylesheetRoot* processStylesheet ( const XalanDOMString& xsldocURLString, StylesheetConstructionContext& constructionContext)
- Given a URI to an XSL stylesheet, compile the stylesheet into an internal representation. More...
- virtual XalanNode* getSourceTreeFromInput (const XSLTInputSource& inputSource)
- Given an input source, get the source tree. More...
- virtual void outputToResultTree ( StylesheetExecutionContext& executionContext, const XObject& xobj)
- Output an object to the result tree by doing the right conversions. More...
- virtual void resolveTopLevelParams (StylesheetExecutionContext& executionContext)
- Resolve the params that were pushed by the caller.
- virtual XMLParserLiaison& getXMLParserLiaison () const
- Get the XML Parser Liaison that this processor uses. More...
- virtual const XalanDOMString getUniqueNamespaceValue ()
- Generate a random namespace prefix guaranteed to be unique. More...
- virtual void getUniqueNamespaceValue (XalanDOMString& theValue)
- Generate a random namespace prefix guaranteed to be unique. More...
- virtual void setStylesheetParam ( const XalanDOMString& key, const XalanDOMString& expression)
- Push a top-level stylesheet parameter. More...
- virtual void setStylesheetParam ( const XalanDOMString& key, XObjectPtr value)
- Push a top-level stylesheet parameter. More...
- virtual bool shouldStripSourceNode ( XPathExecutionContext& executionContext, const XalanNode& node) const
- 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. More...
- virtual FormatterListener* getFormatterListener () const
- Get the current formatter listener. More...
- virtual void setFormatterListener (FormatterListener* flistener)
- Set the current formatter listener. More...
- virtual unsigned long getTraceListeners () const
- Determine the number of trace listeners. More...
- virtual void addTraceListener (TraceListener* tl)
- Add a trace listener for the purposes of debugging and diagnosis. More...
- virtual void removeTraceListener (TraceListener* tl)
- Remove a trace listener. More...
- virtual void fireGenerateEvent (const GenerateEvent& ge)
- Fire a generate event. More...
- virtual void fireTraceEvent (const TracerEvent& te)
- Fire a trace event. More...
- virtual void fireSelectEvent (const SelectionEvent& se)
- Fire a selection event. More...
- virtual bool getTraceSelects () const
- If this is set to true, simple traces of template calls are made. More...
- virtual void setTraceSelects (bool b)
- virtual void traceSelect ( const XalanElement& theTemplate, const NodeRefListBase& nl) const
- Compose a diagnostic trace of the current selection. More...
- virtual void setQuietConflictWarnings (bool b)
- If the quietConflictWarnings property is set to true, warnings about pattern conflicts won't be printed to the diagnostics stream. More...
- virtual void setDiagnosticsOutput (PrintWriter* pw)
- If this is set, diagnostics will be written to the m_diagnosticsPrintWriter stream. More...
- virtual const XalanDOMString* getNamespaceForPrefix (const XalanDOMString& prefix) const
- Retrieve a namespace corresponding to a prefix. More...
- virtual const XalanDOMString& getURI () const
- Retrieve the base URI for the resolver. More...
- XalanDocument* 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. More...
- XalanDocument* parseXML ( const InputSource& inputSource, DocumentHandler* docHandler, XalanDocument* docToRegister)
- Read in the XML file, either producing a Document or calling SAX events, and register the document in a table. More...
- Stylesheet* 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. More...
- void flushPending ()
- Flush the pending element.
- void addResultNamespaceDecl ( const XalanDOMString& prefix, const XalanDOMString& namespaceVal)
- Add a namespace declaration to the namespace stack. More...
- void 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. More...
- void 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. More...
- virtual void characters ( const XMLCh* const ch, const unsigned int start, const unsigned int length)
- Receive notification of character data. More...
- void characters (const XalanNode& node)
- Send character data from the node to the result tree. More...
- virtual void characters (const XObjectPtr& xobject)
- Send character data from an XObject to the result tree. More...
- virtual void startElement (const XMLCh* const name)
- Receive notification of the beginning of an element with an empty attribute list. More...
- virtual void charactersRaw ( const XMLCh* const ch, const unsigned int start, const unsigned int length)
- Receive notification of character data. More...
- virtual void charactersRaw (const XalanNode& node)
- Send raw character data from the node to the result tree. More...
- virtual void charactersRaw (const XObjectPtr& xobject)
- Send raw character data from an XObject to the result tree. More...
- virtual void comment ( const XMLCh* const data)
- Called when a Comment is to be constructed. More...
- virtual void entityReference ( const XMLCh* const data)
- Receive notification of a entityReference. More...
- virtual void cdata ( const XMLCh* const ch, const unsigned int start, const unsigned int length)
- Receive notification of cdata. More...
- void cloneToResultTree ( XalanNode& node, XalanNode::NodeType nodeType, bool isLiteral, bool overrideStrip, bool shouldCloneAttributes)
- Clone an element with or without children. More...
- void outputResultTreeFragment ( StylesheetExecutionContext& executionContext, const XObject& theTree)
- Given a result tree fragment, walk the tree and output it to the result stream. More...
- virtual const StylesheetRoot* getStylesheetRoot () const
- Retrieve the root stylesheet. More...
- virtual void setStylesheetRoot (const StylesheetRoot* theStylesheet)
- Set the root stylesheet. More...
- virtual void setExecutionContext (StylesheetExecutionContext* theExecutionContext)
- Set the execution context. More...
- int getXSLToken (const XalanNode& node) const
- Given an XSL tag name, return an integer token that corresponds to ELEMNAME_XXX constants defined in Constants.java. More...
- bool getQuietConflictWarnings () const
- Whether to warn about pattern match conflicts. More...
- virtual void message ( const XalanDOMString& msg, const XalanNode* sourceNode = 0, const XalanNode* styleNode = 0) const
- Report a message. More...
- virtual void message ( const XalanDOMString& msg, const XalanNode* sourceNode, const ElemTemplateElement* styleNode) const
- Report a message. More...
- virtual void message ( const char* msg, const XalanNode* sourceNode = 0, const XalanNode* styleNode = 0) const
- Report a message. More...
- virtual void warn ( const XalanDOMString& msg, const XalanNode* sourceNode = 0, const XalanNode* styleNode = 0) const
- Report a warning. More...
- virtual void warn ( const XalanDOMString& msg, const XalanNode* sourceNode, const ElemTemplateElement* styleNode) const
- Report a warning. More...
- virtual void warn ( const char* msg, const XalanNode* sourceNode = 0, const XalanNode* styleNode = 0) const
- Report a warning. More...
- virtual void error ( const XalanDOMString& msg, const XalanNode* sourceNode = 0, const XalanNode* styleNode = 0) const
- Report an error and throw an exception. More...
- virtual void error ( const XalanDOMString& msg, const XalanNode* sourceNode, const ElemTemplateElement* styleNode) const
- Report an error and throw an exception. More...
- virtual void error ( const char* msg, const XalanNode* sourceNode = 0, const XalanNode* styleNode = 0) const
- Report an error, and throw an exception. More...
- void pushTime (const void* key)
- Mark the time, so that displayDuration can later display the elapsed clock ticks. More...
- clock_t popDuration (const void* key)
- Returns the duration since pushTime was called for element in milliseconds. More...
- void displayDuration ( const XalanDOMString& info, const void* key)
- Display the duration since pushTime was called for element in milliseconds, and a descriptive message. More...
- bool doDiagnosticsOutput ()
- Whether diagnostic output is to be generated. More...
- void diag (const XalanDOMString& s) const
- Print a diagnostics string to the output device. More...
- void diag (const char* s) const
- Print a diagnostics string to the output device. More...
- bool isCDataResultElem (const XalanDOMString& elementName) const
- Tell if a given element name should output it's text as cdata. More...
- const XalanDOMString* getResultNamespaceForPrefix (const XalanDOMString& prefix) const
- Retrieve the result namespace corresponding to a prefix. More...
- const XalanDOMString* getResultPrefixForNamespace (const XalanDOMString& theNamespace) const
- Retrieve the result prefix corresponding to a namespace. More...
- bool isPendingResultPrefix (const XalanDOMString& thePrefix) const
- Determine whether or not a prefix is in use on the pending element or the pending attributes. More...
- double evalMatchPatternStr ( const XalanDOMString& str, XalanNode* context, XPathExecutionContext& executionContext)
- Evaluate an xpath string and return the result as a numberic score. More...
- const XPath* createMatchPattern ( const XalanDOMString& str, const PrefixResolver& resolver)
- Create and initialize an xpath and return it. More...
- void returnXPath (const XPath* xpath)
- Return the xpath created by createXPath() or createMatchPattern(). More...
- void copyNamespaceAttributes (const XalanNode& src)
- Copy XMLNS: attributes in if not already in scope. More...
- const XObjectPtr evalXPathStr ( const XalanDOMString& str, XPathExecutionContext& executionContext)
- Evaluate an xpath string and return the result. More...
- const XObjectPtr evalXPathStr ( const XalanDOMString& str, XalanNode* contextNode, const PrefixResolver& prefixResolver, XPathExecutionContext& executionContext)
- Evaluate an xpath string and return the result. More...
- const XObjectPtr evalXPathStr ( const XalanDOMString& str, XalanNode* contextNode, const XalanElement& prefixResolver, XPathExecutionContext& executionContext)
- Evaluate an xpath string and return the result. More...
- void copyAttributeToTarget ( const XalanDOMString& attrName, const XalanDOMString& attrValue, AttributeListImpl& attrList)
- Copy an attribute to an AttributeListImpl. More...
- XPathFactory& getXPathFactory ()
- Get the factory for making xpaths. More...
- XPathProcessor& getXPathProcessor ()
- Get the XPath processor object. More...
- virtual void reset ()
- Reset the state. More...
- virtual XalanDocument* getDOMFactory () const
- Get a DOM document, primarily for creating result tree fragments.
- XPathEnvSupport& getXPathEnvSupport ()
- Retrieve the XPath environment support object. More...
- void setProblemListener (ProblemListener* l)
- Set the problem listener property. More...
- ProblemListener* getProblemListener () const
- Get the problem listener property. More...
- void pushOutputContext (FormatterListener* theListener)
- void popOutputContext ()
- bool getHasPendingStartDocument () const
- void setHasPendingStartDocument (bool b)
- bool getMustFlushPendingStartDocument () const
- void setMustFlushPendingStartDocument (bool b)
- const AttributeList& getPendingAttributes () const
- Get the list of attributes yet to be processed. More...
- void setPendingAttributes (const AttributeList& pendingAttributes)
- Set the list of attributes yet to be processed. More...
- void replacePendingAttribute ( const XalanDOMChar* theName, const XalanDOMChar* theNewType, const XalanDOMChar* theNewValue)
- Replace the contents of a pending attribute. More...
- bool isElementPending () const
- const XalanDOMString& getPendingElementName () const
- Retrieve name of the pending element currently being processed. More...
- void setPendingElementName (const XalanDOMString& elementName)
- Changes the currently pending element name. More...
- void setPendingElementName (const XalanDOMChar* elementName)
- const Locator* getLocatorFromStack () const
- Get the locator from the top of the locator stack. More...
- void pushLocatorOnStack (const Locator* locator)
- Push a locator on to the locator stack. More...
- void popLocatorStack ()
- Pop the locator from the top of the locator stack.
- virtual void setDocumentLocator (const Locator* const locator)
- virtual void startDocument ()
- virtual void endDocument ()
- virtual void startElement ( const XMLCh* const name, AttributeList& atts)
- virtual void endElement ( const XMLCh* const name)
- virtual void characters ( const XMLCh* const chars, const unsigned int length)
- virtual void ignorableWhitespace ( const XMLCh* const ch, const unsigned int length)
- virtual void processingInstruction ( const XMLCh* const target, const XMLCh* const data)
- virtual void resetDocument ()
- void clearTopLevelParams ()
- Reset the vector of top level parameters.
Static Public Methods
Protected Methods
Protected Attributes
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
|
|
Constructor & Destructor Documentation
|
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
|
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 |
|
|
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 |
|
|
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:
-
|
virtual void XSLTEngineImpl::characters (
|
const XMLCh *const chars,
|
|
const unsigned int length ) [virtual]
|
|
void XSLTEngineImpl::characters (
|
const XObjectPtr & xobject ) [virtual]
|
|
|
Send character data from an XObject to the result tree.
-
Parameters:
-
node
|
The xobject to send. |
|
void XSLTEngineImpl::characters (
|
const XalanNode & node )
|
|
|
Send character data from the node to the result tree.
-
Parameters:
-
|
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 XObjectPtr & xobject ) [virtual]
|
|
|
Send raw character data from an XObject to the result tree.
-
Parameters:
-
node
|
The xobject to send. |
|
void XSLTEngineImpl::charactersRaw (
|
const XalanNode & node ) [virtual]
|
|
|
Send raw character data from the node to the result tree.
-
Parameters:
-
|
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:
-
|
void XSLTEngineImpl::clearTopLevelParams (
|
) []
|
|
|
Reset the vector of top level parameters.
|
void XSLTEngineImpl::cloneToResultTree (
|
XalanNode & node,
|
|
XalanNode::NodeType nodeType,
|
|
bool isLiteral,
|
|
bool overrideStrip,
|
|
bool shouldCloneAttributes )
|
|
|
Clone an element with or without children.
-
Parameters:
-
node
|
node to clone |
nodeType
|
the type of the node |
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:
-
|
|
Copy an attribute to an AttributeListImpl.
-
Parameters:
-
attrName
|
The name of the attribute |
attrValue
|
The value of the attribute |
attrList
|
The attribute list added to |
|
|
Copy the attributes from the XSL element to the created output element.
|
void XSLTEngineImpl::copyNamespaceAttributes (
|
const XalanNode & src )
|
|
|
Copy XMLNS: attributes in if not already in scope.
-
Parameters:
-
|
|
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:
-
|
|
Print a diagnostics string to the output device.
-
Parameters:
-
|
void XSLTEngineImpl::displayDuration (
|
const XalanDOMString & info,
|
|
const void * key )
|
|
|
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:
-
|
void XSLTEngineImpl::error (
|
const char * msg,
|
|
const XalanNode * sourceNode = 0,
|
|
const XalanNode * styleNode = 0 ) const [virtual]
|
|
|
Report an error, and throw an exception.
-
Parameters:
-
msg
|
text of message to output |
sourceNode
|
node in source where error occurred |
styleNode
|
node in stylesheet where error occurred |
|
|
Report an error and throw an exception.
-
Parameters:
-
msg
|
text of message to output |
sourceNode
|
node in source where error occurred |
styleNode
|
node in stylesheet where error occurred |
Reimplemented from XSLTProcessor. |
|
Report an error and throw an exception.
-
Parameters:
-
msg
|
text of message to output |
sourceNode
|
node in source where error occurred |
styleNode
|
node in stylesheet where error occurred |
Reimplemented from XSLTProcessor. |
|
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
|
|
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
|
|
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
|
|
Evaluate an xpath string and return the result.
-
Parameters:
-
str
|
string to evaluate |
executionContext
|
current execution context |
-
Returns:
-
pointer to XObject result
|
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:
-
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
|
|
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. |
|
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
|
|
Get the current formatter listener.
-
Returns:
-
pointer to formatter listener
Reimplemented from XSLTProcessor. |
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]
|
|
|
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:
-
-
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
|
|
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
|
|
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
|
|
Retrieve the result namespace corresponding to a prefix.
-
Parameters:
-
prefix
|
prefix for namespace |
-
Returns:
-
string for namespace URI
|
|
Retrieve the result prefix corresponding to a namespace.
-
Parameters:
-
theNamespace
|
namespace for prefix |
-
Returns:
-
string for namespace prefix
|
|
Given an input source, get the source tree.
-
Parameters:
-
inputSource
|
pointer to input source |
-
Returns:
-
source tree
Reimplemented from XSLTProcessor. |
|
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. |
|
Retrieve the base URI for the resolver.
-
Returns:
-
URI string
Reimplemented from PrefixResolver. |
virtual void XSLTEngineImpl::getUniqueNamespaceValue (
|
XalanDOMString & theValue ) [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 (
|
) [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. |
|
Retrieve the XPath environment support object.
-
Returns:
-
XPath environment support object
|
|
Get the factory for making xpaths.
-
Returns:
-
XPath factory object
|
const XalanDOMString & XSLTEngineImpl::getXSLNameSpaceURL (
|
) [static]
|
|
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::isPendingResultPrefix (
|
const XalanDOMString & thePrefix ) const
|
|
|
Determine whether or not a prefix is in use on the pending element or the pending attributes.
-
Parameters:
-
thePrefix
|
prefix for namespace
|
-
Returns:
-
true if the prefix is in use, false if not.
|
void XSLTEngineImpl::message (
|
const char * msg,
|
|
const XalanNode * sourceNode = 0,
|
|
const XalanNode * styleNode = 0 ) const [virtual]
|
|
|
Report a message.
-
Parameters:
-
msg
|
text of message to output |
sourceNode
|
node in source where error occurred |
styleNode
|
node in stylesheet where error occurred |
|
|
Report 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. |
|
Report 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. |
|
Given a result tree fragment, walk the tree and output it to the result stream.
-
Parameters:
-
theTree
|
result tree fragment |
|
|
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. |
|
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:
-
inputSource
|
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:
-
|
|
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:
-
|
clock_t XSLTEngineImpl::popDuration (
|
const void * key )
|
|
|
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 (
|
) []
|
|
|
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:
-
Reimplemented from XSLTProcessor. |
|
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:
-
Reimplemented from XSLTProcessor. |
|
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:
-
Reimplemented from XSLTProcessor. |
|
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:
-
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::pushTime (
|
const void * key )
|
|
|
Mark the time, so that displayDuration can later display the elapsed clock ticks.
-
Parameters:
-
theKey
|
pointer to element to push |
|
virtual void XSLTEngineImpl::removeTraceListener (
|
TraceListener * tl ) [virtual]
|
|
|
Remove a trace listener.
-
Parameters:
-
tl
|
Trace listener to be removed. |
Reimplemented from XSLTProcessor. |
|
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::resetDocument (
|
) [virtual]
|
|
|
Resolve the params that were pushed by the caller.
Reimplemented from XSLTProcessor. |
void XSLTEngineImpl::returnXPath (
|
const XPath * xpath )
|
|
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]
|
|
|
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 |
|
|
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:
-
|
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. |
|
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. |
|
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]
|
|
|
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:
-
-
Exceptions:
-
|
void XSLTEngineImpl::terminate (
|
) [static]
|
|
|
Perform termination of statics.
See class XSLTInit. |
|
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 * sourceNode = 0,
|
|
const XalanNode * styleNode = 0 ) const [virtual]
|
|
|
Report a warning.
-
Parameters:
-
msg
|
text of message to output |
sourceNode
|
node in source where error occurred |
styleNode
|
node in stylesheet where error occurred |
|
|
Report a warning.
-
Parameters:
-
msg
|
text of message to output |
sourceNode
|
node in source where error occurred |
styleNode
|
node in stylesheet where error occurred |
Reimplemented from XSLTProcessor. |
|
Report a warning.
-
Parameters:
-
msg
|
text of message to output |
sourceNode
|
node in source where error occurred |
styleNode
|
node in stylesheet where error occurred |
Reimplemented from XSLTProcessor. |
Member Data Documentation
|
Stack of Booleans to keep track of if we should be outputting cdata instead of escaped text.
|
XalanDocument * XSLTEngineImpl::m_domResultTreeFactory [mutable, protected]
|
|
|
The factory that will be used to create DOM-based result tree fragments.
|
|
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. |
|
The URL that belongs to the result namespace.
|
bool XSLTEngineImpl::m_useDOMResultTreeFactory [protected]
|
|
|
If true, build DOM-based result tree fragments.
|
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.
|
|