JPA Buddy
announcement - icon

JPA is huge! It covers nearly every aspect of communication between relational databases and the Java application and is deeply integrated into all major frameworks.

If you're using IntelliJ, JPA Buddy is super helpful. The plugin gently guides you through the subtleties of the most popular JPA implementations, visually reminds you of JPA features, generates code that follows best practices, and integrates intelligent inspections to improve your existing persistence code.

More concretely, it provides powerful tooling to generate Spring Data JPA repositories and methods, Flyway Versioned Migrations, Liquibase Differential Changelogs, DDL and SQL statements, DTO objects, and MapStruct interfaces.

Oh, and it actually generates JPA entities from an existing database and gradually update the data model as the database evolves! Yeah.

>> Become a lot more productive with JPA Buddy

Persistence top

Get started with Spring Data JPA through the reference Learn Spring Data JPA course:


1. Overview

In this short tutorial, we'll discuss a more advanced feature of Spring Data JPA Specifications which allows us to join tables when creating the query.

Let's start with a brief recap of JPA Specifications are their usage.

2. JPA Specifications

Spring Data JPA introduced the Specification interface for allowing us to create dynamic queries with reusable components.

For the code examples in this article, we'll use the Author and Book classes:

public class Author {

    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String firstName;

    private String lastName;

    @OneToMany(cascade = CascadeType.ALL)
    private List<Book> books;

    // getters and setters

In order to create a dynamic query for the Author entity, we can use implementations of the Specification interface:

public class AuthorSpecifications {

    public static Specification<Author> hasFirstNameLike(String name) {
        return (root, query, criteriaBuilder) ->
<String>get("firstName"), "%" + name + "%");

    public static Specification<Author> hasLastName(String name) {
        return (root, query, cb) ->
          cb.equal(root.<String>get("lastName"), name);

Lastly, we'll need AuthorRepository to extend JpaSpecificationExecutor:

public interface AuthorsRepository extends JpaRepository<Author, Long>, JpaSpecificationExecutor<Author> {

As a result, we can now chain together the two specifications and create queries with them:

public void whenFindByLastNameAndFirstNameLike_thenOneAuthorIsReturned() {
    Specification<Author> specification = hasLastName("Martin")

    List<Author> authors = repository.findAll(specification);


3. Joining Tables with JPA Specifications

We can observe from our data model that the Author entity shares a one-to-many relationship with the Book entity:

public class Book {

    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String title;

    // getters and setters

The Criteria Query API allows us to join the two tables when creating the Specification. As a result, we'll be able to include the fields from the Book entity inside our queries:

public static Specification<Author> hasBookWithTitle(String bookTitle) {
    return (root, query, criteriaBuilder) -> {
        Join<Book, Author> authorsBook = root.join("books");
        return criteriaBuilder.equal(authorsBook.get("title"), bookTitle);

Now, let's combine this new Specification with the ones created previously:

public void whenSearchingByBookTitleAndAuthorName_thenOneAuthorIsReturned() {

    Specification<Author> specification = hasLastName("Martin")
      .and(hasBookWithTitle("Clean Code"));

    List<Author> authors = repository.findAll(specification);


Lastly, let's take a look at the generated SQL and see the JOIN clause:

select as id1_1_, 
  author0_.first_name as first_na2_1_, 
  author0_.last_name as last_nam3_1_ 
  author author0_ 
  inner join author_books books1_ on = books1_.author_id 
  inner join book book2_ on books1_.books_id = 
  author0_.last_name = ? 
  and book2_.title = ?

4. Conclusion

In this article, we've learned how to use JPA Specifications to query a table based on one of its associated entities.

Spring Data JPA's Specifications lead to a fluent, dynamic, and reusable way of creating queries.

As usual, the source code is available over on GitHub.

Persistence bottom
Get started with Spring Data JPA through the reference Learn Spring Data JPA course: >> CHECK OUT THE COURSE
Persistence footer banner
Comments are closed on this article!