org.springframework.beans

Class ExtendedBeanInfo

java.lang.Object

org.springframework.beans.ExtendedBeanInfo

All Implemented Interfaces:

java.beans.BeanInfo

class ExtendedBeanInfo
extends java.lang.Object
implements java.beans.BeanInfo

Decorator for a standard BeanInfo object, e.g. as created by Introspector.getBeanInfo(Class), designed to discover and register static and/or non-void returning setter methods. For example:

 public class Bean {

     private Foo foo;

     public Foo getFoo() {
         return this.foo;
     }

     public Bean setFoo(Foo foo) {
         this.foo = foo;
         return this;
     }
 }

The standard JavaBeans Introspector will discover the getFoo read method, but will bypass the #setFoo(Foo) write method, because its non-void returning signature does not comply with the JavaBeans specification. ExtendedBeanInfo, on the other hand, will recognize and include it. This is designed to allow APIs with "builder" or method-chaining style setter signatures to be used within Spring <beans> XML. getPropertyDescriptors() returns all existing property descriptors from the wrapped BeanInfo as well any added for non-void returning setters. Both standard ("non-indexed") and indexed properties are fully supported.

Since:

3.1

Author:

Chris Beams, Juergen Hoeller

See Also:

ExtendedBeanInfo(BeanInfo), ExtendedBeanInfoFactory, CachedIntrospectionResults

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	ExtendedBeanInfo.PropertyDescriptorComparator Sorts PropertyDescriptor instances alpha-numerically to emulate the behavior of BeanInfo.getPropertyDescriptors().
(package private) static class	ExtendedBeanInfo.SimpleIndexedPropertyDescriptor A simple IndexedPropertyDescriptor.
(package private) static class	ExtendedBeanInfo.SimplePropertyDescriptor A simple PropertyDescriptor.

Field Summary

Fields

Modifier and Type	Field and Description
private java.beans.BeanInfo	delegate
private static Log	logger
private java.util.Set<java.beans.PropertyDescriptor>	propertyDescriptors

Fields inherited from interface java.beans.BeanInfo

ICON_COLOR_16x16, ICON_COLOR_32x32, ICON_MONO_16x16, ICON_MONO_32x32

Constructor Summary

Constructors

Constructor and Description

ExtendedBeanInfo(java.beans.BeanInfo delegate) Wrap the given BeanInfo instance; copy all its existing property descriptors locally, wrapping each in a custom indexed or non-indexed PropertyDescriptor variant that bypasses default JDK weak/soft reference management; then search through its method descriptors to find any non-void returning write methods and update or create the corresponding PropertyDescriptor for each one found.

Method Summary

Modifier and Type	Method and Description
private java.util.List<java.lang.reflect.Method>	findCandidateWriteMethods(java.beans.MethodDescriptor[] methodDescriptors)
private java.beans.PropertyDescriptor	findExistingPropertyDescriptor(java.lang.String propertyName, java.lang.Class<?> propertyType)
java.beans.BeanInfo[]	getAdditionalBeanInfo()
java.beans.BeanDescriptor	getBeanDescriptor()
int	getDefaultEventIndex()
int	getDefaultPropertyIndex()
java.beans.EventSetDescriptor[]	getEventSetDescriptors()
java.awt.Image	getIcon(int iconKind)
java.beans.MethodDescriptor[]	getMethodDescriptors()
java.beans.PropertyDescriptor[]	getPropertyDescriptors() Return the set of PropertyDescriptors from the wrapped BeanInfo object as well as PropertyDescriptors for each non-void returning setter method found during construction.
private void	handleCandidateWriteMethod(java.lang.reflect.Method method)
static boolean	isCandidateWriteMethod(java.lang.reflect.Method method)
private java.lang.String	propertyNameFor(java.lang.reflect.Method method)

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final Log logger

delegate

private final java.beans.BeanInfo delegate

propertyDescriptors

private final java.util.Set<java.beans.PropertyDescriptor> propertyDescriptors

Constructor Detail

ExtendedBeanInfo

public ExtendedBeanInfo(java.beans.BeanInfo delegate)

Wrap the given BeanInfo instance; copy all its existing property descriptors locally, wrapping each in a custom indexed or non-indexed PropertyDescriptor variant that bypasses default JDK weak/soft reference management; then search through its method descriptors to find any non-void returning write methods and update or create the corresponding PropertyDescriptor for each one found.

Parameters:

delegate - the wrapped BeanInfo, which is never modified

See Also:

getPropertyDescriptors()

Method Detail

findCandidateWriteMethods

private java.util.List<java.lang.reflect.Method> findCandidateWriteMethods(java.beans.MethodDescriptor[] methodDescriptors)

isCandidateWriteMethod

public static boolean isCandidateWriteMethod(java.lang.reflect.Method method)

handleCandidateWriteMethod

private void handleCandidateWriteMethod(java.lang.reflect.Method method)
                                 throws java.beans.IntrospectionException

Throws:

java.beans.IntrospectionException

findExistingPropertyDescriptor

@Nullable
private java.beans.PropertyDescriptor findExistingPropertyDescriptor(java.lang.String propertyName,
                                                                               java.lang.Class<?> propertyType)

propertyNameFor

private java.lang.String propertyNameFor(java.lang.reflect.Method method)

getPropertyDescriptors

public java.beans.PropertyDescriptor[] getPropertyDescriptors()

Return the set of PropertyDescriptors from the wrapped BeanInfo object as well as PropertyDescriptors for each non-void returning setter method found during construction.

Specified by:

getPropertyDescriptors in interface java.beans.BeanInfo

See Also:

ExtendedBeanInfo(BeanInfo)

getAdditionalBeanInfo

public java.beans.BeanInfo[] getAdditionalBeanInfo()

Specified by:

getAdditionalBeanInfo in interface java.beans.BeanInfo

getBeanDescriptor

public java.beans.BeanDescriptor getBeanDescriptor()

Specified by:

getBeanDescriptor in interface java.beans.BeanInfo

getDefaultEventIndex

public int getDefaultEventIndex()

Specified by:

getDefaultEventIndex in interface java.beans.BeanInfo

getDefaultPropertyIndex

public int getDefaultPropertyIndex()

Specified by:

getDefaultPropertyIndex in interface java.beans.BeanInfo

getEventSetDescriptors

public java.beans.EventSetDescriptor[] getEventSetDescriptors()

Specified by:

getEventSetDescriptors in interface java.beans.BeanInfo

getIcon

public java.awt.Image getIcon(int iconKind)

Specified by:

getIcon in interface java.beans.BeanInfo

getMethodDescriptors

public java.beans.MethodDescriptor[] getMethodDescriptors()

Specified by:

getMethodDescriptors in interface java.beans.BeanInfo