org.xmlpull.v1.builder.xpath.jaxen

Class SimpleVariableContext

java.lang.Object

org.xmlpull.v1.builder.xpath.jaxen.SimpleVariableContext

All Implemented Interfaces:

Serializable, VariableContext

public class SimpleVariableContext
extends Object
implements VariableContext, Serializable

Simple default implementation for VariableContext.

This is a simple table-based key-lookup implementation for VariableContext which can be programmatically extended by setting additional variables.

Author:

bob mcwhirter

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
SimpleVariableContext() Construct.

Method Summary

Methods

Modifier and Type	Method and Description
Object	getVariableValue(String namespaceURI, String prefix, String localName) An implementation should return the value of an xpath variable based on the namespace uri and local name of the variable-reference expression.
void	setVariableValue(String localName, Object value) Set the value associated with a variable.
void	setVariableValue(String namespaceURI, String localName, Object value) Set the value associated with a variable.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleVariableContext

public SimpleVariableContext()

Construct.

Construct with an empty variable lookup table.

Method Detail

setVariableValue

public void setVariableValue(String namespaceURI,
                    String localName,
                    Object value)

Set the value associated with a variable.

This method sets a variable that is associated with any particular namespace. These variables appear such as $prefix:foo in an XPath expression. Prefix to URI resolution is the responsibility of a NamespaceContext. Variables within a VariableContext are refered to purely based upon their namespace URI, if any.

Parameters:

namespaceURI - The namespace URI of the variable.

localName - The local name of the variable

value - The value to be bound to the variable.

setVariableValue

public void setVariableValue(String localName,
                    Object value)

Set the value associated with a variable.

This method sets a variable that is not associated with any particular namespace. These variables appear such as $foo in an XPath expression.

Parameters:

localName - The local name of the variable

value - The value to be bound to the variable.

getVariableValue

public Object getVariableValue(String namespaceURI,
                      String prefix,
                      String localName)
                        throws UnresolvableException

Description copied from interface: VariableContext

An implementation should return the value of an xpath variable based on the namespace uri and local name of the variable-reference expression.

It must not use the prefix parameter to select a variable, because a prefix could be bound to any namespace; the prefix parameter could be used in debugging output or other generated information. The prefix may otherwise be ignored.

Specified by:

getVariableValue in interface VariableContext

Parameters:

namespaceURI - the namespace uri to which the prefix parameter is bound in the xpath expression. If the variable reference expression had no prefix, the namespace uri is null.

prefix - the prefix that was used in the variable reference expression.

localName - the local name of the variable-reference expression; if there is no prefix, then this is the whole name of the variable.

Returns:

the variable's value (which can be null)

Throws:

UnresolvableException - when the variable cannot be resolved.