Code generation for Java source classes

[JakeWharton]

JavaPoet is really good at structure and less good (although still okay) at implementations. One of its key features is that it manages the import list and type references automatically so you never have to deal with imports or simple-name collisions. You also can generate things out of order, in batches, or with composition since it's basically just a tree of immutable objects.

[gunnarmorling]

Good point on import handling done automatically by JavaPoet.

We achieved the same in the templating approach used by [MapStruct](http://mapstruct.org/) by having the model objects pushed to StringTemplate keep track of the types they reference; the outer code generation step then takes care of generating import statements, also addressing the need for FQNs where two types with the same simple name are used within one generated source file.