Home

Yahhh – PostConstruct me now unt PreDestroy me lay-tuh

What is Governator?

Governator is a library of extensions and utilities that extend Google Guice to provide:

• Classpath scanning and automatic binding
• Lifecycle management
• Configuration to field mapping
• Field validation
• Parallelized object warmup/cooldown

Features

Classpath scanning and automatic binding

Governator introduces the annotations @AutoBindSingleton and @AutoBind. See the Auto Binding wiki for details.

Lifecycle management

Governator adds support for the standard annotations: @PostConstruct and @PreDestroy. See the Lifecycle Management wiki for details.

Configuration to field mapping

Governator introduces a new annotation @Configuration that can be used to annotate class fields. Governator will assign the fields using configuration from property files, etc. Another annotation is also introduced, @PreConfiguration, for methods to be called prior to configuration assignment. See the Configuration Mapping wiki for details.

Field validation

Governator supports the javax.validation annotations (JSR 303). Fields annotated with validation annotations will get validated via the Hibernate Validator library.

Parallelized object warmup/cooldown

Governator introduces two new annotations WarmUp and CoolDown. Methods annotated with WarmUp will get executed (in parallel) after injected by Guice. Methods annotated with CoolDown will get executed (in parallel) when the Governator Lifecycle is shut down. See the Warm Up and Cool Down wiki for details.

Lazy Singletons

Governator adds a LazySingleton annotation and scope. This is the opposite of Guice’s Eager Singletons. Lazy singletons are not created until just before they are to be injected regardless of Guice’s Stage.

Generic Binding Annotations

The com.netflix.governator.annotations.binding package contains a set of generic binding annotations that you might find useful. These might be more clear and more maintainable to users than using Guice’s @Named. The full set can be found here: binding-annotations

Requirements/Prerequisites

It’s assumed that you are familiar with Google Guice.

Acknowledgements

Governator is based on ideas developed for the Proofpoint Platform library.

Maven / Artifacts

Governator binaries are published to Maven Central.

GroupID/Org	com.netflix.governator
ArtifactID/Name	governator