Welcome to dropwizard-guicey¶
Guice 5.0.1 integration for dropwizard 2.0.20.
Compiled for java 8, binary compatible with java 11.
Release Notes - History - Javadoc - Support - License
If you migrate from dropwizard 1.x then see dropwizard upgrade instructions and guicey migration guide.
Main features¶
- Auto configuration from classpath scan and guice bindings.
- Yaml config values bindings by path or unique sub objects.
- Advanced Web support
- Dropwizard style console reporting: detected (and installed) extensions are printed to console to remove uncertainty
- Test support: custom junit and spock extensions
- Developer friendly:
- core integrations may be replaced (to better fit needs)
- rich api for developing custom integrations, and hooking into lifecycle)
- out of the box support for plug-n-play plugins (auto discoverable)
- diagnostic tools (reports), support for custom diagnostic tools
Sponsors¶
If guicey makes your life easier, you can support its development.
How to use docs¶
Introduction¶
- Getting started guide describes installation and shows core usage examples
- Concepts overview guide introduce core guicey concepts and explains differences with pure dropwizard usage
- Gucie the essence of guice integration
- Testing describes integration testing techniques
- Decomposition guide on writing re-usable modules
Reference¶
- User guide contain detailed features descriptions. Good to read, but if no time, read as you need it.
- Installers describes all guicey installers. Use it as a extensions hand book.
- Modules extension modules
- Examples important usage examples. Look also examples repository for additional examples.
Sources structure¶
- Guicey repository: guicey itself and (this) docs
- Modules repository: extension modules (integrations) are maintained in the separate repository
- Examples repository holds usage examples of main features usage, dropwizard bundles integrations and extension modules samples.