@MappedSuperclass with JPA and Hibernate

@MappedSuperclass with JPA and Hibernate

As your application expands, so too does the complexity of your data model. You'll come across entities that share common attributes or behaviors, leading you to consider inheritance. However, inheritance in JPA and Hibernate can be a bewildering jungle, rife with confusion and pitfalls. This is where the @MappedSuperclass annotation comes to the rescue, serving as your reliable machete to help you traverse the landscape effortlessly.

What is @MappedSuperclass?

Imagine a base class containing properties and methods common to several entities. Instead of duplicating these elements in each subclass, you can mark the base class with @MappedSuperclass. This informs JPA and Hibernate to include its fields and methods in the mapping of its subclasses, promoting code reusability and maintainability.

Advantages of Utilizing @MappedSuperclass in Your Code

  • Minimize Code Duplication: By using @MappedSuperclass, you can effectively eliminate the need to repeatedly include shared fields and methods in each subclass. This results in a more concise and easier-to-understand codebase.

  • Encourage Consistency Across Entities: Implementing @MappedSuperclass ensures that common attributes maintain the same mapping and behavior throughout all related entities. This significantly reduces the risk of encountering inconsistencies within your code.

  • Streamline Maintenance Efforts: When you make changes to the base class marked with @MappedSuperclass, those modifications automatically propagate to all of its subclasses. This saves you valuable time and effort, as you won't need to manually update each subclass individually.

  • Enhance Code Readability: Utilizing @MappedSuperclass allows you to separate shared logic from subclass-specific details. This results in a more organized code structure that is easier to reason about and navigate.

  • Promote Code Reusability and Maintainability: By centralizing common properties and methods in a base class marked with @MappedSuperclass, you encourage code reusability and maintainability. This approach allows you to easily update shared logic without having to modify multiple subclasses, ultimately making your code more efficient and manageable.

  • Facilitate Easier Collaboration: When working with a team of developers, using @MappedSuperclass can help ensure that everyone is on the same page regarding shared attributes and methods. This can lead to a more consistent and coherent codebase, making it easier for team members to collaborate and contribute effectively.

When to Use @MappedSuperclass

  • When multiple entities share the same fundamental attributes and behaviors.

  • When you want to enforce consistency in mapping and accessing common attributes.

  • When you expect future subclasses to share the same common characteristics.


Imagine you have entities for Employee, Customer, and User, all sharing fields such as name, email, and creationDate. By using @MappedSuperclass in a dedicated BaseEntity class, you can define these fields and their mappings, resulting in cleaner and more maintainable code.

Here is a Code Example:

To begin with, I create a BaseEntity class that encompasses all the common fields shared by my other tables. This class serves as a foundation for the entities in my application, such as Employee, Customer, and User, by providing a centralized location for the shared fields. By doing so, I can ensure that these fields, such as name, email, and creation Date, are consistently defined and mapped across all relevant entities.

package dev.lehnertchristian.mapped.db.tables;

import jakarta.persistence.*;

import java.util.Date;

public class BaseEntity {
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
    private String email;

    @Column(name = "creation_date")
    private Date creationDate;

    // Getters and setters are cut in this example

With the foundation laid by the BaseEntity class, we can now proceed to create additional tables for our application. In this particular example, we will be creating two new tables: Customer and Employee. These tables will inherit the properties and structure from the BaseEntity class, allowing us to maintain a consistent data model throughout our application. By doing so, we can ensure that all our tables have a unique identifier, a name, an email, and a creation date, while also making it easier to add new tables in the future if needed.

package dev.lehnertchristian.mapped.db.tables;

import jakarta.persistence.Entity;

public class Employee extends BaseEntity {

    private String department;
    private String jobTitle;

    // Getters and setters are cut in this example
package dev.lehnertchristian.mapped.db.tables;

import jakarta.persistence.Entity;

public class Customer extends BaseEntity {

    private String address;
    private String phoneNumber;
    // Getters and setters are cut in this example


In conclusion, the @MappedSuperclass annotation in JPA and Hibernate is a powerful tool for managing data models in an application. It promotes code reusability, maintainability, and consistency by allowing common attributes and methods to be defined in a single base class, which is then inherited by subclasses. This approach not only reduces code duplication and streamlines maintenance efforts, but also enhances code readability and facilitates easier collaboration among developers. When used effectively, @MappedSuperclass can greatly simplify the task of developing and managing complex data models, making it an essential tool for any developer working with JPA and Hibernate.

Did you find this article valuable?

Support Christian Lehnert by becoming a sponsor. Any amount is appreciated!