Spring Data JPA para Java: guia completo com exemplos

O que é e para que serve?

Spring Data JPA é uma biblioteca poderosa do ecossistema Spring que fornece uma abstração sobre a Java Persistence API (JPA) para simplificar o trabalho com bancos de dados. Se você já escreveu um DAO (Data Access Object) usando EntityManager, sabe quanta código repetitivo é necessário: abrir transações, criar consultas, processar resultados. O Spring Data JPA resolve esse problema oferecendo uma abordagem declarativa para criar repositórios.

A ideia principal da biblioteca é que o desenvolvedor só precisa definir uma interface de repositório que estenda uma das interfaces base (por exemplo, JpaRepository), e o Spring Data JPA gera automaticamente a implementação em tempo de execução. Além disso, a biblioteca suporta a criação de consultas com base nos nomes dos métodos: se você nomear o método findByLastName(String lastName), o Spring Data JPA entenderá que precisa executar a consulta SELECT * FROM users WHERE last_name = ?.

Para que serve isso? Primeiro, reduz drasticamente a quantidade de código que você precisa escrever e manter. Segundo, a biblioteca oferece uma abordagem uniforme para trabalhar com diferentes SGBDs (MySQL, PostgreSQL, H2, Oracle, etc.) através do JPA. Terceiro, o Spring Data JPA se integra com transações do Spring, cache e outros componentes do framework, tornando o desenvolvimento de aplicações enterprise mais previsível e conveniente.

Instalação

O Spring Data JPA não é instalado via pip ou npm, pois é uma biblioteca Java. Para utilizá-lo, você precisa de um sistema de build como Maven ou Gradle. Abaixo estão as dependências exatas para ambos os sistemas.

Maven (pom.xml):

<!-- Dependência principal do Spring Data JPA -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
    <version>3.2.0</version>
</dependency>

<!-- Driver do banco de dados (exemplo para PostgreSQL) -->
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.7.1</version>
    <scope>runtime</scope>
</dependency>

Gradle (build.gradle):

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa:3.2.0'
    runtimeOnly 'org.postgresql:postgresql:42.7.1'
}

Após adicionar as dependências, não se esqueça de configurar a conexão com o banco de dados no arquivo application.properties ou application.yml.

# application.properties
spring.datasource.url=jdbc:postgresql://localhost:5432/mydb
spring.datasource.username=user
spring.datasource.password=pass
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

Início rápido — exemplo mínimo funcional

Vamos criar uma aplicação simples para gerenciar usuários. Precisaremos de uma entidade (Entity), um repositório e um serviço.

Passo 1. Criar a entidade User

package com.example.demo.entity;

import jakarta.persistence.*;

@Entity
@Table(name = "users")
public class User {

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

    @Column(nullable = false)
    private String firstName;

    @Column(nullable = false)
    private String lastName;

    @Column(unique = true, nullable = false)
    private String email;

    // Construtores
    public User() {}

    public User(String firstName, String lastName, String email) {
        this.firstName = firstName;
        this.lastName = lastName;
        this.email = email;
    }

    // Getters e Setters
    public Long getId() { return id; }