Spring Data JPA 使用简解

原创

繁依Fanyi 2025-06-10 15:17:30 ©著作权

文章标签 spring JPA Data 文章分类 Html/CSS 前端开发

©著作权归作者所有：来自51CTO博客作者繁依Fanyi的原创作品，请联系作者获取转载授权，否则将追究法律责任

Spring Data JPA 是一个强大的框架，它极大地简化了基于 JPA（Java Persistence API）进行数据访问层的开发。通过 Spring Data JPA，开发者几乎不需要编写实现代码，就能快速实现数据库操作。下面就简单介绍 Spring Data JPA 的部分概念和使用方法。

1. 简介

Spring Data JPA 是 Spring Data 项目的一部分，通过提供 JPA Repository 抽象层，简化数据库操作。它支持多种数据访问技术，JPA 是其中最常用的之一。

2. 配置 Spring Data JPA

添加依赖

首先，在 Maven 的 pom.xml

登录后复制

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>com.h2database</groupId>
        <artifactId>h2</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

spring-boot-starter-data-jpacom.h2database

配置数据库连接

在 application.properties

登录后复制

spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=password
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

spring.datasource.url

：数据库的连接 URL。

spring.datasource.driverClassName

：数据库驱动类名。

spring.datasource.username

spring.datasource.password

：数据库用户名和密码。

spring.jpa.hibernate.ddl-auto

：配置 Hibernate 的自动 DDL 操作，设置为

updatespring.jpa.show-sql

：设置为

true

3. 定义实体类

实体类是 JPA 的核心概念，用于映射数据库中的表。通过注解可以轻松定义实体类：

登录后复制

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import ;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;

    // Getters and setters
}

@Entity

：将这个类声明为 JPA 实体类。

@Id

：指定主键。

@GeneratedValue(strategy = GenerationType.IDENTITY)

：主键生成策略为自动增长。

4. 定义 Repository 接口

Repository 接口是 Spring Data JPA 提供的核心接口，用于执行各种数据库操作。只需定义接口并继承 JpaRepository

登录后复制

import org.springframework.data.jpa.repository.JpaRepository;
import java.util.List;

public interface UserRepository extends JpaRepository<User, Long> {
    List<User> findByName(String name);
}

JpaRepository<T, ID>

T

是实体类类型，

IDfindByName

：通过命名约定，Spring Data JPA 自动解析方法名生成查询。

5. 使用 Repository

在 Spring 的服务层或控制器中，可以直接注入 UserRepository

登录后复制

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;

    public List<User> getAllUsers() {
        return userRepository.findAll();
    }

    public User saveUser(User user) {
        return userRepository.save(user);
    }

    public List<User> findUsersByName(String name) {
        return userRepository.findByName(name);
    }
}

@Service

：声明这个类为服务层组件。

@Autowired

：自动注入

UserRepository

6. CRUD 操作

Spring Data JPA 提供了许多开箱即用的 CRUD 方法：

save(S entity)

：保存或更新实体。

findById(ID id)

：通过 ID 查找实体。

findAll()

：查找所有实体。

deleteById(ID id)

：通过 ID 删除实体。

例如：

登录后复制

// 保存用户
User user = new User();
user.setName("John Doe");
user.setEmail("john.doe@example.com");
userService.saveUser(user);

// 查找所有用户
List<User> users = userService.getAllUsers();

// 通过 ID 查找用户
User foundUser = userRepository.findById(1L).orElse(null);

// 删除用户
userRepository.deleteById(1L);

7. 自定义查询

除了内置的方法，Spring Data JPA 还允许通过方法名定义查询：

登录后复制

List<User> findByEmail(String email);

或者使用 @Query

登录后复制

import org.springframework.data.jpa.repository.Query;

@Query("SELECT u FROM User u WHERE u.email = ?1")
List<User> findUserByEmail(String email);

8. 分页和排序

Spring Data JPA 支持分页和排序：

登录后复制

import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.domain.PageRequest;

public Page<User> getUsers(int page, int size) {
    Pageable pageable = PageRequest.of(page, size);
    return userRepository.findAll(pageable);
}

Pageable