Welcome to dropwizard-guicey¶
Guice 5.1.0 integration for dropwizard 2.1.1.
Compiled for java 8, compatible with java 11 - 17.
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.
Documentation Summary¶
Introduction¶
- Getting started guide describes installation and provides core usage examples
- Concepts overview guide introduces core guicey concepts and demonstrates differences from pure dropwizard usage
- Guice the essence of guice integration
- Testing describes integration testing techniques
- Decomposition guide on writing re-usable modules
Reference¶
- User guide contains detailed feature descriptions. It is good to read, but it also functions well as a reference if you're short on time.
- Installers describes all guicey installers. Use it as a extensions hand book.
- Modules external extension modules overview.
- Examples important usage examples.
Sources structure¶
- Guicey repository: guicey itself and (these) docs
- Modules repository: extension modules (integrations) are maintained in the separate repository
- Examples repository: holds code samples for main features dropwizard bundles and extension modules.