weblogic.apache.xpath.operations
Class Variable

java.lang.Object
  |
  +--weblogic.apache.xpath.Expression
        |
        +--weblogic.apache.xpath.operations.Variable

public class Variable

extends Expression

The variable reference expression executer.

This class is based on an implementation from the Apache XML Project. In future releases the XML parser, XSLT processor, and associated classes will likely be updated to be based on a later version of the Apache implementations. Since Apache does not guarantee backwards compatibility between versions of their software, we cannot guarantee backwards compatibility of any of the classes contained in the weblogic.apache package or sub-packages.

See Also:

Serialized Form

Field Summary

protected int	m_index The index of the variable, which is either an absolute index to a global, or, if higher than the globals area, must be adjusted by adding the offset to the current stack frame.
protected boolean	m_isGlobal
protected QName	m_qname The qualified name of the variable.

Fields inherited from class weblogic.apache.xpath.Expression

m_slocator

Constructor Summary

Variable()

Method Summary

XObject	execute(XPathContext xctxt) Dereference the variable, and return the reference value.
void	fixupVariables(java.util.Vector vars, int globalsSize) This function is used to fixup variables from QNames to stack frame indexes at stylesheet build time.
boolean	isStableNumber() Tell if this expression returns a stable number that will not change during iterations within the expression.
void	setQName(QName qname) Set the qualified name of the variable.

Methods inherited from class weblogic.apache.xpath.Expression

asIterator, asNode, assertion, bool, canTraverseOutsideSubtree, error, execute, execute, executeCharsToContentHandler, isNodesetExpr, num, setSourceLocator, warn, xstr

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

m_qname

protected QName m_qname

The qualified name of the variable.

m_index

protected int m_index

The index of the variable, which is either an absolute index to a global, or, if higher than the globals area, must be adjusted by adding the offset to the current stack frame.

m_isGlobal

protected boolean m_isGlobal

Constructor Detail

Variable

public Variable()

Method Detail

fixupVariables

public void fixupVariables(java.util.Vector vars,
                           int globalsSize)

This function is used to fixup variables from QNames to stack frame indexes at stylesheet build time.

Parameters:

vars - List of QNames that correspond to variables. This list should be searched backwards for the first qualified name that corresponds to the variable reference qname. The position of the QName in the vector from the start of the vector will be its position in the stack frame (but variables above the globalsTop value will need to be offset to the current stack frame).

Overrides:

fixupVariables in class Expression

setQName

public void setQName(QName qname)

Set the qualified name of the variable.

Parameters:

qname - Must be a non-null reference to a qualified name.

execute

public XObject execute(XPathContext xctxt)
                throws javax.xml.transform.TransformerException

Dereference the variable, and return the reference value. Note that lazy evaluation will occur. If a variable within scope is not found, a warning will be sent to the error listener, and an empty nodeset will be returned.

Parameters:

xctxt - The runtime execution context.

Returns:

The evaluated variable, or an empty nodeset if not found.

Throws:

javax.xml.transform.TransformerException -

Overrides:

execute in class Expression

isStableNumber

public boolean isStableNumber()

Tell if this expression returns a stable number that will not change during iterations within the expression. This is used to determine if a proximity position predicate can indicate that no more searching has to occur.

Returns:

true if the expression represents a stable number.

Overrides:

isStableNumber in class Expression