Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## 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

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2007 OpenSymphony. All Rights Reserved.