Library to build your POJO entities in a very easy and builder intuitive way.

Most of the time when I am writing my tests I have the need to write clean and readable tests. One way that I found is by having Test Builder but normally it takes time and are difficult to mantain in time. So after looking around I came up with this library to help you to create your pojo in a different and easy way.

There are several ways to use it but the most flexible for me is creating a Class Builder that contains all the logic to create the objects. The same example you can find in the lib tests.

public class PojoBuilder {

    public static Field<String> name = new Field<>();
    public static Field<String> value = new Field<>();

    public static Field<String> name2 = new Field<>("defaultName");
    public static Field<String> value2 = new Field<>("defaultValue");

    public static Creator<Pojo> creator = lookUp -> new Pojo(lookUp.get(name, "defaultName"),
            lookUp.get(value, "defaultValue"));

    public static Creator<Pojo> creatorWithPredefinedDefaults = lookUp -> new Pojo(lookUp.get(name2),
            lookUp.get(value2));

}

There many things going on there. but I will try to explain it in the best way that I can. There are two concepts to keep in mind, Field, Creator and LookUp.

The Creator implements method build that should contains how the object is going to be build.

The Field represent the value that you want to change by using the DSL in the construction of your objects.

In charge of binding the Field instance and getting the corresponding value in the creator class.

In the example above the Creator is building a pojo using the constructor method and it is using the lookUp instance to get the corresponding value.

public static Field<String> name = new Field<>();
public static Field<String> value = new Field<>();

new Pojo(lookUp.get(name, "defaultName"), 
            lookUp.get(value, "defaultValue")

the lookUp method is using a Field instance as first parameter and the second parameter to define what the default value will be in case that we don't set it by the DSL. The other way to set the default value is by setting at the construction of the field it self so at the lookUp level you don't have to pass it.

public static Field<String> name2 = new Field<>("defaultName");
public static Field<String> value2 = new Field<>("defaultValue");

new Pojo(lookUp.get(name2),
            lookUp.get(value2));

At the end you would use this from tests like this:

Pojo pojo = Builder.build()
                .entity(PojoBuilder.creator)
                .override(PojoBuilder.name, "nameoverrideed")
                .override(PojoBuilder.value, "valueoverrided")
                .get();

The library is highly inspired by

[https://github.com/npryce/make-it-easy] And AssertJ

Make It Ease lib provides a Hamcrest style DSL but I am more fun of using a builder kind of DSL like AssertJ that offers straight away the option that I can use. I want to say thank you to all the collaborator of MakeItEasy project.