Join fetch for optimization in Spring Boot

Introduction

Join fetch helps load related data in one go. It avoids extra database calls, making your app faster.

When you want to get an object and its related objects together.

When you want to avoid slow performance caused by many small database queries.

When you have a parent-child relationship and want to load both at once.

When you want to reduce the number of database trips in your app.

When you use JPA or Hibernate and want to optimize data fetching.

Syntax

Spring Boot

SELECT p FROM ParentEntity p JOIN FETCH p.childEntities WHERE p.id = :id

Use JOIN FETCH in JPQL to load related entities eagerly in one query.

Replace ParentEntity and childEntities with your actual entity and field names.

Examples

Loads an Order and its Items together to avoid extra queries.

Spring Boot

SELECT o FROM Order o JOIN FETCH o.items WHERE o.id = :orderId

Fetches Customer and their Address in one query for faster access.

Spring Boot

SELECT c FROM Customer c JOIN FETCH c.address WHERE c.name = :name

Sample Program

This Spring Boot repository method uses join fetch to load a ParentEntity and its ChildEntity set in one query. This avoids multiple database calls when accessing children.

Spring Boot

import jakarta.persistence.EntityManager;
import jakarta.persistence.PersistenceContext;
import org.springframework.stereotype.Repository;

@Repository
public class ParentRepository {

    @PersistenceContext
    private EntityManager em;

    public ParentEntity findByIdWithChildren(Long id) {
        return em.createQuery(
            "SELECT p FROM ParentEntity p JOIN FETCH p.childEntities WHERE p.id = :id", ParentEntity.class)
            .setParameter("id", id)
            .getSingleResult();
    }
}

// Entities
import jakarta.persistence.*;
import java.util.Set;

@Entity
public class ParentEntity {
    @Id
    private Long id;

    private String name;

    @OneToMany(mappedBy = "parent", fetch = FetchType.LAZY)
    private Set<ChildEntity> childEntities;

    // getters and setters
}

@Entity
public class ChildEntity {
    @Id
    private Long id;

    private String value;

    @ManyToOne
    @JoinColumn(name = "parent_id")
    private ParentEntity parent;

    // getters and setters
}

Important Notes

Join fetch only works in JPQL or HQL queries, not in native SQL.

Use join fetch carefully to avoid loading too much data at once.

It helps prevent the "N+1 select problem" where many small queries slow down your app.

Summary

Join fetch loads related entities in one database query.

It improves performance by reducing extra queries.

Use it in JPQL with the JOIN FETCH keyword.

Practice

1. What is the main purpose of using JOIN FETCH in Spring Boot JPA queries?

easy

A. To create a new table for the joined entities

B. To delete related entities automatically when the parent is deleted

C. To load related entities eagerly in a single query and avoid multiple database hits

D. To update related entities in batch

Solution

1. Step 1: Understand what JOIN FETCH does

   JOIN FETCH tells JPA to load related entities eagerly in the same query instead of lazy loading them later.

2. Step 2: Recognize the performance benefit

   This reduces the number of database queries, improving performance by avoiding the N+1 select problem.

3. Final Answer:

   To load related entities eagerly in a single query and avoid multiple database hits -> Option C

4. Quick Check:

   Join fetch = eager load related data [OK]

Hint: Join fetch loads related data in one query to boost speed [OK]

Common Mistakes:

• Thinking join fetch deletes or updates data
• Confusing join fetch with creating new tables
• Assuming join fetch delays loading entities

2. Which of the following is the correct JPQL syntax to fetch a parent entity and its child entities using join fetch?

easy

A. SELECT p FROM Parent p JOIN FETCH p.children

B. SELECT p FROM Parent p JOIN p.children FETCH

C. SELECT p FROM Parent p FETCH JOIN p.children

D. SELECT p FROM Parent p LEFT JOIN p.children FETCH

Solution

1. Step 1: Recall correct JPQL join fetch syntax

   The correct syntax places JOIN FETCH before the association path: JOIN FETCH p.children.

2. Step 2: Check each option

   Only SELECT p FROM Parent p JOIN FETCH p.children matches the correct syntax. The others misuse the order of keywords or use incorrect join types.

3. Final Answer:

   SELECT p FROM Parent p JOIN FETCH p.children -> Option A

4. Quick Check:

   Join fetch syntax = JOIN FETCH association [OK]

Hint: Remember: 'JOIN FETCH' comes together before the association [OK]

Common Mistakes:

• Swapping FETCH and JOIN keywords
• Placing FETCH after the association path
• Using FETCH without JOIN keyword

3. Given the following JPQL query:

SELECT o FROM Order o JOIN FETCH o.items WHERE o.id = :id

What will happen when this query runs?

medium

A. It loads only the items without the Order

B. It loads the Order and all its items in one query, avoiding lazy loading

C. It throws a syntax error because JOIN FETCH cannot be used with WHERE

D. It loads only the Order, items are loaded lazily later

Solution

1. Step 1: Analyze the query structure

   The query uses JOIN FETCH to eagerly load the items collection along with the Order entity filtered by id.

2. Step 2: Understand the effect of join fetch with WHERE

   The WHERE clause filters the order, but the join fetch still loads the items eagerly in the same query.

3. Final Answer:

   It loads the Order and all its items in one query, avoiding lazy loading -> Option B

4. Quick Check:

   Join fetch + WHERE = eager load filtered data [OK]

Hint: Join fetch loads related data even with WHERE filters [OK]

Common Mistakes:

• Thinking join fetch causes syntax errors with WHERE
• Assuming items load lazily despite join fetch
• Confusing join fetch with separate queries

4. Consider this JPQL query:

SELECT c FROM Customer c JOIN FETCH c.orders o WHERE o.status = 'PENDING'

What is the likely problem with this query?

medium

A. It may return duplicate Customer entities due to multiple matching orders

B. It will fail because JOIN FETCH cannot have an alias

C. It will not fetch orders eagerly because of the WHERE clause

D. It will only fetch orders with status other than 'PENDING'

Solution

1. Step 1: Understand join fetch with filtering on collection

   Filtering on orders with WHERE o.status = 'PENDING' can cause multiple rows per customer if they have multiple pending orders.

2. Step 2: Recognize duplicate root entities issue

   This leads to duplicate Customer entities in the result list unless distinct is used.

3. Final Answer:

   It may return duplicate Customer entities due to multiple matching orders -> Option A

4. Quick Check:

   Join fetch + filtered collection = possible duplicates [OK]

Hint: Filtering join fetch collections can cause duplicates [OK]

Common Mistakes:

• Believing join fetch cannot have aliases
• Thinking WHERE disables eager loading
• Assuming only non-matching orders are fetched

5. You want to optimize loading a list of Author entities with their books and each book's publisher in one query. Which JPQL query correctly uses join fetch for this?

hard

A. SELECT a FROM Author a JOIN FETCH a.books, b.publisher

B. SELECT a FROM Author a JOIN a.books b JOIN FETCH b.publisher

C. SELECT a FROM Author a JOIN FETCH a.books JOIN b.publisher

D. SELECT a FROM Author a JOIN FETCH a.books b JOIN FETCH b.publisher

Solution

1. Step 1: Identify the need for nested join fetch

   To load authors with books and each book's publisher eagerly, use join fetch on both associations.

2. Step 2: Check the syntax for multiple join fetches

   SELECT a FROM Author a JOIN FETCH a.books b JOIN FETCH b.publisher correctly uses JOIN FETCH a.books b and then JOIN FETCH b.publisher to fetch nested associations.

3. Final Answer:

   SELECT a FROM Author a JOIN FETCH a.books b JOIN FETCH b.publisher -> Option D

4. Quick Check:

   Multiple join fetches = eager load nested relations [OK]

Hint: Use multiple JOIN FETCH for nested eager loading [OK]

Common Mistakes:

• Missing JOIN FETCH on nested association
• Using JOIN without FETCH for nested entities
• Incorrect syntax with commas or missing aliases