com.icl.saxon

Class Context

public final class Context extends Object implements XSLTContext, LastPositionFinder

This class represents a context in which an expression is evaluated or a template is executed (as defined in the XSLT specification). It also provides a range of services to node handlers, for example access to the outputter and bindery, and the applyTemplates() function.

Field Summary
static int	ALL_DEPENDENCIES
static int	CONTEXT_DOCUMENT
static int	CONTEXT_NODE
static int	CONTROLLER
static int	CURRENT_NODE
static int	LAST
static int	NO_DEPENDENCIES
static int	POSITION
static int	VARIABLES
static int	XSLT_CONTEXT

Constructor Summary
	Context() The default constructor is not used within Saxon itself, but is available to applications (and is used in some samples).
	Context(Controller c) Constructor should only be called by the Controller, which acts as a Context factory.

Method Summary
Bindery	getBindery() Get the Bindery used by this Context
Node	getContextNode() Get the context node, provided it is a DOM Node
NodeInfo	getContextNodeInfo() Get the context node
int	getContextPosition() Get the context position (the position of the context node in the context node list)
int	getContextSize() Get the context size (the position of the last item in the current node list).
Controller	getController() Get the controller for this Context
Node	getCurrentNode() Get the current node,provided it is a DOM Node.
NodeInfo	getCurrentNodeInfo() Get the current node.
XSLTemplate	getCurrentTemplate() Get the current template.
XPathException	getException() Get the saved exception value.
Stack	getGroupActivationStack() Get the saxon:group activation stack
int	getLast() Get the context size (the position of the last item in the current node list)
int	getLastPosition() Get the last position, to be used only when the context object is being used as the last position finder
Mode	getMode() Get the current mode (for use by the built-in handlers)
Outputter	getOutputter() Get the current Outputter.
Document	getOwnerDocument() Get owner Document (enabling extension functions to create new Nodes)
int	getRememberedNumber(NodeInfo node) Get the number of a node if it is the last remembered one.
Value	getReturnValue() Get the return value from function
StaticContext	getStaticContext() Get the static context.
ParameterSet	getTailRecursion() Get tail recursion parameters
boolean	isAtLast() Determine whether the context position is the same as the context size that is, whether position()=last()
Context	newContext() Construct a new context as a copy of another
void	setContextNode(NodeInfo node) Set the context node.
void	setController(Controller c) Set the controller for this Context
void	setCurrentNode(NodeInfo node) Set the current node.
void	setCurrentTemplate(XSLTemplate template) Set the current template.
void	setException(XPathException err) Set an exception value.
void	setLast(int last) Set the context size; this also makes the Context object responisble for returning the last() position.
void	setLastPositionFinder(LastPositionFinder finder) Set the LastPositionFinder, another object that will do the work of returning the last() position
void	setMode(Mode mode) Set the mode (for use by the built-in handlers)
void	setPosition(int pos) Set the context position
void	setRememberedNumber(NodeInfo node, int number) Set the last remembered node, for node numbering purposes
void	setReturnValue(Value value) Set return value from function
void	setStaticContext(StaticContext sc) Set the static context
void	setTailRecursion(ParameterSet p) Set tail recursion parameters
String	stringValue(Node n) Return the String value of a node
Object	systemProperty(String namespaceURI, String localName) Get the value of a system property

Field Detail

ALL_DEPENDENCIES

public static final int ALL_DEPENDENCIES

CONTEXT_DOCUMENT

public static final int CONTEXT_DOCUMENT

CONTEXT_NODE

public static final int CONTEXT_NODE

CONTROLLER

public static final int CONTROLLER

CURRENT_NODE

public static final int CURRENT_NODE

LAST

public static final int LAST

NO_DEPENDENCIES

public static final int NO_DEPENDENCIES

POSITION

public static final int POSITION

VARIABLES

public static final int VARIABLES

XSLT_CONTEXT

public static final int XSLT_CONTEXT

Constructor Detail

Context

public Context()

The default constructor is not used within Saxon itself, but is available to applications (and is used in some samples). Because some expressions (for example union expressions) cannot execute without a Controller, a system default Controller is created. This is a quick fix, but is not entirely satisfactory, because it's not thread-safe. Applications are encouraged to create a Controller explicitly and use it only within a single thread.

Context

public Context(Controller c)

Constructor should only be called by the Controller, which acts as a Context factory.

Method Detail

getBindery

public Bindery getBindery()

Get the Bindery used by this Context

getContextNode

public Node getContextNode()

Get the context node, provided it is a DOM Node

Returns: the context node if it is a DOM Node, otherwise null

getContextNodeInfo

public NodeInfo getContextNodeInfo()

Get the context node

Returns: the context node

getContextPosition

public int getContextPosition()

Get the context position (the position of the context node in the context node list)

Returns: the context position (starting at one)

getContextSize

public int getContextSize()

Get the context size (the position of the last item in the current node list). This is the XSLTContext method: it differs from getLast() in that it cannot throw an exception. This method should be called only from within extension functions. If any error occurs, it will be accessible via Context#getException().

Returns: the context size

getController

public Controller getController()

Get the controller for this Context

getCurrentNode

public Node getCurrentNode()

Get the current node,provided it is a DOM Node. This is the node in the source document currently being processed (e.g. by apply-templates). It is not necessarily the same as the context node: the context node can change in a sub-expression, the current node cannot.

Returns: the current node if it is a DOM Node; otherwise null.

getCurrentNodeInfo

public NodeInfo getCurrentNodeInfo()

Get the current node. This is the node in the source document currently being processed (e.g. by apply-templates). It is not necessarily the same as the context node: the context node can change in a sub-expression, the current node cannot.