save vs saveOrUpdate in Hibernate

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (178K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

<< Back to Hibernate Tutorial

In Hibernate, both save and saveOrUpdate methods are used to store an object in the database, but they are used in different scenarios and have different behaviors. In this post, we will discuss the difference between Session.save() and Session.saveOrUpdate() methods in Hibernate with an example.

Learn the Hibernate ORM framework at Learn Hibernate Framework

save Method 

Behavior: Inserts the object into the database. 

Identifier Generation: If the object's identifier (primary key) is not set, Hibernate will generate one based on the defined generation strategy. 

Exception Handling: If the object with the same identifier already exists in the database, calling save will result in a primary key violation, leading to an exception. 

Use Case: Typically used when you want to save a new entity and are relying on Hibernate to generate the identifier. 

saveOrUpdate Method 

Behavior: Depending on the object's state, this method will either save a new object or update an existing one. 

Identifier Checking: If the identifier is null, it considers the object as transient and will save it. If the identifier is not null, it will check the session to see if the object is already associated; if it is, it will update the existing object. 

Exception Handling: This method does not generally throw an exception due to identifier conflicts, as it will update the existing record if it finds one. 

Use Case: Use this method when you want to either save a new entity or update an existing one, and you are not sure whether the object is already present in the database or not. 

Session save and saveOrUpdate Method Examples

Session.save() method example: 

The below code uses Session.save() method to insert a new record into a database:

public void saveExample(Student student) {
    Transaction transaction = null;
    try (Session session = HibernateJavaConfig.getSessionfactory().openSession()) {

        // start the transaction
        transaction = session.beginTransaction();

        // save student entity
        Serializable id = session.save(student);
        System.out.println("database table id -> " + id);
        // commit transaction
        transaction.commit();

    } catch (Exception e) {
        if (transaction != null) {
            transaction.rollback();
        }
    }
}

Session.saveOrUpdate() method example: 

The below code uses Session.saveOrUpdate() method INSERT or UPDATE a record based on the existence of the record in a database.

public void saveOrUpdateExample(Student student) {
      Transaction transaction = null;
      try(Session session = HibernateJavaConfig.getSessionfactory().openSession()){
   
         // start the transaction
         transaction = session.beginTransaction();
   
         // first save student entity using saveOrUpdate() method
         session.saveOrUpdate(student);   
   
         // get the student object
         Student student2 = session.get(Student.class, student.getId());
   
         // update the student2 object   
         student2.setFirstName("Prabhas");
         student2.setEmail("prabhas@gmail.com");
   
         // update student entity using saveOrUpdate() method
         session.saveOrUpdate(student2);
   
         // commit transaction
         transaction.commit();
   
     }catch (Exception e) {
         if(transaction != null) {
          transaction.rollback();
      }
} 

Summary

Here's a table summarizing the key differences:

Feature	save() Method	saveOrUpdate() Method
Behavior	Inserts the object	Inserts or updates the object
Identifier Generation	Generates if not exist	Saves if null, updates if not null
Exception Handling	Throws an exception if the identifier exists	Updates if identifier exists
Use Case	Saving new entities	Saving new entities or updating existing ones

Related Posts

• Hibernate - Difference Between get and load Method with an Example
• Hibernate - Difference Between save and saveOrUpdate Method with an Example
• Hibernate - Difference Between save and persist Method with an Example

My Top and Bestseller Udemy Courses. The sale is going on with a 70 - 80% discount. The discount coupon has been added to each course below:

Build REST APIs with Spring Boot 4, Spring Security 7, and JWT

🆕 High-Demand 80–90% OFF

[NEW] Learn Apache Maven with IntelliJ IDEA and Java 25

🆕 High-Demand 80–90% OFF

ChatGPT + Generative AI + Prompt Engineering for Beginners

🚀 Trending Now 80–90% OFF

Spring 7 and Spring Boot 4 for Beginners (Includes 8 Projects)

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Real-Time REST APIs with Spring Boot - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Microservices with Spring Boot and Spring Cloud

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Java Full-Stack Developer Course with Spring Boot and React JS

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Build 5 Spring Boot Projects with Java: Line-by-Line Coding

🌟 Top Rated 80–90% OFF

Testing Spring Boot Application with JUnit and Mockito

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot Thymeleaf Real-Time Web Application - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Master Spring Data JPA with Hibernate

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot + Apache Kafka Course - The Practical Guide

🎓 Student Favorite 80–90% OFF
Available in Udemy for Business

Java Testing: Mastering JUnit 5 Framework

🆕 New 80–90% OFF

Reactive Programming in Java: Spring WebFlux and Testing

🌟 Top Rated 80–90% OFF

Spring Boot + RabbitMQ Course - The Practical Guide

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Functional Programming in Java (Includes Java Collections)

🎓 Student Favorite 80–90% OFF

ChatGPT for Java Developers: Boost Your Productivity with AI

🚀 Trending Now 80–90% OFF