Awesome Java Annotation Processing
Java Annotation Processing (defined by JSR 269) is a standardized API for hooking into the Java compiler, allowing you to validate the code under compilation and generate additional (source or byte) code. This Awesome List aims at providing an overview of helpful resources around that API, including existing useful annotation processors, related presentations and blog posts, implementation best practices etc.
Existing Annotation Processors
Existing annotation processors for different purposes
-
dekorate - Generates manifests for Kubernetes/OpenShift.
-
Dagger - Compile-time dependency injection framework for both Java and Android.
-
derive4j - Java 8 annotation processor and framework for deriving algebraic data types constructors, pattern-matching, folds, optics and typeclasses.
-
domino-jackson - Generates Jackson based JSON mappers where the same mapper can be used on the JVM/android or GWT client Javascript code.
-
domino-rest - Generates rest clients from JaxRs compatible interfaces.
-
Duzzt - Duzzt - Annotation-based Embedded DSL Generator for Java.
-
Google Auto - A collection of source code generators for Java.
-
Gson Path - A Java annotation processor library which generates gson type adapters using basic JsonPath style annotations.
-
Hibernate Validator annotation processor - Compile-time checking of Bean Validation constraints.
-
JPA Static Metamodel Generator - Creates JPA 2 static metamodel classes.
-
Immutables - Java annotation processors to generate simple, safe and consistent value objects.
-
MapStruct - Compile-time generator for type-safe bean-to-bean mapping code.
-
Micronaut - A modern full-stack framework for building modular, easily testable microservice and serverless applications.
-
Sundrio - A collection of apt-based code generating tools, including advanced builder generator, dsl generator, velocity transformer and etc.
-
Viper - A generator and a framework for injecting configurations via the java EE’s CDI. Put all your configuration keys in an enum, and make viper inject the configurations in your beans.
Android
Annotation processors specific to Android development
-
Butter Knife - Bind Android views and callbacks to fields and methods.
-
Parceler - Android Parcelables made easy through code generation.
Useful Tools
Useful tools and libraries for implementing annotation processors
-
Compile Testing - Testing tools for javac and annotation processors.
-
JavaPoet - A Java API for generating .java source files.
-
Hickory - An annotation processor for generating "prisms", allowing to access known annotation types without class references.
Slide Decks and Recordings
Blog Posts and Articles
Related Concepts
APIs and tools going beyond what’s doable with JSR 269
-
Spoon - Source Code Analysis and Transformation for Java (allows for AST modifications, too)
-
javac Plug-in API (allows for full AST inspection)
-
Project Lombok - Generates boilerplate Java code like getters/setters and equals/hashCode methods.