Thursday, March 3, 2011

Persistence with JPA and Hibernate using Guice 3.0 and guice-persist

Why do I like Google frameworks? Because they are academic-like: elegant, concise, focused, open to extension so they evolve gradually and naturally. Why I don't like Google frameworks? Because they are academic-like: barely documented, lack in visual design and appearance.

Google Guice is no exception. It's been around probably as long as Spring. Anyone looking for DI framework must give it a shot. But even today you hear Spring not Guice when people talk DI.

Using JPA with Spring before I firmly decided to stick with Guice this time. I have simple back-end program: no web, no application server (PostgreSQL database and Hibernate as a JPA 1.0 provider).

I decided to take advantage of the latest JPA support in Guice: guice-persist. Guice 3.0 is required (upgrade from 2.0 if necessary) but Guice jar doesn't contain guice-persist: have both dependencies in your pom.xml when using Maven (updated):
Without Maven simply follow your regular practices to add jars above to Java classpath.

Existing Guice configuration using module(s) need not change, but add guice-persist module when creating injector. Before:
Injector injector = Guice.createInjector(new MyAppModule());
Injector injector = Guice.createInjector(new MyAppModule(), 
                          new JpaPersistModule("myapp-db"));
myapp-db is a persistence unit defined in persistence.xml placed on classpath (e.g. in Maven project it's in src/main/resources/META-INF directory):


This is JPA 1.0 persistence unit - you should be able to use 2.0 without any problems. I disabled scanning of classpath for entities using exclude-unlisted-classes: all JPA entities should be listed with class element now. The properties are specific to Hibernate and PostgreSQL.

guice-persist works via PersistService that has to be started (initialized). I do it immediately after initializing injector and using injector:

Injector injector = Guice.createInjector(new MyAppModule(), 
                          new JpaPersistModule("myapp-db"));
public class ApplicationInitializer {
 @Inject ApplicationInitializer(PersistService service) {
  // At this point JPA is started and ready.

  // other application initializations if necessary

Persistence unit defined transaction-type="RESOURCE_LOCAL" to have JPA EntityManager created and destroyed for each database transaction. Define both EntityManager and transactions in DAO class with the following Guice annotations:
public class MyAppDAO {
    private EntityManager em;

    public MyEntity find(long id) {
        return em.find(MyEntity.class, id);

    public void save(MyEntity entity) {
We injected EntityManager with and declared transactions with annotations. Now, each time find or save method called new transaction is started and committed in JPA entity manager. For more details on transaction scope (unit of work) and exception handling see this.

Wrapping it up: there is bare minimum of artifacts/configuration needed on top of standard JPA persistence.xml: new Guice persistence module (provided by guice-persist), persistence service initialization, standard Guice injection of EntityManager, and new @Transactional annotation. Of course, your mileage may vary depending on your transactional (unit of work) needs but it's hard to imagine less configuration and code when implementing data access with JPA and Hibernate.

For completeness I add a Guice module here (it needs no special configuration for guice-persist though, so I have DAO configuration here only):
public class MyAppModule extends AbstractModule {
    protected void configure() {
Using JPA with Guice Persist
Hibernate with JPA Annotations and Guice


Cristiano GaviĆ£o said...

Hi, nice article. Just to let you know that google jars for persistence already are in maven official repo with the group.


Gregory Kanevsky said...

Cristiano, thanks. I'll make the changes then and update the blog.

sekaran said...

It will be of greater use if the sample contains the Module file also

Gregory Kanevsky said...

Update: up-to-date maven dependencies and added Guice module for completeness.

Andrew Kryvko said...

Great article! Thank you!

Piotr Sobczyk said...

Nice article. Just two questions regarding persistence.xml.

"I disabled scanning of classpath for entities using exclude-unlisted-classes: all JPA entities should be listed with class element now" - what's the advantage of it? I wrote a sample app with guice relying on auto scanning and it seems to be working just fine. Are there any dangers of using scanning?

Second questiion is, wouldn't it be better to use JPA standard properties like javax.persistence.jdbc.user, javax.persistence.jdbc.password etc instead of Hibernate specific ones?

Thanks in advance.

Jason Huang said...

can i make the DaoImple "singleton" , i guess this might save lots of resource if this "singleton" don't make any hurt .

prathap kumar said...

Interesting Article

Spring Hibernate Training Online | Hibernate Training in Chennai

Hibernate Training Online | Java Online Course