net.sf.saxon.style
Class LiteralResultElement

java.lang.Object
  extended bynet.sf.saxon.tree.NodeImpl
      extended bynet.sf.saxon.tree.ParentNodeImpl
          extended bynet.sf.saxon.tree.ElementImpl
              extended bynet.sf.saxon.tree.ElementWithAttributes
                  extended bynet.sf.saxon.style.StyleElement
                      extended bynet.sf.saxon.style.LiteralResultElement
All Implemented Interfaces:
Container, FingerprintedNode, InstructionInfo, Item, LocationProvider, org.xml.sax.Locator, NodeInfo, SaxonLocator, javax.xml.transform.Source, javax.xml.transform.SourceLocator, ValueRepresentation

public class LiteralResultElement
extends StyleElement

This class represents a literal result element in the style sheet (typically an HTML element to be output).
It is also used to represent unknown top-level elements, which are ignored.


Field Summary
 
Fields inherited from class net.sf.saxon.style.StyleElement
defaultCollationName, defaultXPathNamespace, extensionNamespaces, REPORT_ALWAYS, REPORT_IF_INSTANTIATED, REPORT_UNLESS_FALLBACK_AVAILABLE, REPORT_UNLESS_FORWARDS_COMPATIBLE, reportingCircumstances, staticContext, validationError, version
 
Fields inherited from class net.sf.saxon.tree.ElementWithAttributes
attributeList, namespaceList
 
Fields inherited from class net.sf.saxon.tree.ElementImpl
nameCode, root, sequence
 
Fields inherited from class net.sf.saxon.tree.NodeImpl
index, NODE_LETTER, parent
 
Fields inherited from interface net.sf.saxon.om.NodeInfo
ALL_NAMESPACES, EMPTY_NAMESPACE_LIST, IS_DTD_TYPE, LOCAL_NAMESPACES, NO_NAMESPACES
 
Fields inherited from interface net.sf.saxon.om.ValueRepresentation
EMPTY_VALUE_ARRAY
 
Constructor Summary
LiteralResultElement()
           
 
Method Summary
 Expression compile(Executable exec)
          Process the literal result element by copying it to the result tree
 int getConstructType()
          Get the type of construct.
 int getObjectNameCode()
          Get a name identifying the object of the expression, for example a function name, template name, variable name, key name, element name, etc.
 java.lang.Object getProperty(java.lang.String name)
          Get the value of a particular property of the instruction.
 boolean isInstruction()
          Specify that this is an instruction
 DocumentImpl makeStylesheet(PreparedStylesheet pss, StyleNodeFactory nodeFactory)
          Make a top-level literal result element into a stylesheet.
 boolean mayContainSequenceConstructor()
          Determine whether this type of element is allowed to contain a template-body
 void prepareAttributes()
          Process the attribute list
 void validate()
          Validate that this node is OK
protected  void validateChildren()
          Validate the children of this node, recursively.
 
Methods inherited from class net.sf.saxon.style.StyleElement
allocateLocationId, allocateSlots, backwardsCompatibleModeIsEnabled, bindVariable, checkEmpty, checkSortComesFirst, checkTopLevel, checkUnknownAttribute, checkWithinTemplate, compileError, compileError, compileError, compileSequenceConstructor, compileWarning, definesExcludedNamespace, definesExtensionElement, fallbackProcessing, fixupReferences, forwardsCompatibleModeIsEnabled, getAttributeSets, getAttributeValue, getCommonChildItemType, getContainingSlotManager, getContainingStylesheet, getDefaultCollationName, getDefaultXPathNamespace, getExecutable, getHostLanguage, getLastChildInstruction, getLineNumber, getLineNumber, getLocationProvider, getNamespaceResolver, getObjectFingerprint, getPrecedence, getPreparedStylesheet, getPrincipalStylesheet, getProperties, getReturnedItemType, getSchemaType, getStaticContext, getStylesheetFunction, getSystemId, getTargetNamePool, getTypeAnnotation, getVersion, getWithParamInstructions, isExcludedNamespace, isExplaining, isExtensionNamespace, isPermittedChild, issueWarning, issueWarning, isTopLevel, makeAttributeValueTemplate, makeExpression, makeNameCode, makeNamespaceContext, makePattern, makeSequenceType, makeSortKeys, makeTraceInstruction, markTailCalls, mayContainFallback, postValidate, processAllAttributes, processAttributes, processDefaultCollationAttribute, processDefaultXPathNamespaceAttribute, processExcludedNamespaces, processExtensionElementAttribute, processVersionAttribute, reportAbsence, setLineNumber, setObjectNameCode, setValidationError, substituteFor, typeCheck, typeCheck, undeclaredNamespaceError, validateSubtree
 
Methods inherited from class net.sf.saxon.tree.ElementWithAttributes
copy, getAttributeList, getAttributeValue, getDeclaredNamespaces, getInScopeNamespaceCodes, getPrefixForURI, getURICodeForPrefix, getURIForPrefix, initialise, iteratePrefixes, sendNamespaceDeclarations, setNamespaceDeclarations
 
Methods inherited from class net.sf.saxon.tree.ElementImpl
addChild, compact, enumerateChildren, generateId, getBaseURI, getDocumentRoot, getFirstChild, getLastChild, getNameCode, getNodeKind, getNthChild, getRoot, getSequenceNumber, getStringValue, getStringValueCS, getSystemId, hasChildNodes, setNameCode, setSystemId, useChildrenArray
 
Methods inherited from class net.sf.saxon.tree.NodeImpl
atomize, compareOrder, equals, getColumnNumber, getConfiguration, getDisplayName, getDocumentNumber, getFingerprint, getLocalPart, getNamePool, getNextInDocument, getNextSibling, getParent, getPrefix, getPreviousInDocument, getPreviousSibling, getPublicId, getTypeAnnotation, getTypedValue, getURI, hashCode, isSameNodeInfo, iterateAxis, iterateAxis
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.xml.sax.Locator
getColumnNumber, getPublicId, getSystemId
 
Methods inherited from interface javax.xml.transform.SourceLocator
getColumnNumber, getPublicId, getSystemId
 
Methods inherited from interface net.sf.saxon.trace.InstructionInfo
getSystemId
 

Constructor Detail

LiteralResultElement

public LiteralResultElement()
Method Detail

mayContainSequenceConstructor

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

Overrides:
mayContainSequenceConstructor in class StyleElement
Returns:
true: yes, it may contain a template-body

isInstruction

public boolean isInstruction()
Specify that this is an instruction

Overrides:
isInstruction in class StyleElement

prepareAttributes

public void prepareAttributes()
                       throws XPathException
Process the attribute list

Specified by:
prepareAttributes in class StyleElement
Throws:
XPathException

validate

public void validate()
              throws XPathException
Validate that this node is OK

Overrides:
validate in class StyleElement
Throws:
XPathException

validateChildren

protected void validateChildren()
                         throws XPathException
Validate the children of this node, recursively. Overridden for top-level data elements.

Overrides:
validateChildren in class StyleElement
Throws:
XPathException

compile

public Expression compile(Executable exec)
                   throws XPathException
Process the literal result element by copying it to the result tree

Specified by:
compile in class StyleElement
Returns:
either a ComputedExpression, or null. The value null is returned when compiling an instruction that returns a no-op, or when compiling a top-level object such as an xsl:template that compiles into something other than an instruction.
Throws:
XPathException

makeStylesheet

public DocumentImpl makeStylesheet(PreparedStylesheet pss,
                                   StyleNodeFactory nodeFactory)
                            throws XPathException
Make a top-level literal result element into a stylesheet. This implements the "Literal Result Element As Stylesheet" facility.

Throws:
XPathException

getConstructType

public int getConstructType()
Get the type of construct. This will be a constant in class Location. This method is part of the InstructionInfo interface

Specified by:
getConstructType in interface InstructionInfo
Overrides:
getConstructType in class StyleElement

getObjectNameCode

public int getObjectNameCode()
Get a name identifying the object of the expression, for example a function name, template name, variable name, key name, element name, etc. This is used only where the name is known statically. If there is no name, the value will be -1.

Specified by:
getObjectNameCode in interface InstructionInfo
Overrides:
getObjectNameCode in class StyleElement

getProperty

public java.lang.Object getProperty(java.lang.String name)
Get the value of a particular property of the instruction. This is part of the InstructionInfo interface for run-time tracing and debugging. The properties available include all the attributes of the source instruction (named by the attribute name): these are all provided as string values.

Specified by:
getProperty in interface InstructionInfo
Overrides:
getProperty in class StyleElement
Parameters:
name - The name of the required property
Returns:
The value of the requested property, or null if the property is not available