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

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

Fields
Modifier and Type	Field and Description
`private java.beans.BeanInfo`	`delegate`
`private java.util.Set<java.beans.PropertyDescriptor>`	`propertyDescriptors`

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

All Methods Static Methods Instance Methods Concrete 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 `PropertyDescriptor`s from the wrapped `BeanInfo` object as well as `PropertyDescriptor`s 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

Class ExtendedBeanInfo

Field Summary

Fields inherited from interface java.beans.BeanInfo

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

delegate

propertyDescriptors

Constructor Detail

ExtendedBeanInfo

Method Detail

findCandidateWriteMethods

isCandidateWriteMethod

handleCandidateWriteMethod

findExistingPropertyDescriptor

propertyNameFor

getPropertyDescriptors

getAdditionalBeanInfo

getBeanDescriptor

getDefaultEventIndex

getDefaultPropertyIndex

getEventSetDescriptors

getIcon

getMethodDescriptors