org.apache.commons.el

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 and Description
(package private) Expression	mIndex
(package private) static java.lang.Object[]	sNoArgs

Constructor Summary

Constructors

Constructor and Description
ArraySuffix(Expression pIndex) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	evaluate(java.lang.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) java.lang.Object	evaluateIndex(javax.servlet.jsp.el.VariableResolver pResolver, javax.servlet.jsp.el.FunctionMapper functions, Logger pLogger) Gets the value of the index
java.lang.String	getExpressionString() Returns the expression in the expression language syntax
Expression	getIndex()
(package private) java.lang.String	getOperatorSymbol() Returns the operator symbol
void	setIndex(Expression pIndex)

Methods inherited from class java.lang.Object

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

Field Detail

sNoArgs

static java.lang.Object[] sNoArgs

mIndex

Expression mIndex

Constructor Detail

ArraySuffix

public ArraySuffix(Expression pIndex)

Constructor

Method Detail

getIndex

public Expression getIndex()

setIndex

public void setIndex(Expression pIndex)

evaluateIndex

java.lang.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

java.lang.String getOperatorSymbol()

Returns the operator symbol

getExpressionString

public java.lang.String getExpressionString()

Returns the expression in the expression language syntax

Specified by:

getExpressionString in class ValueSuffix

evaluate

public java.lang.Object evaluate(java.lang.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