A dynamic builder pattern tool for Java.

README - EasyBuilder 1.0

EasyBuilder is licensed under the MIT License, see LICENSE file.

EasyBuilder is a utility package that allows you to quickly create Builders for your applications objects. EasyBuilder has been built and tested with JDK 1.4 and JDK 1.5. It relies on the Objenesis 1.1 library. If you have Aspect-J (1.5.4) you can also use the TracingAspect to generate logging information. Logging is supported through SLF4J 1.5.8 and uses the 'Simple Logger' by default.

Add the following jars to your classpath;

• easybuilder-1.0.jar
• objenesis-3.2.jar

Optionally you may include

• aspectjrt-1.9.9.1.jar
• slf4j-api-2.0.3.jar
• slf4j-simple-2.0.3.jar

EasyBuilder establishes a simple DSL for the builder pattern.

The first step is to create the EasyBuilder instance. To do this, use the constructor to specify the target type to be built, e.g.

	new EasyBuilder(SomeClass.class);

Once you've created the builder, apply the builder DSL methods to establish the assembly instructions for the target class. Once all of the instructions have been created, call the build() method to assemble the object.

Your best examples are in the EasyBuilderTest.java file, however, the simplest usage pattern is as follows;

EasyBuilder builder = new EasyBuilder(SomeNonJavaBean.class);
builder.builder.bypassConstructor();
builder.setField("param1", "someValue");
builder.setField("param2", 42);
SomeNonJavaBean anotherNonBean = (SomeNonJavaBean) builder.build();

EasyBuilder builder = new EasyBuilder(SomeNonJavaBean.class) {
	{
		bypassConstructor();
		setField("param1", "someValue");
		setField("param2", 42);
	}
};
SomeNonJavaBean anotherNonBean = (SomeNonJavaBean) builder.build();

Using AspectJ you can trace the internal activity of EasyBuilder.