Hibernate Session Factory and Entity Life Cycle Management

Khandker Tanvir Hasan
4 min readAug 29, 2024

--

Photo by Eddie Kopp on Unsplash

Hibernate Session Factory:

The Hibernate Session Factory is a central component in the Hibernate ORM framework that serves as a factory for creating Hibernate Sessions. It’s responsible for managing database connections, transactions, and entity life cycle operations. It’s a heavyweight object that’s typically created once per application and reused throughout its lifecycle.

Responsibilities of the Session Factory:

  • Configuration Management: The Session Factory reads and parses the Hibernate configuration file (hibernate.cfg.xml or a Java-based configuration class), which contains information about database connections, dialects, mapping files, and other settings.
  • Session Creation: It creates Hibernate Session objects, which represent a unit of work with the database. Each session is associated with a transaction and is used to interact with database entities.
  • Caching: The Session Factory manages various caches, including the first-level cache (associated with a session) and the second-level cache (shared across multiple sessions). These caches improve performance by storing frequently accessed data in memory.
  • Transaction Management: While the Session Factory itself doesn’t handle transactions directly, it provides the necessary infrastructure for transaction management. Transactions are typically managed at the session level using methods like beginTransaction() and commit().

Hibernate Sessions:

Hibernate Sessions are lightweight objects that represent a unit of work with the database. Each session is associated with a transaction and is used to interact with database entities.

Responsibilities:

  • Entity Management: Sessions track changes made to entities and ensure that they are synchronized with the database when the transaction is committed.
  • Transaction Management: Transactions are initiated and committed within a Session.
  • Query Execution: Sessions execute Hibernate Query Language (HQL) or Criteria API queries to retrieve and manipulate data.
  • Caching: Sessions leverage the first-level cache to improve performance by storing recently accessed entities.

Entity Life Cycle Management

In Hibernate, entities represent objects that correspond to database records. The life cycle of an entity can be broadly divided into four stages:

  1. Transient: An entity that has not been persisted to the database. It has no identifier and is not associated with a session.
  2. Persistent: An entity that is associated with a session and has been persisted to the database. It has an identifier.
  3. Detached: An entity that was once persistent but is no longer associated with a session. It retains its identifier and can be reattached to a session at a later time.
  4. Removed: An entity that is marked for deletion and will be removed from the database when the transaction is committed.

Hibernate Session Factory and Entity Life Cycle

The Session Factory plays a crucial role in managing the life cycle of entities. It provides the necessary context and mechanisms for persisting, updating, deleting, and retrieving entities.

Operations and Their Impact on Entity Life Cycle:

  • save(): This method persists a transient entity to the database, transitioning it to the persistent state.
  • update(): This method updates a detached entity, reattaching it to the session and making it persistent again.
  • delete(): This method marks a persistent entity for deletion, transitioning it to the removed state.
  • merge(): This method merges a detached entity with a persistent entity of the same identifier. If there are conflicts, the persistent entity takes precedence.
  • get(): This method retrieves a persistent entity from the database based on its identifier. If the entity is not found, it returns null.
  • load(): This method retrieves a persistent entity from the database based on its identifier. If the entity is not found, it throws an ObjectNotFoundException.
Session session = sessionFactory.openSession();
Transaction tx = session.beginTransaction();

// Persist a new employee
Employee employee = new Employee("John Doe");
session.save(employee);

// Update the employee's salary
employee.setSalary(50000);
session.update(employee);

// Delete the employee
session.delete(employee);

tx.commit();
session.close();

Additional Considerations:

  • First-Level Cache: The Session Factory maintains a first-level cache associated with each session. This cache stores recently accessed entities to improve performance.
  • Second-Level Cache: The Session Factory can also optionally configure a second-level cache that is shared across multiple sessions. This can further enhance performance, but requires careful configuration to avoid inconsistencies.
  • Lazy Loading: Hibernate supports lazy loading, which means that related entities are not fetched from the database until they are actually accessed. This can improve performance in scenarios where only a subset of an entity’s data is needed.

The Role of the Session:

While the Session Factory provides the overall context, it’s the Hibernate Session that directly interacts with entities and manages their life cycle within a transaction. A Session represents a unit of work and is responsible for:

  • Tracking changes: The Session keeps track of changes made to persistent entities and ensures that they are synchronized with the database when the transaction is committed.
  • Managing transactions: Transactions are initiated and committed within a Session.
  • Interacting with entities: The Session provides methods to persist, update, delete, and retrieve entities.

Necessary Points to Remember:

  • The Session Factory is a heavyweight object that is typically created once per application.
  • The Session is a lightweight object that is associated with a transaction and is used to interact with entities.
  • The Session Factory manages the creation and lifecycle of Sessions.
  • The Session is responsible for managing the life cycle of entities within a transaction.

Understanding the relationship between the Session Factory and the Session, as well as the key operations involved in entity life cycle management is very crucial to effectively leverage Hibernate’s capabilities in your applications.

--

--

Khandker Tanvir Hasan

I'm a software engineer working with Java and different Java based technologies since 2018. I write mostly about software engineering as well as programming.