com.icl.saxon.style
Class StyleElement

java.lang.Object
  |
  +--com.icl.saxon.tree.NodeImpl
        |
        +--com.icl.saxon.tree.ParentNodeImpl
              |
              +--com.icl.saxon.tree.ElementImpl
                    |
                    +--com.icl.saxon.tree.ElementWithAttributes
                          |
                          +--com.icl.saxon.style.StyleElement
All Implemented Interfaces:
org.w3c.dom.Element, ElementInfo, org.xml.sax.Locator, org.w3c.dom.NamedNodeMap, org.w3c.dom.Node, NodeInfo
Direct Known Subclasses:
AbsentExtensionElement, LiteralResultElement, SAXONDoctype, SAXONEntityRef, SAXONFunction, SAXONItem, SAXONOutput, SAXONPreview, SAXONWhile, SQLConnect, SQLInsert, XSLApplyImports, XSLApplyTemplates, XSLAttribute, XSLAttributeSet, XSLCallTemplate, XSLChoose, XSLComment, XSLCopy, XSLCopyOf, XSLDecimalFormat, XSLElement, XSLFallback, XSLForEach, XSLGeneralIncorporate, XSLGeneralVariable, XSLIf, XSLKey, XSLMessage, XSLNamespaceAlias, XSLNumber, XSLOtherwise, XSLOutput, XSLPreserveSpace, XSLProcessingInstruction, XSLSort, XSLStyleSheet, XSLTemplate, XSLText, XSLValueOf, XSLWhen

public abstract class StyleElement
extends ElementWithAttributes
implements org.xml.sax.Locator

Abstract superclass for all element nodes in the stylesheet.
Note: this class implements Locator. The element retains information about its own location in the stylesheet, which is useful when an XSL error is found.


Field Summary
protected  java.util.Vector attributeSets
           
protected  org.xml.sax.SAXException validationError
           
protected  java.lang.String version
           
 
Fields inherited from class com.icl.saxon.tree.ElementWithAttributes
attributeList, namespaceList
 
Fields inherited from class com.icl.saxon.tree.ElementImpl
emptyArray, emptyEnumeration, index, nameCode, parent, root, sequence
 
Fields inherited from interface com.icl.saxon.om.NodeInfo
ATTRIBUTE, COMMENT, ELEMENT, NAMESPACE, NODE, NODE_TYPE_NAMES, NONE, NUMBER_OF_TYPES, PI, ROOT, TEXT
 
Fields inherited from interface org.w3c.dom.Node
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
 
Constructor Summary
StyleElement()
          Constructor creates an empty attribute list
 
Method Summary
 Binding bindVariable(int fingerprint)
          Bind a variable used in this element to the XSLVariable element in which it is declared
 void checkEmpty()
          Convenience method to check that the stylesheet element is empty
 void checkNotTopLevel()
          Convenience method to check that the stylesheet element is not at the top level
 void checkTopLevel()
          Convenience method to check that the stylesheet element is at the top level
protected  void checkUnknownAttribute(int nc)
          Check whether an unknown attribute is permitted.
 void checkWithinTemplate()
          Check that the stylesheet element is within a template body
protected  boolean definesExcludedNamespace(short uriCode)
          Check whether this node excludes a particular namespace from the result.
protected  boolean definesExtensionElement(short uriCode)
          Check whether a particular extension element namespace is defined on this node.
 java.lang.String expandChildren(Context context)
          Expand the stylesheet elements subordinate to this one, returning the result as a string.
protected  void fallbackProcessing(StyleElement instruction, Context context)
          Perform fallback processing
protected  void findAttributeSets(java.lang.String use)
          Determine the list of attribute-sets associated with this element.
 boolean forwardsCompatibleModeIsEnabled()
          Determine whether forwards-compatible mode is enabled for this element
 int getColumnNumber()
          needed to satisfy Locator interface
 XSLStyleSheet getContainingStyleSheet()
          Get the containing XSLStyleSheet element
 int getPrecedence()
          Get the import precedence of this stylesheet element.
 PreparedStyleSheet getPreparedStyleSheet()
          Get the PreparedStyleSheet object.
protected  XSLStyleSheet getPrincipalStyleSheet()
          Get the principal XSLStyleSheet node.
 StandardNames getStandardNames()
          Get the StandardNames object
 Function getStyleSheetFunction(int fingerprint)
          Get a Function declared using a saxon:function element in the stylesheet
 Binding getVariableBinding(int fprint)
          Bind a variable used in this element to the XSLVariable element in which it is declared
 java.util.Enumeration[] getVariableNames()
          List the variables that are in scope for this stylesheet element.
 java.lang.String getVersion()
          Get the version number on this element, or inherited from its ancestors
protected  Expression handleSortKeys(Expression select)
          Modify the "select" expression to include any sort keys specified.
 boolean isExcludedNamespace(short uriCode)
          Check whether a namespace uri defines an namespace excluded from the result.
 boolean isExtensionNamespace(short uriCode)
          Check whether a namespace uri defines an extension element.
 boolean isInstruction()
          Determine whether this node is an instruction.
 boolean isTopLevel()
          Test whether this is a top-level element
 Expression makeAttributeValueTemplate(java.lang.String expression)
          Make an attribute value template in the context of this stylesheet element
 Expression makeExpression(java.lang.String expression)
          Make an expression in the context of this stylesheet element
 Pattern makePattern(java.lang.String pattern)
          Make a pattern in the context of this stylesheet element
 boolean mayContainTemplateBody()
          Determine whether this type of element is allowed to contain a template-body
abstract  void prepareAttributes()
          Set the attribute list for the element.
 void preprocess()
          Default preprocessing method does nothing.
abstract  void process(Context context)
          Process: called to do the real work of this stylesheet element.
 void processAllAttributes()
          Process the attributes of this element and all its children
 void processAttributes()
          Process the attribute list for the element.
protected  void processAttributeSets(Context context)
          Expand the attribute sets referenced in this element's use-attribute-sets attribute
 void processChildren(Context context)
          Process the children of this node in the stylesheet
protected  void processExcludedNamespaces(int nc)
          Process the [xsl:]exclude-result-prefixes attribute if there is one
protected  void processExtensionElementAttribute(int nc)
          Process the [xsl:]extension-element-prefixes attribute if there is one
protected  void processVersionAttribute(int nc)
          Process the [xsl:]version attribute if there is one
 void reportAbsence(java.lang.String attribute)
          Convenience method to report the absence of a mandatory attribute
protected  void setValidationError(org.xml.sax.SAXException reason)
          Set a validation error
protected  org.xml.sax.SAXException styleError(org.xml.sax.SAXException error)
          Construct an exception with diagnostic information
protected  org.xml.sax.SAXException styleError(java.lang.String message)
           
 void substituteFor(StyleElement temp)
          Make this node a substitute for a temporary one previously added to the tree.
 void validate()
          Check that the element is valid.
 void validateSubtree()
          Recursive walk through the stylesheet to validate all nodes
 
Methods inherited from class com.icl.saxon.tree.ElementWithAttributes
addNamespaceNodes, copy, getAttribute, getAttributeList, getAttributeNode, getAttributeNodeNS, getAttributeNS, getAttributes, getAttributeValue, getAttributeValue, getAttributeValue, getLength, getNamedItem, getNamedItemNS, getPrefixForURI, getURICodeForPrefix, hasAttribute, hasAttributeNS, hasAttributes, initialise, item, makeAttributeNode, makeAttributeNodeFS, outputNamespaceNodes, removeAttribute, removeAttributeNode, removeAttributeNS, removeNamedItem, removeNamedItemNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setNamedItem, setNamedItemNS, setNamespaceDeclarations
 
Methods inherited from class com.icl.saxon.tree.ElementImpl
addChild, appendChild, cloneNode, compact, copy, copyStringValue, defaultAction, disallowUpdate, dropChildren, enumerateChildren, getAllChildNodes, getAttributeValue, getChildNodes, getDisplayName, getDocumentElement, getDocumentRoot, getElementsByTagName, getElementsByTagNameNS, getFingerprint, getFirstChild, getIndex, getLastChild, getLineNumber, getLocalName, getNameCode, getNamePool, getNamespaceURI, getNextInDocument, getNextSibling, getNodeName, getNodeType, getNodeValue, getNthChild, getNumberOfChildren, getOwnerDocument, getParentNode, getPath, getPrefix, getPreviousInDocument, getPreviousSibling, getPublicId, getSequenceNumber, getSequentialKey, getSystemId, getTagName, getURI, getURICode, getValue, hasChildNodes, insertBefore, isa, isDocumentElement, isSameNode, isSupported, makeNameCode, normalize, removeChild, removeChild, removeNode, renumberChildren, replaceChild, setLineNumber, setNameCode, setNodeValue, setPrefix, toString, useChildrenArray
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.xml.sax.Locator
getLineNumber, getPublicId, getSystemId
 
Methods inherited from interface com.icl.saxon.om.NodeInfo
copy, copyStringValue, defaultAction, enumerateChildren, getAllChildNodes, getDisplayName, getDocumentElement, getDocumentRoot, getFingerprint, getIndex, getLineNumber, getLocalName, getNameCode, getNextInDocument, getNodeName, getNodeType, getNumberOfChildren, getPath, getPrefix, getPreviousInDocument, getSequenceNumber, getSequentialKey, getSystemId, getURI, getURICode, getValue, isDocumentElement, isSameNode
 
Methods inherited from interface org.w3c.dom.Node
appendChild, cloneNode, getChildNodes, getFirstChild, getLastChild, getNamespaceURI, getNextSibling, getNodeValue, getOwnerDocument, getParentNode, getPreviousSibling, hasChildNodes, insertBefore, isSupported, normalize, removeChild, replaceChild, setNodeValue, setPrefix
 
Methods inherited from interface org.w3c.dom.Element
getElementsByTagName, getElementsByTagNameNS, getTagName
 

Field Detail

attributeSets

protected java.util.Vector attributeSets

version

protected java.lang.String version

validationError

protected org.xml.sax.SAXException validationError
Constructor Detail

StyleElement

public StyleElement()
Constructor creates an empty attribute list
Method Detail

substituteFor

public void substituteFor(StyleElement temp)
                   throws org.xml.sax.SAXException
Make this node a substitute for a temporary one previously added to the tree. See StyleNodeFactory for details. "A node like the other one in all things but its class". Note that at this stage, the node will not yet be known to its parent, though it will contain a reference to its parent; and it will have no children.

setValidationError

protected void setValidationError(org.xml.sax.SAXException reason)
Set a validation error

isInstruction

public boolean isInstruction()
Determine whether this node is an instruction. The default implementation says it isn't.

mayContainTemplateBody

public boolean mayContainTemplateBody()
Determine whether this type of element is allowed to contain a template-body

getContainingStyleSheet

public XSLStyleSheet getContainingStyleSheet()
Get the containing XSLStyleSheet element

getPrecedence

public int getPrecedence()
                  throws org.xml.sax.SAXException
Get the import precedence of this stylesheet element.

getStandardNames

public final StandardNames getStandardNames()
                                     throws org.xml.sax.SAXException
Get the StandardNames object

processAllAttributes

public void processAllAttributes()
                          throws org.xml.sax.SAXException
Process the attributes of this element and all its children

processAttributes

public final void processAttributes()
                             throws org.xml.sax.SAXException
Process the attribute list for the element. This is a wrapper method that calls prepareAttributes (provided in the subclass) and traps any exceptions

checkUnknownAttribute

protected void checkUnknownAttribute(int nc)
                              throws org.xml.sax.SAXException
Check whether an unknown attribute is permitted.
Parameters:
nc - The name code of the attribute name

prepareAttributes

public abstract void prepareAttributes()
                                throws org.xml.sax.SAXException
Set the attribute list for the element. This is called to process the attributes (note the distinction from processAttributes in the superclass). Must be supplied in a subclass

makeExpression

public Expression makeExpression(java.lang.String expression)
                          throws org.xml.sax.SAXException
Make an expression in the context of this stylesheet element

makePattern

public Pattern makePattern(java.lang.String pattern)
                    throws org.xml.sax.SAXException
Make a pattern in the context of this stylesheet element

makeAttributeValueTemplate

public Expression makeAttributeValueTemplate(java.lang.String expression)
                                      throws org.xml.sax.SAXException
Make an attribute value template in the context of this stylesheet element

processExtensionElementAttribute

protected void processExtensionElementAttribute(int nc)
                                         throws org.xml.sax.SAXException
Process the [xsl:]extension-element-prefixes attribute if there is one
Parameters:
nc - the name code of the attribute required

processExcludedNamespaces

protected void processExcludedNamespaces(int nc)
                                  throws org.xml.sax.SAXException
Process the [xsl:]exclude-result-prefixes attribute if there is one
Parameters:
nc - the name code of the attribute required

processVersionAttribute

protected void processVersionAttribute(int nc)
                                throws org.xml.sax.SAXException
Process the [xsl:]version attribute if there is one
Parameters:
nc - the name code of the attribute required

getVersion

public java.lang.String getVersion()
                            throws org.xml.sax.SAXException
Get the version number on this element, or inherited from its ancestors

forwardsCompatibleModeIsEnabled

public boolean forwardsCompatibleModeIsEnabled()
                                        throws org.xml.sax.SAXException
Determine whether forwards-compatible mode is enabled for this element

definesExtensionElement

protected boolean definesExtensionElement(short uriCode)
                                   throws org.xml.sax.SAXException
Check whether a particular extension element namespace is defined on this node. This checks this node only, not the ancestor nodes. The implementation checks whether the prefix is included in the [xsl:]extension-element-prefixes attribute.
Parameters:
uriCode - the namespace URI code being tested

isExtensionNamespace

public boolean isExtensionNamespace(short uriCode)
                             throws org.xml.sax.SAXException
Check whether a namespace uri defines an extension element. This checks whether the namespace is defined as an extension namespace on this or any ancestor node.
Parameters:
uriCode - the namespace URI code being tested

definesExcludedNamespace

protected boolean definesExcludedNamespace(short uriCode)
                                    throws org.xml.sax.SAXException
Check whether this node excludes a particular namespace from the result. This method checks this node only, not the ancestor nodes.
Parameters:
uriCode - the code of the namespace URI being tested

isExcludedNamespace

public boolean isExcludedNamespace(short uriCode)
                            throws org.xml.sax.SAXException
Check whether a namespace uri defines an namespace excluded from the result. This checks whether the namespace is defined as an excluded namespace on this or any ancestor node.
Parameters:
uriCode - the code of the namespace URI being tested

validate

public void validate()
              throws org.xml.sax.SAXException
Check that the element is valid. This is called once for each element, after the entire tree has been built. As well as validation, it can perform first-time initialisation. The default implementation does nothing; it is normally overriden in subclasses.

preprocess

public void preprocess()
                throws org.xml.sax.SAXException
Default preprocessing method does nothing. It is implemented for those top-level elements that can be evaluated before the source document is available, for example xsl:key, xsl:attribute-set, xsl:template, xsl:locale

validateSubtree

public void validateSubtree()
                     throws org.xml.sax.SAXException
Recursive walk through the stylesheet to validate all nodes

getPrincipalStyleSheet

protected XSLStyleSheet getPrincipalStyleSheet()
                                        throws org.xml.sax.SAXException
Get the principal XSLStyleSheet node. This gets the principal style sheet, i.e. the one originally loaded, that forms the root of the import/include tree

getPreparedStyleSheet

public PreparedStyleSheet getPreparedStyleSheet()
                                         throws org.xml.sax.SAXException
Get the PreparedStyleSheet object.
Returns:
the PreparedStyleSheet to which this stylesheet element belongs

checkWithinTemplate

public void checkWithinTemplate()
                         throws org.xml.sax.SAXException
Check that the stylesheet element is within a template body
Throws:
org.xml.sax.SAXException - if not within a template body

checkTopLevel

public void checkTopLevel()
                   throws org.xml.sax.SAXException
Convenience method to check that the stylesheet element is at the top level
Throws:
org.xml.sax.SAXException - if not at top level

checkNotTopLevel

public void checkNotTopLevel()
                      throws org.xml.sax.SAXException
Convenience method to check that the stylesheet element is not at the top level
Throws:
org.xml.sax.SAXException - if it is at the top level

checkEmpty

public void checkEmpty()
                throws org.xml.sax.SAXException
Convenience method to check that the stylesheet element is empty
Throws:
org.xml.sax.SAXException - if it is not empty

reportAbsence

public void reportAbsence(java.lang.String attribute)
                   throws org.xml.sax.SAXException
Convenience method to report the absence of a mandatory attribute
Throws:
org.xml.sax.SAXException - if the attribute is missing

process

public abstract void process(Context context)
                      throws org.xml.sax.SAXException
Process: called to do the real work of this stylesheet element. This method must be implemented in each subclass.
Parameters:
context - The context in the source XML document, giving access to the current node, the current variables, etc.

processChildren

public void processChildren(Context context)
                     throws org.xml.sax.SAXException
Process the children of this node in the stylesheet
Parameters:
context - The context in the source XML document, giving access to the current node, the current variables, etc.

fallbackProcessing

protected void fallbackProcessing(StyleElement instruction,
                                  Context context)
                           throws org.xml.sax.SAXException
Perform fallback processing

handleSortKeys

protected Expression handleSortKeys(Expression select)
                             throws org.xml.sax.SAXException
Modify the "select" expression to include any sort keys specified. Used in XSLForEach and XSLApplyTemplates

expandChildren

public java.lang.String expandChildren(Context context)
                                throws org.xml.sax.SAXException
Expand the stylesheet elements subordinate to this one, returning the result as a string. The expansion must not generate any element or attribute nodes.
Parameters:
context - The context in the source document

findAttributeSets

protected void findAttributeSets(java.lang.String use)
                          throws org.xml.sax.SAXException
Determine the list of attribute-sets associated with this element. This is used for xsl:element, xsl:copy, xsl:attribute-set, and on literal result elements

processAttributeSets

protected void processAttributeSets(Context context)
                             throws org.xml.sax.SAXException
Expand the attribute sets referenced in this element's use-attribute-sets attribute

styleError

protected org.xml.sax.SAXException styleError(org.xml.sax.SAXException error)
Construct an exception with diagnostic information

styleError

protected org.xml.sax.SAXException styleError(java.lang.String message)

isTopLevel

public boolean isTopLevel()
                   throws org.xml.sax.SAXException
Test whether this is a top-level element

bindVariable

public Binding bindVariable(int fingerprint)
                     throws org.xml.sax.SAXException
Bind a variable used in this element to the XSLVariable element in which it is declared
Parameters:
fingerprint - The fingerprint of the name of the variable
Returns:
a Binding for the variable

getVariableBinding

public Binding getVariableBinding(int fprint)
                           throws org.xml.sax.SAXException
Bind a variable used in this element to the XSLVariable element in which it is declared
Returns:
a Binding for the variable, or null if it has not been declared

getVariableNames

public java.util.Enumeration[] getVariableNames()
                                         throws org.xml.sax.SAXException
List the variables that are in scope for this stylesheet element. Designed for a debugger, not used by the processor.
Returns:
two Enumeration of Strings, the global ones [0] and the local ones [1]

getStyleSheetFunction

public Function getStyleSheetFunction(int fingerprint)
                               throws org.xml.sax.SAXException
Get a Function declared using a saxon:function element in the stylesheet
Parameters:
fingerprint - the fingerprint of the name of the function
Returns:
the Function object represented by this saxon:function; or null if not found

getColumnNumber

public int getColumnNumber()
needed to satisfy Locator interface
Specified by:
getColumnNumber in interface org.xml.sax.Locator