Plume is an encapsulation of the best available JVM libraries to get a project up and running quickly.
Key concepts:
A concrete example of how Plume works is the Plume Mail module:
MailerProvider
class implements the jakarta.inject.Provider
interface to expose the Simple Mail Java Mailer
object.In this way, it is easy to replace most of the components suggested by Plume. The only "strong" requirement is to provide dependency injection objects using jakarta.inject
.
Plume is maintained by Coreoz and licensed under Apache License 2.0.
In developing Plume, we strive to keep the project and its dependencies as small and lightweight as possible. Making Plume lightweight helps reduce the complexity of the system and the risk of security issues. This means that Plume will help projects have the lowest maintenance and evolution costs.
In addition:
Sample projects can be found here: https://github.com/Coreoz/Plume-showcase.
The best way to get started is to use a Maven archetype for Plume.
Plume requires at least Java 17.
If you are not familiar with the dependency injection concept, read the Guice Motivation Guice.
Dependency injection takes a central place in Plume. Indeed, all modules provided by Plume contain injectable objects. To use these injectables objects, the default choice is Guice: it is really easy to use.
If you are already familiar with Guice, you may want to have a look at Dagger which enables to detect dependency injection problems at compile time. To use Dagger the annotation processor should be enabled in your IDE: https://immutables.github.io/apt.html. However, note that Dagger may be more difficult to use than Guice.
In Plume documentation, examples use Guice modules.
Most of the time there is a corresponding Dagger module to each Guice module.
For example, the corresponding Dagger module for GuiceConfModule
is DaggerConfModule
.
Reference all libraries versions used by Plume.
It will help you avoid dependency conflicts in your pom.xml
file.
This module is based on the Config library and handles the application configuration.
Enables to build REST web-services with Jersey and expose the documentation with Swagger.
This module can be used with Plume Jersey monitoring to quickly setup application monitoring exposure.
Common services that are often needed in projects or libraries.
Expose a Mailer
object from Simple Java Mail
through a Config configuration.
Enables to easily execute recurring tasks/jobs through Wisp Scheduler.
Basic utilities to pool SQL connections with HikariCP and manage transactions.
Integration with Querydsl for SQL only (no JPA :).
Code generation for Querydsl for SQL only.
Use Flyway to help you make integration tests with a database.
If you need an HTTP client in a Plume application, a good choice is to use:
See upgrade instructions in the release details.
See upgrade instructions in the release details.
See upgrade instructions in the release details.