com.opensymphony.xwork2.util
Interface ValueStack

All Known Implementing Classes:

OgnlValueStack

public interface ValueStack

ValueStack allows multiple beans to be pushed in and dynamic EL expressions to be evaluated against it. When evaluating an expression, the stack will be searched down the stack, from the latest objects pushed in to the earliest, looking for a bean with a getter or setter for the given property or a method of the given name (depending on the expression being evaluated).

Field Summary

static String	REPORT_ERRORS_ON_NO_PROP
static String	VALUE_STACK

Method Summary

String	findString(String expr)
Object	findValue(String expr) Find a value by evaluating the given expression against the stack in the default search order.
Object	findValue(String expr, Class asType) Find a value by evaluating the given expression against the stack in the default search order.
Map	getContext()
Map	getExprOverrides()
CompoundRoot	getRoot() Get the CompoundRoot which holds the objects pushed onto the stack
Object	peek() Get the object on the top of the stack without changing the stack.
Object	pop() Get the object on the top of the stack and remove it from the stack.
void	push(Object o) Put this object onto the top of the stack
void	set(String key, Object o) Sets an object on the stack with the given key so it is retrievable by findValue(key,...)
void	setDefaultType(Class defaultType) Sets the default type to convert to if no type is provided when getting a value.
void	setExprOverrides(Map overrides)
void	setValue(String expr, Object value) Attempts to set a property on a bean in the stack with the given expression using the default search order.
void	setValue(String expr, Object value, boolean throwExceptionOnFailure) Attempts to set a property on a bean in the stack with the given expression using the default search order.
int	size() Get the number of objects in the stack s

Field Detail

VALUE_STACK

static final String VALUE_STACK

See Also:

Constant Field Values

REPORT_ERRORS_ON_NO_PROP

static final String REPORT_ERRORS_ON_NO_PROP

See Also:

Constant Field Values

Method Detail

getContext

Map getContext()

setDefaultType

void setDefaultType(Class defaultType)

Sets the default type to convert to if no type is provided when getting a value.

Parameters:

defaultType -

setExprOverrides

void setExprOverrides(Map overrides)

getExprOverrides

Map getExprOverrides()

getRoot

CompoundRoot getRoot()

Get the CompoundRoot which holds the objects pushed onto the stack

setValue

void setValue(String expr,
              Object value)

Attempts to set a property on a bean in the stack with the given expression using the default search order.

Parameters:

expr - the expression defining the path to the property to be set.

value - the value to be set into the neamed property

setValue

void setValue(String expr,
              Object value,
              boolean throwExceptionOnFailure)

Attempts to set a property on a bean in the stack with the given expression using the default search order.

Parameters:

expr - the expression defining the path to the property to be set.

value - the value to be set into the neamed property

throwExceptionOnFailure - a flag to tell whether an exception should be thrown if there is no property with the given name.

findString

String findString(String expr)

findValue

Object findValue(String expr)

Find a value by evaluating the given expression against the stack in the default search order.

Parameters:

expr - the expression giving the path of properties to navigate to find the property value to return

Returns:

the result of evaluating the expression

findValue

Object findValue(String expr,
                 Class asType)

Find a value by evaluating the given expression against the stack in the default search order.

Parameters:

expr - the expression giving the path of properties to navigate to find the property value to return

asType - the type to convert the return value to

Returns:

the result of evaluating the expression

peek

Object peek()

Get the object on the top of the stack without changing the stack.

See Also:

CompoundRoot.peek()

pop

Object pop()

Get the object on the top of the stack and remove it from the stack.

Returns:

the object on the top of the stack

See Also:

CompoundRoot.pop()

push

void push(Object o)

Put this object onto the top of the stack

Parameters:

o - the object to be pushed onto the stack

See Also:

CompoundRoot.push(Object)

set

void set(String key,
         Object o)

Sets an object on the stack with the given key so it is retrievable by findValue(key,...)

Parameters:

key -

o -

size

int size()

Get the number of objects in the stack s

Returns:

the number of objects in the stack