Spring Boot & Spring Data: how are Hibernate Sessions managed?

Alan47 picture Alan47 · Sep 7, 2014 · Viewed 27.3k times · Source

I am currently working on an application that uses Spring Boot and Spring Data (its JpaRepository interfaces to be precise) together with Hibernate.

One thing I love about Hiberante is its caching feature - when you submit multiple queries that match a particular object, you will get back the same instance of that object on every query execution (with respect to Java's == operator). However, when using Spring Data and JpaRepository classes, this does not always seem to be the case. For that reason, I assume that there are multiple HibernateSession instances at work here.

My question therefore is: how does Spring Data handle Hibernate Sessions? When does it open or close them? Is there a way to configure it to use the same session for the entire runtime of my application to make full use of Hibernate's object cache? Is there a reason not to do it that way?

Thanks,

Alan

Answer

Alan47 picture Alan47 · Sep 7, 2014

I think I've found the answer myself. If somebody finds this question, here's my answer.

How does Spring manage Hibernate Sessions?

By default, Spring Boot applies transaction management at the repository level. In this case, when calling a JpaRepository method (or in general any Repository method), Spring will:

  • Ask the SessionFactory to create a new session
  • Open this session
  • Open a transaction
  • Perform the called Repository method
  • Close the transaction
  • Close the session

However, if you apply @Transactional to the service class or method, Spring will open the session and the transaction on entry to the service method, and the repository method will be performed within the existing transaction.

What are the consequences?

As a programmer...

  • you do not need to concern yourself with transactions or sessions at all.
  • if you want to rely on Hibernate's caching functionality, you must specify @Transactional on a larger scope than the repository. Caching only works within the same HibernateSession.
  • you must decide the equivalence of your @Entity objects by their Hibernate ID value, rather than by using Java's == operator.
  • you need to take care that lazy collections (for example in an @OneToMany reference) in your @Entity classes (see FetchMode.LAZY as opposed to FetchMode.EAGER) are used exclusively within an @Transactional-annotated method

Also for reference, the following link has been quite helpful: Multiple Transactions in single session

As with many other aspects of Spring, there is a lot to be gained here, if you are willing to sacrifice direct control over your application.