public class

ReflectivePropertyAccessor

extends Object
implements PropertyAccessor
java.lang.Object
   ↳ org.springframework.expression.spel.support.ReflectivePropertyAccessor

Class Overview

Simple PropertyAccessor that uses reflection to access properties for reading and writing. A property can be accessed if it is accessible as a field on the object or through a getter (if being read) or a setter (if being written).

Summary

Fields
protected final Map<ReflectivePropertyAccessor.CacheKey, ReflectivePropertyAccessor.InvokerPair> readerCache
protected final Map<ReflectivePropertyAccessor.CacheKey, TypeDescriptor> typeDescriptorCache
protected final Map<ReflectivePropertyAccessor.CacheKey, Member> writerCache
Public Constructors
ReflectivePropertyAccessor()
Public Methods
boolean canRead(EvaluationContext context, Object target, 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, Object target, String name)
Called to determine if a resolver instance is able to write to a specified property on a specified target object.
PropertyAccessor createOptimalAccessor(EvaluationContext eContext, Object target, String name)
Attempt to create an optimized property accessor tailored for a property of a particular name on a particular class.
Class[]<?> getSpecificTargetClasses()
Return an array of classes for which this resolver should be called.
TypedValue read(EvaluationContext context, Object target, String name)
Called to read a property from a specified target object
void write(EvaluationContext context, Object target, String name, Object newValue)
Called to write to a property on a specified target object.
Protected Methods
Field findField(String name, Class<?> clazz, boolean mustBeStatic)
Find a field of a certain name on a specified class
Method findGetterForProperty(String propertyName, Class<?> clazz, boolean mustBeStatic)
Find a getter method for the specified property.
Method findSetterForProperty(String propertyName, Class<?> clazz, boolean mustBeStatic)
Find a setter method for the specified property.
[Expand]
Inherited Methods
From class java.lang.Object
From interface org.springframework.expression.PropertyAccessor

Fields

protected final Map<ReflectivePropertyAccessor.CacheKey, ReflectivePropertyAccessor.InvokerPair> readerCache

protected final Map<ReflectivePropertyAccessor.CacheKey, TypeDescriptor> typeDescriptorCache

protected final Map<ReflectivePropertyAccessor.CacheKey, Member> writerCache

Public Constructors

public ReflectivePropertyAccessor ()

Public Methods

public boolean canRead (EvaluationContext context, Object target, String name)

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

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

public boolean canWrite (EvaluationContext context, Object target, String name)

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

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

public PropertyAccessor createOptimalAccessor (EvaluationContext eContext, Object target, String name)

Attempt to create an optimized property accessor tailored for a property of a particular name on a particular class. The general ReflectivePropertyAccessor will always work but is not optimal due to the need to lookup which reflective member (method/field) to use each time read() is called. This method will just return the ReflectivePropertyAccessor instance if it is unable to build something more optimal.

public Class[]<?> getSpecificTargetClasses ()

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.

Returns
  • null which means this is a general purpose accessor

public TypedValue read (EvaluationContext context, Object target, String name)

Called to read a property from a specified target object

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

public void write (EvaluationContext context, Object target, String name, Object newValue)

Called to write to a property on a specified target object. Should only succeed if canWrite() also returns true.

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

Protected Methods

protected Field findField (String name, Class<?> clazz, boolean mustBeStatic)

Find a field of a certain name on a specified class

protected Method findGetterForProperty (String propertyName, Class<?> clazz, boolean mustBeStatic)

Find a getter method for the specified property. A getter is defined as a method whose name start with the prefix 'get' and the rest of the name is the same as the property name (with the first character uppercased).

protected Method findSetterForProperty (String propertyName, Class<?> clazz, boolean mustBeStatic)

Find a setter method for the specified property.