|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object net.sf.saxon.expr.Expression net.sf.saxon.expr.instruct.Instruction net.sf.saxon.expr.instruct.ParentNodeConstructor net.sf.saxon.expr.instruct.ElementCreator
public abstract class ElementCreator
An instruction that creates an element node. There are two subtypes, FixedElement for use where the name is known statically, and Element where it is computed dynamically. To allow use in both XSLT and XQuery, the class acts both as an Instruction and as an Expression.
Field Summary | |
---|---|
protected boolean |
inheritNamespaces
The inheritNamespaces flag indicates that the namespace nodes on the element created by this instruction are to be inherited (copied) on the children of this element. |
Fields inherited from class net.sf.saxon.expr.instruct.ParentNodeConstructor |
---|
content, preservingTypes |
Fields inherited from class net.sf.saxon.expr.Expression |
---|
EFFECTIVE_BOOLEAN_VALUE, EVALUATE_METHOD, EVENT_FEED_METHOD, ITEM_FEED_METHOD, ITERATE_METHOD, locationId, MAX_SEQUENCE_LENGTH, MAX_STRING_LENGTH, PROCESS_METHOD, PUSH_SELECTION, staticProperties, UNBOUNDED_LOWER, UNBOUNDED_UPPER, WATCH_METHOD |
Constructor Summary | |
---|---|
ElementCreator()
Construct an ElementCreator. |
Method Summary | |
---|---|
protected void |
checkContentSequence(StaticContext env)
Check statically whether the content of the element creates attributes or namespaces after creating any child nodes |
int |
computeSpecialProperties()
Get the static properties of this expression (other than its type). |
Item |
evaluateItem(XPathContext context)
Evaluate the constructor, returning the constructed element node. |
NamespaceBinding[] |
getActiveNamespaces()
Callback to get a list of the intrinsic namespaces that need to be generated for the element. |
abstract NodeName |
getElementName(XPathContext context,
NodeInfo copiedNode)
Determine (at run-time) the name code of the element being constructed |
int |
getImplementationMethod()
An implementation of Expression must provide at least one of the methods evaluateItem(), iterate(), or process(). |
ItemType |
getItemType(TypeHierarchy th)
Get the item type of the value returned by this instruction |
protected abstract String |
getNewBaseURI(XPathContext context,
NodeInfo copiedNode)
Get the base URI for the element being constructed |
boolean |
isInheritNamespaces()
Determine whether the inherit namespaces flag is set |
EventIterator |
iterateEvents(XPathContext context)
Deliver the result of the expression as a sequence of events. |
protected EventIterator |
iterateEvents(XPathContext context,
NodeInfo copiedNode)
|
protected abstract void |
outputNamespaceNodes(XPathContext context,
Receiver receiver,
NodeName nameCode,
NodeInfo copiedNode)
Callback to output namespace nodes for the new element. |
TailCall |
processLeavingTail(XPathContext context)
Evaluate the instruction to produce a new element node. |
protected TailCall |
processLeavingTail(XPathContext context,
NodeInfo copiedNode)
Evaluate the instruction to produce a new element node. |
void |
processLeft(Stack<XPathContext> contextStack,
Stack<Object> state)
In streaming mode, process the first half of the instruction (to start a new document or element) |
protected void |
processLeft(Stack<XPathContext> contextStack,
Stack<Object> state,
NodeInfo copiedNode)
In streaming mode, process the first half of the instruction (to start a new document or element) |
void |
processRight(Stack<XPathContext> contextStack,
Stack<Object> state)
In streaming mode, proecss the right half of the instruction (to end a new document or element) |
void |
suppressValidation(int parentValidationMode)
Suppress validation on contained element constructors, on the grounds that the parent element is already performing validation. |
Methods inherited from class net.sf.saxon.expr.instruct.ParentNodeConstructor |
---|
addToPathMap, computeCardinality, createsNewNodes, getBaseURI, getCardinality, getContentExpression, getSchemaType, getValidationAction, isLazyConstruction, isNamespaceSensitive, isPreservingTypes, iterateSubExpressions, optimize, promoteInst, replaceSubExpression, setBaseURI, setContentExpression, setLazyConstruction, setNoNeedToStrip, setSchemaType, setValidationAction, simplify, typeCheck |
Methods inherited from class net.sf.saxon.expr.instruct.Instruction |
---|
assembleParams, assembleTunnelParams, dynamicError, evaluateAsString, getConstructType, getExpressionName, getInstructionName, getInstructionNameCode, getIteratorFromProcessMethod, getSourceLocator, isXSLT, iterate, process, promote |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface javax.xml.transform.SourceLocator |
---|
getColumnNumber, getLineNumber, getPublicId, getSystemId |
Field Detail |
---|
protected boolean inheritNamespaces
Constructor Detail |
---|
public ElementCreator()
Method Detail |
---|
public ItemType getItemType(TypeHierarchy th)
getItemType
in class Instruction
th
- the type hierarchy cache
public boolean isInheritNamespaces()
public int computeSpecialProperties()
computeSpecialProperties
in class Instruction
public void suppressValidation(int parentValidationMode)
suppressValidation
in class Expression
parentValidationMode
- the kind of validation being performed on the parent expressionprotected void checkContentSequence(StaticContext env) throws XPathException
checkContentSequence
in class ParentNodeConstructor
env
- the static context
XPathException
public abstract NodeName getElementName(XPathContext context, NodeInfo copiedNode) throws XPathException
context
- the XPath dynamic evaluation contextcopiedNode
- for the benefit of xsl:copy, the node being copied; otherwise null
XPathException
- if a failure occursprotected abstract String getNewBaseURI(XPathContext context, NodeInfo copiedNode)
context
- the XPath dynamic evaluation contextcopiedNode
- the node being copied (for xsl:copy), otherwise null
protected abstract void outputNamespaceNodes(XPathContext context, Receiver receiver, NodeName nameCode, NodeInfo copiedNode) throws XPathException
context
- The execution contextreceiver
- the Receiver where the namespace nodes are to be writtennameCode
- the name code of the element being createdcopiedNode
- the node being copied (for xsl:copy) or null otherwise
XPathException
- if a dynamic error occurspublic NamespaceBinding[] getActiveNamespaces() throws XPathException
XPathException
- if an error occurspublic int getImplementationMethod()
getImplementationMethod
in class Instruction
Expression.ITERATE_METHOD
or Expression.EVALUATE_METHOD
or
Expression.PROCESS_METHOD
public EventIterator iterateEvents(XPathContext context) throws XPathException
Expression
The events (of class PullEvent
) are either complete
items, or one of startElement, endElement, startDocument, or endDocument, known
as semi-nodes. The stream of events may also include a nested EventIterator.
If a start-end pair exists in the sequence, then the events between
this pair represent the content of the document or element. The content sequence will
have been processed to the extent that any attribute and namespace nodes in the
content sequence will have been merged into the startElement event. Namespace fixup
will have been performed: that is, unique prefixes will have been allocated to element
and attribute nodes, and all namespaces will be declared by means of a namespace node
in the startElement event or in an outer startElement forming part of the sequence.
However, duplicate namespaces may appear in the sequence.
The content of an element or document may include adjacent or zero-length text nodes, atomic values, and nodes represented as nodes rather than broken down into events.
iterateEvents
in class Expression
context
- The dynamic evaluation context
XPathException
- if a dynamic error occurs during expression evaluationprotected EventIterator iterateEvents(XPathContext context, NodeInfo copiedNode) throws XPathException
XPathException
public TailCall processLeavingTail(XPathContext context) throws XPathException
processLeavingTail
in interface TailCallReturner
processLeavingTail
in class Instruction
context
- XPath dynamic evaluation context
XPathException
protected final TailCall processLeavingTail(XPathContext context, NodeInfo copiedNode) throws XPathException
context
- XPath dynamic evaluation contextcopiedNode
- null except in the case of xsl:copy, when it is the node being copied; otherwise null
XPathException
- if a dynamic error occurspublic void processLeft(Stack<XPathContext> contextStack, Stack<Object> state) throws XPathException
contextStack
- the dynamic evaluation contextstate
- a stack on which the instruction can save state information for use during the corresponding
XPathException
- if a dynamic error occursprotected final void processLeft(Stack<XPathContext> contextStack, Stack<Object> state, NodeInfo copiedNode) throws XPathException
contextStack
- the dynamic evaluation contextstate
- a stack on which the instruction can save state information for use during the correspondingcopiedNode
- for the benefit of xsl:copy, the node being copied; otherwise null
XPathException
- if a dynamic error occurspublic void processRight(Stack<XPathContext> contextStack, Stack<Object> state) throws XPathException
contextStack
- the stack of XPath context objects for the current execution statestate
- a stack on which the instruction can save state information for use during the corresponding
XPathException
- if a dynamic error occurspublic Item evaluateItem(XPathContext context) throws XPathException
evaluateItem
in class Instruction
context
- The context in which the expression is to be evaluated
XPathException
- if any dynamic error occurs evaluating the
expression
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |