org.springframework.context.expression

Class MapAccessor

java.lang.Object

org.springframework.context.expression.MapAccessor

All Implemented Interfaces:

Opcodes, PropertyAccessor, CompilablePropertyAccessor

public class MapAccessor
extends java.lang.Object
implements CompilablePropertyAccessor

EL property accessor that knows how to traverse the keys of a standard Map.

Since:

3.0

Author:

Juergen Hoeller, Andy Clement

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	MapAccessor.MapAccessException Exception thrown from read in order to reset a cached PropertyAccessor, allowing other accessors to have a try.

Field Summary

Fields inherited from interface org.springframework.asm.Opcodes

AALOAD, AASTORE, ACC_ABSTRACT, ACC_ANNOTATION, ACC_BRIDGE, ACC_DEPRECATED, ACC_ENUM, ACC_FINAL, ACC_INTERFACE, ACC_MANDATED, ACC_NATIVE, ACC_PRIVATE, ACC_PROTECTED, ACC_PUBLIC, ACC_STATIC, ACC_STRICT, ACC_SUPER, ACC_SYNCHRONIZED, ACC_SYNTHETIC, ACC_TRANSIENT, ACC_VARARGS, ACC_VOLATILE, ACONST_NULL, ALOAD, ANEWARRAY, ARETURN, ARRAYLENGTH, ASM4, ASM5, ASTORE, ATHROW, BALOAD, BASTORE, BIPUSH, CALOAD, CASTORE, CHECKCAST, D2F, D2I, D2L, DADD, DALOAD, DASTORE, DCMPG, DCMPL, DCONST_0, DCONST_1, DDIV, DLOAD, DMUL, DNEG, DOUBLE, DREM, DRETURN, DSTORE, DSUB, DUP, DUP_X1, DUP_X2, DUP2, DUP2_X1, DUP2_X2, F_APPEND, F_CHOP, F_FULL, F_NEW, F_SAME, F_SAME1, F2D, F2I, F2L, FADD, FALOAD, FASTORE, FCMPG, FCMPL, FCONST_0, FCONST_1, FCONST_2, FDIV, FLOAD, FLOAT, FMUL, FNEG, FREM, FRETURN, FSTORE, FSUB, GETFIELD, GETSTATIC, GOTO, H_GETFIELD, H_GETSTATIC, H_INVOKEINTERFACE, H_INVOKESPECIAL, H_INVOKESTATIC, H_INVOKEVIRTUAL, H_NEWINVOKESPECIAL, H_PUTFIELD, H_PUTSTATIC, I2B, I2C, I2D, I2F, I2L, I2S, IADD, IALOAD, IAND, IASTORE, ICONST_0, ICONST_1, ICONST_2, ICONST_3, ICONST_4, ICONST_5, ICONST_M1, IDIV, IF_ACMPEQ, IF_ACMPNE, IF_ICMPEQ, IF_ICMPGE, IF_ICMPGT, IF_ICMPLE, IF_ICMPLT, IF_ICMPNE, IFEQ, IFGE, IFGT, IFLE, IFLT, IFNE, IFNONNULL, IFNULL, IINC, ILOAD, IMUL, INEG, INSTANCEOF, INTEGER, INVOKEDYNAMIC, INVOKEINTERFACE, INVOKESPECIAL, INVOKESTATIC, INVOKEVIRTUAL, IOR, IREM, IRETURN, ISHL, ISHR, ISTORE, ISUB, IUSHR, IXOR, JSR, L2D, L2F, L2I, LADD, LALOAD, LAND, LASTORE, LCMP, LCONST_0, LCONST_1, LDC, LDIV, LLOAD, LMUL, LNEG, LONG, LOOKUPSWITCH, LOR, LREM, LRETURN, LSHL, LSHR, LSTORE, LSUB, LUSHR, LXOR, MONITORENTER, MONITOREXIT, MULTIANEWARRAY, NEW, NEWARRAY, NOP, NULL, POP, POP2, PUTFIELD, PUTSTATIC, RET, RETURN, SALOAD, SASTORE, SIPUSH, SWAP, T_BOOLEAN, T_BYTE, T_CHAR, T_DOUBLE, T_FLOAT, T_INT, T_LONG, T_SHORT, TABLESWITCH, TOP, UNINITIALIZED_THIS, V1_1, V1_2, V1_3, V1_4, V1_5, V1_6, V1_7, V1_8

Constructor Summary

Constructors

Constructor and Description
MapAccessor()

Method Summary

Modifier and Type	Method and Description
boolean	canRead(EvaluationContext context, java.lang.Object target, java.lang.String name) Called to determine if a resolver instance is able to access a specified property on a specified target object.
boolean	canWrite(EvaluationContext context, java.lang.Object target, java.lang.String name) Called to determine if a resolver instance is able to write to a specified property on a specified target object.
void	generateCode(java.lang.String propertyName, MethodVisitor mv, CodeFlow cf) Generate the bytecode the performs the access operation into the specified MethodVisitor using context information from the codeflow where necessary.
java.lang.Class<?>	getPropertyType() Return the type of the accessed property - may only be known once an access has occurred.
java.lang.Class<?>[]	getSpecificTargetClasses() Return an array of classes for which this resolver should be called.
boolean	isCompilable() Return true if this property accessor is currently suitable for compilation.
TypedValue	read(EvaluationContext context, java.lang.Object target, java.lang.String name) Called to read a property from a specified target object.
void	write(EvaluationContext context, java.lang.Object target, java.lang.String name, java.lang.Object newValue) Called to write to a property on a specified target object.

Methods inherited from class java.lang.Object

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

Constructor Detail

MapAccessor

public MapAccessor()

Method Detail

getSpecificTargetClasses

public java.lang.Class<?>[] getSpecificTargetClasses()

Description copied from interface: PropertyAccessor

Return an array of classes for which this resolver should be called.

>Returning null indicates this is a general resolver that can be called in an attempt to resolve a property on any type.

Specified by:

getSpecificTargetClasses in interface PropertyAccessor

Returns:

an array of classes that this resolver is suitable for (or null if a general resolver)

canRead

public boolean canRead(EvaluationContext context,
                       java.lang.Object target,
                       java.lang.String name)
                throws AccessException

Description copied from interface: PropertyAccessor

Called to determine if a resolver instance is able to access a specified property on a specified target object.

Specified by:

canRead in interface PropertyAccessor

Parameters:

context - the evaluation context in which the access is being attempted

target - the target object upon which the property is being accessed

name - the name of the property being accessed

Returns:

true if this resolver is able to read the property

Throws:

AccessException - if there is any problem determining whether the property can be read

read

public TypedValue read(EvaluationContext context,
                       java.lang.Object target,
                       java.lang.String name)
                throws AccessException

Description copied from interface: PropertyAccessor

Called to read a property from a specified target object. Should only succeed if PropertyAccessor.canRead(org.springframework.expression.EvaluationContext, java.lang.Object, java.lang.String) also returns true.

Specified by:

read in interface PropertyAccessor

Parameters:

context - the evaluation context in which the access is being attempted

target - the target object upon which the property is being accessed

name - the name of the property being accessed

Returns:

a TypedValue object wrapping the property value read and a type descriptor for it

Throws:

AccessException - if there is any problem accessing the property value

canWrite

public boolean canWrite(EvaluationContext context,
                        java.lang.Object target,
                        java.lang.String name)
                 throws AccessException

Description copied from interface: PropertyAccessor

Called to determine if a resolver instance is able to write to a specified property on a specified target object.

Specified by:

canWrite in interface PropertyAccessor

Parameters:

context - the evaluation context in which the access is being attempted

target - the target object upon which the property is being accessed

name - the name of the property being accessed

Returns:

true if this resolver is able to write to the property

Throws:

AccessException - if there is any problem determining whether the property can be written to

write

public void write(EvaluationContext context,
                  java.lang.Object target,
                  java.lang.String name,
                  java.lang.Object newValue)
           throws AccessException

Description copied from interface: PropertyAccessor

Called to write to a property on a specified target object. Should only succeed if PropertyAccessor.canWrite(org.springframework.expression.EvaluationContext, java.lang.Object, java.lang.String) also returns true.

Specified by:

write in interface PropertyAccessor

Parameters:

context - the evaluation context in which the access is being attempted

target - the target object upon which the property is being accessed

name - the name of the property being accessed

newValue - the new value for the property

Throws:

AccessException - if there is any problem writing to the property value

isCompilable

public boolean isCompilable()

Description copied from interface: CompilablePropertyAccessor

Return true if this property accessor is currently suitable for compilation.

Specified by:

isCompilable in interface CompilablePropertyAccessor

getPropertyType

public java.lang.Class<?> getPropertyType()

Description copied from interface: CompilablePropertyAccessor

Return the type of the accessed property - may only be known once an access has occurred.

Specified by:

getPropertyType in interface CompilablePropertyAccessor

generateCode

public void generateCode(java.lang.String propertyName,
                         MethodVisitor mv,
                         CodeFlow cf)

Description copied from interface: CompilablePropertyAccessor

Generate the bytecode the performs the access operation into the specified MethodVisitor using context information from the codeflow where necessary.

Specified by:

generateCode in interface CompilablePropertyAccessor

Parameters:

propertyName - the name of the property

mv - the Asm method visitor into which code should be generated

cf - the current state of the expression compiler