org.jaxen
Class SimpleVariableContext

java.lang.Object
  |
  +--org.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
SimpleVariableContext()
          Construct.
 
Method Summary
 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
Following copied from interface: org.jaxen.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.


Copyright © 2002 bob mcwhirter & James Strachan. All Rights Reserved. Hosted by

SourceForge Logo