net.sf.saxon.query

Class GlobalVariableDefinition

java.lang.Object

net.sf.saxon.query.GlobalVariableDefinition

All Implemented Interfaces:

SourceLocator, VariableDeclaration, Declaration

Direct Known Subclasses:

UndeclaredVariable

public class GlobalVariableDefinition
extends Object
implements VariableDeclaration, Declaration

Class to hold compile-time information about an XQuery global variable or parameter. Also used for system-generated global variables created by the optimizer, whether in XSLT or XQuery.

Field Summary

Fields

Modifier and Type	Field and Description
protected List	references

Constructor Summary

Constructors

Constructor and Description
GlobalVariableDefinition()

Method Summary

Modifier and Type	Method and Description
GlobalVariable	compile(Executable exec, int slot) Create a compiled representation of this global variable
void	explain(ExpressionPresenter out) Produce diagnostic output showing the compiled and optimized expression tree for a function
int	getColumnNumber() Get column number
GlobalVariable	getCompiledVariable() Get the compiled variable if the definition has been compiled
int	getLineNumber() Get the line number where the declaration appears
String	getPublicId() Get public identifier
SequenceType	getRequiredType() Get the required type of the variable
String	getSystemId() Get the system ID of the module containing the variable declaration
Expression	getValueExpression() Get the expression used to initialize the value of the variable
StructuredQName	getVariableQName() Get the variable name
boolean	isParameter() Ask whether this global variable is a "parameter" (an external variable, in XQuery terminology)
Iterator	iterateReferences() Iterate over the references to this variable
void	registerReference(BindingReference ref) Register a variable reference that refers to this global variable
void	setIsParameter(boolean b) Say whether this global variable is a "parameter" (an external variable, in XQuery terminology)
void	setLineNumber(int lineNumber) Set the line number where the variable declaration appears in the source
void	setRequiredType(SequenceType type) Set the required type of the variable
void	setSystemId(String systemId) Set the system ID of the module where the variable declaration appears
void	setValueExpression(Expression val) Set the expression used to define the value of the variable
void	setVariableQName(StructuredQName qName) Set the variable name
void	typeCheck(ExpressionVisitor visitor) Type check the compiled representation of this global variable

Methods inherited from class java.lang.Object

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

Field Detail

references

protected List references

Constructor Detail

GlobalVariableDefinition

public GlobalVariableDefinition()

Method Detail

setRequiredType

public void setRequiredType(SequenceType type)

Set the required type of the variable

Parameters:

type - the declared type, from the "as" clause if present

getRequiredType

public SequenceType getRequiredType()

Get the required type of the variable

Returns:

the declared type, from the "as" clause if present

setVariableQName

public void setVariableQName(StructuredQName qName)

Set the variable name

Parameters:

qName - the variable name

getVariableQName

public StructuredQName getVariableQName()

Get the variable name

Specified by:

getVariableQName in interface VariableDeclaration

Returns:

the variable name

setLineNumber

public void setLineNumber(int lineNumber)

Set the line number where the variable declaration appears in the source

Parameters:

lineNumber - the line number

getLineNumber

public int getLineNumber()

Get the line number where the declaration appears

Specified by:

getLineNumber in interface SourceLocator

getColumnNumber

public int getColumnNumber()

Get column number

Specified by:

getColumnNumber in interface SourceLocator

Returns:

-1 always

getPublicId

public String getPublicId()

Get public identifier

Specified by:

getPublicId in interface SourceLocator

Returns:

null always

setSystemId

public void setSystemId(String systemId)

Set the system ID of the module where the variable declaration appears

Parameters:

systemId - the System ID (base URI)

getSystemId

public String getSystemId()

Get the system ID of the module containing the variable declaration

Specified by:

getSystemId in interface SourceLocator

Returns:

the System ID (base URI)

setValueExpression

public void setValueExpression(Expression val)

Set the expression used to define the value of the variable

Parameters:

val - the initializing expression

getValueExpression

public Expression getValueExpression()

Get the expression used to initialize the value of the variable

Returns:

the initializing expression

setIsParameter

public void setIsParameter(boolean b)

Say whether this global variable is a "parameter" (an external variable, in XQuery terminology)

Parameters:

b - true if this variable is external

isParameter

public boolean isParameter()

Ask whether this global variable is a "parameter" (an external variable, in XQuery terminology)

Returns:

true if this variable is an external variable

registerReference

public void registerReference(BindingReference ref)

Register a variable reference that refers to this global variable

Specified by:

registerReference in interface VariableDeclaration

Parameters:

ref - the variable reference

iterateReferences

public Iterator iterateReferences()

Iterate over the references to this variable

Returns:

an iterator over the references: returns objects of class VariableReference

compile

public GlobalVariable compile(Executable exec,
                              int slot)
                       throws XPathException

Create a compiled representation of this global variable

Parameters:

exec - the executable

slot - the slot number allocated to this variable

Returns:

the compiled representation

Throws:

XPathException - if compile-time errors are found.

typeCheck

public void typeCheck(ExpressionVisitor visitor)
               throws XPathException

Type check the compiled representation of this global variable

Parameters:

visitor - an expression visitor

Throws:

XPathException - if compile-time errors are found.

getCompiledVariable

public GlobalVariable getCompiledVariable()

Get the compiled variable if the definition has been compiled

Returns:

the compiled global variable

explain

public void explain(ExpressionPresenter out)

Produce diagnostic output showing the compiled and optimized expression tree for a function

Parameters:

out - the destination to be used