Picocog is a lightweight and new open-source Java library created to make programmatic code generation (or metaprogramming) clean, and easy to achieve.
Code generation is the process by which source code is programmatically generated based on inputs (also known as model).
Code generation typically works as follows:
- Define a model/use an existing model.
- Interrogate model and emit/generate source-code
- (Optionally) Upon changes to the model, regenerate source-code.
A code generator designed to leverage Picocog typically utilizes a POJO model as a source of model data.
Alternative use-cases are to use annotated Java source code, via the JSR-269 features of Java (link).
For simplicity sake, this article will assume the PoJo scenario.
A sample POJO model is shown below (omitting getters/setters for brevity).
This POJO model is typically instantiated from the following types of sources:
- Via database query
- DSL (domain specific languages)
NOTE: It is important that the when instantiating the POJO model that a full set of validations are performed and assumptions tested. XML schema or a bespoke DSL implementation can ensure referential integrity and other validations.
Picocog emits text via Java code. No templates, no reflection, no tag processing. It has three core goals:
- Generate cleanly indented code easily.
- Support out-of-sequence line injection.
- Be easy to debug.
Picocog can be thought of as a code-generation-centric alternative to StringBuilder.
Picocog simply writes lines — the current indentation level is remembered.
The only class that is required is the PicoWriter class.
There is no need to manually place indents into string literals, but there is a need to flag the indent left and write lines of code via the writeln_r(), writeln_l() and writeln_lr() methods.
Sometimes it is handy to want to write to two or more locations in a document simultaneously — and have those locations have their own indentation stack. To do this, you add a placeholder via the createDeferredWriter() method.
The returned writer can be thought of as a pointer to the line on which it was created.
Customer.java (generated by Picocog):
Order.java (generated by Picocog):
Picocog is written in Java, but it can emit code in any language.
Sometimes a small implementation is all you need.
Picocog is available today on GitHub.
Another non-template based approach for code generation is the excellent xtend language.
For a more in depth discussion of code generation, see the excellent article “Code Generation For Dummies” by Matthew Fowler.
NOTE: This article is adapted (by the same author), from the following blog post on medium.com