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 {@code Introspector} will discover the {@code getFoo} read method, but will bypass the {@code #setFoo(Foo)} write method, because its non-void returning signature does not comply with the JavaBeans specification. {@code 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 {@code } XML. {@link #getPropertyDescriptors()} returns all existing property descriptors from the wrapped {@code 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

See Also:

ExtendedBeanInfo(BeanInfo), ExtendedBeanInfoFactory, CachedIntrospectionResults

Field Summary

Fields

Modifier and Type	Field and Description
private java.beans.BeanInfo	delegate
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

Methods

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

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)
                 throws java.beans.IntrospectionException

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

Throws:

java.beans.IntrospectionException - if any problems occur creating and adding new property descriptors

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

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