Class ArraySuffix

java.lang.Object

org.apache.commons.el.ValueSuffix

org.apache.commons.el.ArraySuffix

Direct Known Subclasses:

PropertySuffix

public class ArraySuffix
extends ValueSuffix

Represents an operator that obtains a Map entry, an indexed value, a property value, or an indexed property value of an object. The following are the rules for evaluating this operator:

Evaluating a[b] (assuming a.b == a["b"])
  a is null
    return null
  b is null
    return null
  a is Map
    !a.containsKey (b)
      return null
    a.get(b) == null
      return null
    otherwise
      return a.get(b)
  a is List or array
    coerce b to int (using coercion rules)
    coercion couldn't be performed
      error
    a.get(b) or Array.get(a, b) throws ArrayIndexOutOfBoundsException or IndexOutOfBoundsException
      return null
    a.get(b) or Array.get(a, b) throws other exception
      error
    return a.get(b) or Array.get(a, b)

  coerce b to String
  b is a readable property of a
    getter throws an exception
      error
    otherwise
      return result of getter call

  otherwise
    error

Version:

$Change: 181177 $$DateTime: 2001/06/26 08:45:09 $$Author: luehe $

Author:

Nathan Abramson - Art Technology Group, Shawn Bayern

Field Summary

Fields

Modifier and Type	Field	Description
(package private) Expression	mIndex
(package private) static Object[]	sNoArgs

Constructor Summary

Constructors

Constructor	Description
ArraySuffix(Expression pIndex)	Constructor

Method Summary

Modifier and Type	Method	Description
Object	evaluate(Object pValue, javax.servlet.jsp.el.VariableResolver pResolver, javax.servlet.jsp.el.FunctionMapper functions, Logger pLogger)	Evaluates the expression in the given context, operating on the given value.
(package private) Object	evaluateIndex(javax.servlet.jsp.el.VariableResolver pResolver, javax.servlet.jsp.el.FunctionMapper functions, Logger pLogger)	Gets the value of the index
String	getExpressionString()	Returns the expression in the expression language syntax
Expression	getIndex()
(package private) String	getOperatorSymbol()	Returns the operator symbol
void	setIndex(Expression pIndex)

Methods inherited from class Object

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

Field Details

sNoArgs

static Object[] sNoArgs

mIndex

Expression mIndex

Constructor Details

ArraySuffix

public ArraySuffix(Expression pIndex)

Constructor

Method Details

getIndex

public Expression getIndex()

setIndex

public void setIndex(Expression pIndex)

evaluateIndex

Object evaluateIndex(javax.servlet.jsp.el.VariableResolver pResolver,
 javax.servlet.jsp.el.FunctionMapper functions,
 Logger pLogger)
              throws javax.servlet.jsp.el.ELException

Gets the value of the index

Throws:

javax.servlet.jsp.el.ELException

getOperatorSymbol

String getOperatorSymbol()

Returns the operator symbol

getExpressionString

public String getExpressionString()

Returns the expression in the expression language syntax

Specified by:

getExpressionString in class ValueSuffix

evaluate

public Object evaluate(Object pValue,
 javax.servlet.jsp.el.VariableResolver pResolver,
 javax.servlet.jsp.el.FunctionMapper functions,
 Logger pLogger)
                throws javax.servlet.jsp.el.ELException

Evaluates the expression in the given context, operating on the given value.

Specified by:

evaluate in class ValueSuffix

Throws:

javax.servlet.jsp.el.ELException