Class FluentPropertyBeanIntrospector
- All Implemented Interfaces:
- BeanIntrospector
 An implementation of the BeanIntrospector interface which can detect write methods for properties used in fluent API scenario.
 
A fluent API allows setting multiple properties using a single statement by supporting so-called method chaining: Methods for setting a property value do not return void, but an object which can be called for setting another property. An example of such a fluent API could look as follows:
 public class FooBuilder {
     public FooBuilder setFooProperty1(String value) {
        ...
        return this;
    }
     public FooBuilder setFooProperty2(int value) {
        ...
        return this;
    }
 }
 
 
 Per default, PropertyUtils does not detect methods like this because, having a non-void return type, they violate the Java Beans
 specification.
 
 This class is more tolerant with regards to the return type of a set method. It basically iterates over all methods of a class and filters them for a
 configurable prefix (the default prefix is set). It then generates corresponding PropertyDescriptor objects for the methods found which use
 these methods as write methods.
 
 An instance of this class is intended to collaborate with a DefaultBeanIntrospector object. So best results are achieved by adding this instance as
 custom BeanIntrospector after the DefaultBeanIntrospector object. Then default introspection finds read-only properties because it does not
 detect the write methods with a non-void return type. FluentPropertyBeanIntrospector completes the descriptors for these properties
 by setting the correct write method.
 
- Since:
- 1.9
- 
Field SummaryFields
- 
Constructor SummaryConstructorsConstructorDescriptionCreates a new instance ofFluentPropertyBeanIntrospectorand sets the default prefix for write methods.FluentPropertyBeanIntrospector(String writePrefix) Creates a new instance ofFluentPropertyBeanIntrospectorand initializes it with the prefix for write methods used by the classes to be inspected.
- 
Method SummaryModifier and TypeMethodDescriptionReturns the prefix for write methods this instance scans for.voidintrospect(IntrospectionContext icontext) Performs introspection.
- 
Field Details- 
DEFAULT_WRITE_METHOD_PREFIXThe default prefix for write methods.- See Also:
 
 
- 
- 
Constructor Details- 
FluentPropertyBeanIntrospectorpublic FluentPropertyBeanIntrospector()Creates a new instance ofFluentPropertyBeanIntrospectorand sets the default prefix for write methods.
- 
FluentPropertyBeanIntrospectorCreates a new instance ofFluentPropertyBeanIntrospectorand initializes it with the prefix for write methods used by the classes to be inspected.- Parameters:
- writePrefix- the prefix for write methods (must not be null)
- Throws:
- IllegalArgumentException- if the prefix is null
 
 
- 
- 
Method Details- 
getWriteMethodPrefixReturns the prefix for write methods this instance scans for.- Returns:
- the prefix for write methods
 
- 
introspectPerforms introspection. This method scans the current class's methods for property write methods which have not been discovered by default introspection.- Specified by:
- introspectin interface- BeanIntrospector
- Parameters:
- icontext- the introspection context
- Throws:
- IntrospectionException- if an error occurs
 
 
-