Guicing up Dropwizard

Dropwizard is a lightweight RESTful web service framework built by Yammer. It incorporates a collection of mature Java libraries including Jetty, Jersey, Jackson, and Metrics to provide performant and reliable production-ready services.

At my current client, we’ve been implementing an entire micro-service backend using Dropwizard to drive content to Grails and AngularJS applications. One of the things that Dropwizard lacks is a succinct dependency injection implementation for your code. The latest released version of Dropwizard (0.6.2) uses Jersey v1.17.1 which had it’s own complicated DI framework (Jersey 2.x integrates HK2 which is a JSR-330 compliant framework).

We quickly found ourselves having to configure a substantial amount of code in our services just to wire classes together while allowing us to effectively and logically separate our business logic. So we’ve started exploring DI in Dropwizard. Guice is a lightweight DI framework. It also supports JSR-330 since v3.0.

We started integration Guice by utilizing the Dropwizard-Guice library from Hubspot. Simply add the dependency to your Dropwizard project and register the module:

This simple configuration does a couple things. First, it registers the Guice bundle with Dropwizard. This is turn will automatically register the following items with Jersey from your package:

  • HealthChecks (extends HealthCheck)
  • Tasks (extends Task)
  • Resources (has a @Path annotation)
  • Managed classes (extends Managed)
  • Injectable Providers (extends InjectableProvider)
  • Providers (extends Provider)
  • Bundles (extends Bundle)

During this process, Guice will inject any necessary dependencies into these classes (for those it has to instantiate at this point). Second, it registers a providers for both the Dropwizard Environment instance and the service’s Configuration instance. Finally, it registers a GuiceComponentProviderFactory with the Jersey IoC container.

One of the big wins with Guice is that it is capable of injecting any class that either has a no-arg constructor or has a constructor that is annotated with @Inject. This can help to quickly break up logic without having a proliferation of annotations to describe how your classes are wired up.

At this point, we had Guice wired into our services but we needed a way to inject the SessionFactory from the Dropwizard-Hibernate bundle into our DAOs. If you want to see how this was accomplished, check out my Dropwizard-Guice example project on Github.

About the Author

Object Partners profile.
Leave a Reply

Your email address will not be published. Required fields are marked *

Related Blog Posts
Getting Started with CSS Container Queries
For as long as I’ve been working full-time on the front-end, I’ve heard about the promise of container queries and their potential to solve the majority of our responsive web design needs. And, for as […]
Simple improvements to making decisions in teams
Software development teams need to make a lot of decisions. Functional requirements, non-functional requirements, user experience, API contracts, tech stack, architecture, database schemas, cloud providers, deployment strategy, test strategy, security, and the list goes on. […]
JavaScript Bundle Optimization – Polyfills
If you are lucky enough to only support a small subset of browsers (for example, you are targeting a controlled set of users), feel free to move along. However, if your website is open to […]
Creating Mocks For Unit Testing in Go
Unit testing is an important part of any project, and Go built its framework with a testing package; making unit testing part of the language. This testing framework is good for most scenarios, but you […]