Simple

FluentBuilder designed as simple as possible. It requires implementation of your model-specific interface only. Target classes (or model) may be present as simple POJO. No XML/JSON/etc configuration files required.

Ready for extension

There is a possibility to use your own services. However you may completely redefine builder process.

Please check at the following extension points if you like:

• BuilderIntrospector
• PropertySetter
• TargetInstantiator

Compact size

FluentBuilder is really small:

• The only one JAR artifact (24K size)
• The only one external dependency (SLF4J)

public class Product
{
    private String name;
    private Integer price;
    private Integer quantity;

    public String getName() { return name; }
    public void setName(String name) { this.name = name; }

    public Integer getPrice() { return price; }
    public void setPrice(Integer price) { this.price = price; }

    public Integer getQuantity() { return quantity; }
    public void setQuantity(Integer quantity) { this.quantity = quantity; }
}

1. You may create or use existing class.
2. Add get/set methods to turn your class into the POJO bean.

@TargetClass(Product.class)
public interface ProductBuilder<R>
		extends NestedBuilder<Product, R>
{
    public ProductBuilder<R> setName(String name);
    public ProductBuilder<R> setPrice(Integer price);
    public ProductBuilder<R> setQuantity(Integer quantity);
}

1. Create interface as shown.
2. Add @TargetClass annotation to link builder with its target type.
3. Extend interface from the NestedBuilder. It is required to marks your interface as builder and also allows to use ProductBuilder as part of subsequent calls of builder methods.
4. Copy setter methods from model class into the builder interface. Every setter method should have the same signature as used in the target type except the return type signature.

Note: The builder interface should be generic-enabled to avoid unnecessary cast and use compile time checking.

BuilderFactoryFacade factoryFacade = new DefaultBuilderFactoryFacade();
ProductBuilder builder = factoryFacade.createRootBuilder(ProductBuilder.class);
Product product = builder
	        .setName("Potato")
	        .setPrice(10)
	        .setQuantity(20)
	        .build();

1. Create instance of the DefaultBuilderFactoryFacade.
2. Create instance of the ProductBuilder.
3. Build the target instance using fluent interface.