public class XSLFunction extends StyleElement implements StylesheetComponent
ACTION_COMPILE, ACTION_FIXUP, ACTION_OPTIMIZE, ACTION_PROCESS_ATTRIBUTES, ACTION_TYPECHECK, ACTION_VALIDATE, actionsCompleted, defaultCollationName, defaultMode, defaultXPathNamespace, expandText, extensionNamespaces, IGNORED_INSTRUCTION, REPORT_ALWAYS, REPORT_DYNAMICALLY_UNLESS_FALLBACK_AVAILABLE, REPORT_IF_INSTANTIATED, REPORT_STATICALLY_UNLESS_FALLBACK_AVAILABLE, REPORT_UNLESS_FORWARDS_COMPATIBLE, reportingCircumstances, staticContext, validationError, version, YES_NO
NODE_LETTER
ALL_NAMESPACES, IS_DTD_TYPE, IS_NILLED, LOCAL_NAMESPACES, NO_NAMESPACES
Constructor and Description |
---|
XSLFunction() |
Modifier and Type | Method and Description |
---|---|
protected void |
addChild(NodeImpl node,
int index)
Add a child node to this node.
|
void |
checkCompatibility(Component component)
Check the compatibility of this component with another component that it is overriding
|
void |
compact(int size)
Compact the space used by this node
|
void |
compileDeclaration(Compilation compilation,
ComponentDeclaration decl)
Compile the function definition to create an executable representation
The compileDeclaration() method has the side-effect of binding
all references to the function to the executable representation
(a UserFunction object)
|
void |
fixupReferences()
Notify all references to this function of the data type.
|
void |
generateByteCode(Optimizer opt)
Generate byte code if appropriate
|
UserFunction |
getActor()
Get the corresponding Procedure object that results from the compilation of this
StylesheetProcedure
|
SequenceType[] |
getArgumentTypes()
Get the argument types
|
UserFunction |
getCompiledFunction()
Get the compiled function
|
int |
getConstructType()
Get the type of construct.
|
NodeImpl |
getFirstChild()
Get the first child node of the element
|
NodeImpl |
getLastChild()
Get the last child node of the element
|
protected NodeImpl |
getNthChild(int n)
Get the nth child node of the element (numbering from 0)
|
int |
getNumberOfArguments()
Get the number of arguments declared by this function (that is, its arity).
|
int |
getNumberOfChildren()
Determine how many children the node has
|
StructuredQName |
getObjectName()
Get a name identifying the object of the expression, for example a function name, template name,
variable name, key name, element name, etc.
|
protected int |
getRawSequenceNumber() |
SequenceType |
getResultType()
Get the type of value returned by this function
|
protected long |
getSequenceNumber()
Get the node sequence number (in document order).
|
SlotManager |
getSlotManager()
Get associated stack frame details.
|
java.lang.String |
getStringValue()
Return the string-value of the node, that is, the concatenation
of the character content of all descendent elements and text nodes.
|
java.lang.CharSequence |
getStringValueCS()
Get the value of the item as a CharSequence.
|
SymbolicName.F |
getSymbolicName()
Get the symbolic name of the component, that is, the combination of the component kind and
the qualified name
|
Visibility |
getVisibility()
Get the visibility of the component.
|
boolean |
hasChildNodes()
Determine if the node has any children.
|
void |
index(ComponentDeclaration decl,
PrincipalStylesheetModule top)
Method supplied by declaration elements to add themselves to a stylesheet-level index
|
void |
insertChildren(NodeInfo[] source,
boolean atStart,
boolean inherit)
Insert a sequence of nodes as children of this node.
|
protected void |
insertChildrenAt(NodeInfo[] source,
int index,
boolean inherit)
Insert children before or after a given existing child
|
boolean |
isDeclaration()
Ask whether this node is a declaration, that is, a permitted child of xsl:stylesheet
(including xsl:include and xsl:import).
|
boolean |
isOverrideExtensionFunction()
Is override-extension-function="yes"?.
|
protected boolean |
isPermittedChild(StyleElement child)
Specify that xsl:param is a permitted child
|
protected AxisIterator |
iterateChildren(NodeTest test)
Get an enumeration of the children of this node
|
protected boolean |
mayContainParam(java.lang.String attName)
Determine whether this type of element is allowed to contain an xsl:param element
|
boolean |
mayContainSequenceConstructor()
Determine whether this type of element is allowed to contain a template-body.
|
void |
optimize(ComponentDeclaration declaration)
Optimize the stylesheet construct
|
void |
prepareAttributes()
Set the attribute list for the element.
|
protected void |
removeChild(NodeImpl child)
Remove a given child
|
protected void |
replaceChildrenAt(NodeInfo[] source,
int index,
boolean inherit)
Replace child at a given index by new children
|
protected void |
setChildren(java.lang.Object children)
Set the children of this node
|
void |
setParameterDefinitions(UserFunction fn)
Set the definitions of the parameters in the compiled function, as an array.
|
protected void |
setRawSequenceNumber(int seq) |
void |
validate(ComponentDeclaration decl)
Check that the stylesheet element is valid.
|
addXSLOverrideFunctionLibrary, allocateLocalSlots, allocateLocation, bindLocalVariable, bindVariable, changesRetainedStaticContext, check30attribute, checkAttributeValue, checkEmpty, checkSortComesFirst, checkTopLevel, checkUnknownAttribute, compile, compileContentValueTemplate, compileError, compileError, compileError, compileError, compileErrorInAttribute, compileSequenceConstructor, compileSequenceConstructor, compileWarning, compileWarning, definesExcludedNamespace, definesExtensionElement, fallbackProcessing, findAncestorElement, findCollation, forwardsCompatibleModeIsEnabled, generateId, getAttributeValue, getBaseURI, getBindingInformation, getCompilation, getContainingPackage, getContainingSlotManager, getContainingStylesheet, getDeclaredVisibility, getDefaultCollationName, getDefaultMode, getDefaultValidation, getDefaultXPathNamespace, getEffectiveVersion, getEffectiveVersionAsString, getHostLanguage, getLastChildInstruction, getNamespaceResolver, getOverriddenComponent, getPackageData, getPrincipalStylesheetModule, getProperties, getProperty, getSchemaType, getStaticContext, getStaticContext, getTypeAnnotation, getUsedAttributeSets, getUsedPackage, getWithParamInstructions, getXslOriginal, hasImplicitBinding, interpretVisibilityValue, invalidAttribute, isActionCompleted, isConstructingComplexContent, isExcludedNamespace, isExpandingText, isExplaining, isExtensionNamespace, isInstruction, isSchemaAware, issueWarning, issueWarning, isTopLevel, isWithinDeclaredStreamableConstruct, makeAttributeValueTemplate, makeExpression, makeExpressionVisitor, makeExtendedSequenceType, makeNamespaceContext, makePattern, makeQName, makeRetainedStaticContext, makeSequenceType, makeSortKeys, makeTraceInstruction, markTailCalls, mayContainFallback, postValidate, processAllAttributes, processAttributes, processBooleanAttribute, processDefaultCollationAttribute, processDefaultMode, processDefaultValidationAttribute, processDefaultXPathNamespaceAttribute, processExcludedNamespaces, processExpandTextAttribute, processExtensionElementAttribute, processStandardAttributes, processVersionAttribute, reportAbsence, seesAvuncularVariables, setActionCompleted, setCompilation, setIgnoreInstruction, setObjectName, setValidationError, substituteFor, typeCheck, typeCheck, undeclaredNamespaceError, validateChildren, validateSubtree, validateValidationAttribute, xPath10ModeIsEnabled
addAttribute, addNamespace, copy, delete, fixupInsertedNamespaces, generateId, getAttributeList, getAttributeValue, getColumnNumber, getDeclaredNamespaces, getLineNumber, getNamespaceList, getNodeKind, getNodeName, getRoot, getSchemaType, getSystemId, getURIForPrefix, gsetAttributeCollection, initialise, isId, isInScopeNamespace, isNilled, iteratePrefixes, removeAttribute, removeTypeAnnotation, rename, replaceStringValue, setAttributeList, setLocation, setNamespaceDeclarations, setNamespaceList, setNilled, setNodeName, setSystemId, setTypeAnnotation
atomize, compareOrder, comparePosition, equals, getConfiguration, getDisplayName, getFingerprint, getLocalPart, getNamePool, getNextInDocument, getNextSibling, getParent, getPhysicalRoot, getPrefix, getPreviousInDocument, getPreviousSibling, getPublicId, getRawParent, getSiblingPosition, getSuccessorElement, getTreeInfo, getURI, hasFingerprint, head, insertSiblings, isDeleted, isIdref, isSameNodeInfo, isStreamed, iterate, iterateAxis, iterateAxis, newBuilder, replace, saveLocation, setRawParent, setSiblingPosition
public UserFunction getActor()
getActor
in interface StylesheetComponent
public boolean isDeclaration()
isDeclaration
in class StyleElement
public void prepareAttributes() throws XPathException
StyleElement
prepareAttributes
in class StyleElement
XPathException
- if a static error is detectedpublic StructuredQName getObjectName()
getObjectName
in class StyleElement
public boolean mayContainSequenceConstructor()
mayContainSequenceConstructor
in class StyleElement
protected boolean mayContainParam(java.lang.String attName)
StyleElement
mayContainParam
in class StyleElement
attName
- if null, the method tests whether an xsl:param child is allowed.
If non-null, it tests whether an xsl:param child with the given attribute name is allowedprotected boolean isPermittedChild(StyleElement child)
isPermittedChild
in class StyleElement
child
- the child that may or may not be permittedpublic Visibility getVisibility()
StyleElement
getVisibility
in class StyleElement
public SymbolicName.F getSymbolicName()
StylesheetComponent
getSymbolicName
in interface StylesheetComponent
public void checkCompatibility(Component component) throws XPathException
StylesheetComponent
checkCompatibility
in interface StylesheetComponent
component
- the overridden componentXPathException
- if the components are not compatible (differing signatures)public boolean isOverrideExtensionFunction()
public void index(ComponentDeclaration decl, PrincipalStylesheetModule top) throws XPathException
StyleElement
index
in class StyleElement
decl
- the Declaration being indexed. (This corresponds to the StyleElement object
except in cases where one module is imported several times with different precedence.)top
- represents the outermost XSLStylesheet or XSLPackage elementXPathException
- if any error is encounteredpublic void fixupReferences() throws XPathException
fixupReferences
in class StyleElement
XPathException
public void validate(ComponentDeclaration decl) throws XPathException
StyleElement
validate
in class StyleElement
decl
- the declaration to be validatedXPathException
- if any error is found during validationpublic void compileDeclaration(Compilation compilation, ComponentDeclaration decl) throws XPathException
compileDeclaration
in class StyleElement
compilation
- the compilation episodedecl
- the containing top-level declaration, for example xsl:function or xsl:templateXPathException
public void optimize(ComponentDeclaration declaration) throws XPathException
StylesheetComponent
optimize
in interface StylesheetComponent
declaration
- the combination of the source XSLT element defining the component, and the
module in which it appearsXPathException
public void generateByteCode(Optimizer opt) throws XPathException
generateByteCode
in interface StylesheetComponent
opt
- the optimizerXPathException
- if bytecode generation failspublic SlotManager getSlotManager()
getSlotManager
in interface StylesheetComponent
public SequenceType getResultType()
public int getNumberOfArguments()
public void setParameterDefinitions(UserFunction fn)
fn
- the compiled object representing the user-written functionpublic SequenceType[] getArgumentTypes()
public UserFunction getCompiledFunction()
public int getConstructType()
LocationKind
. This method is part of the
InstructionInfo
interfacegetConstructType
in class StyleElement
protected final long getSequenceNumber()
getSequenceNumber
in class NodeImpl
protected final int getRawSequenceNumber()
protected final void setRawSequenceNumber(int seq)
protected final void setChildren(java.lang.Object children)
children
- null if there are no children, a single NodeInfo if there is one child, an array of NodeInfo
if there are multiple childrenpublic final boolean hasChildNodes()
hasChildNodes
in interface NodeInfo
hasChildNodes
in class NodeImpl
true
if the node has any children,
false
if the node has no children.public final int getNumberOfChildren()
protected final AxisIterator iterateChildren(NodeTest test)
test
- A NodeTest to be satisfied by the child nodes, or null
if all child node are to be returnedpublic final NodeImpl getFirstChild()
getFirstChild
in interface SteppingNode<NodeImpl>
getFirstChild
in class NodeImpl
public final NodeImpl getLastChild()
getLastChild
in class NodeImpl
protected final NodeImpl getNthChild(int n)
n
- identifies the required childprotected void removeChild(NodeImpl child)
child
- the child to be removedpublic java.lang.String getStringValue()
Item.getStringValueCS()
public java.lang.CharSequence getStringValueCS()
NodeImpl
getStringValueCS
in interface Item
getStringValueCS
in class NodeImpl
Item.getStringValue()
protected void addChild(NodeImpl node, int index)
node
- the node to be added as a child of this node. This must be an instance of
NodeImpl
. It will be modified as a result of this call (by setting its
parent property and sibling position)index
- the position where the child is to be addedpublic void insertChildren(NodeInfo[] source, boolean atStart, boolean inherit)
This method takes no action unless the target node is a document node or element node. It also takes no action in respect of any supplied nodes that are not elements, text nodes, comments, or processing instructions.
The supplied nodes will form the new children. Adjacent text nodes will be merged, and zero-length text nodes removed. The supplied nodes may be modified in situ, for example to change their parent property and to add namespace bindings, or they may be copied, at the discretion of the implementation.
insertChildren
in interface MutableNodeInfo
insertChildren
in class NodeImpl
source
- the nodes to be inserted. The implementation determines what implementation classes
of node it will accept; this implementation will accept text, comment, and processing instruction
nodes belonging to any implementation, but elements must be instances of ElementImpl
.
The supplied nodes will be modified in situ, for example
to change their parent property and to add namespace bindings, if they are instances of
ElementImpl
; otherwise they will be copied. If the nodes are copied, then on return
the supplied source array will contain the copy rather than the original.atStart
- true if the new nodes are to be inserted before existing children; false if they are
to be inserted after existing childreninherit
- true if the inserted nodes are to inherit the namespaces of their new parent; false
if such namespaces are to be undeclaredjava.lang.IllegalArgumentException
- if the supplied nodes use a node implementation that this
implementation does not accept.protected void insertChildrenAt(NodeInfo[] source, int index, boolean inherit)
source
- the children to be inserted. We allow any kind of text, comment, or processing instruction
node, but element nodes must be instances of this NodeInfo implementation.index
- the position before which they are to be inserted: 0 indicates insertion before the
first child, 1 insertion before the second child, and so on.inherit
- true if the inserted nodes are to inherit the namespaces that are in-scope for their
new parent; false if such namespaces should be undeclared on the childrenprotected void replaceChildrenAt(NodeInfo[] source, int index, boolean inherit)
source
- the children to be insertedindex
- the position at which they are to be inserted: 0 indicates replacement of the
first child, replacement of the second child, and so on. The effect is undefined if index
is out of rangeinherit
- set to true if the new child elements are to inherit the in-scope namespaces
of their new parentjava.lang.IllegalArgumentException
- if any of the replacement nodes is not an element, text,
comment, or processing instruction nodepublic void compact(int size)
size
- the number of actual childrenCopyright (c) 2004-2018 Saxonica Limited. All rights reserved.