在Spring Boot中使用Hibernate是非常常见的，因为Hibernate是一个强大的ORM（对象关系映射）框架，可以帮助开发者简化数据库操作。Spring Boot通过自动配置和注解极大地简化了Hibernate的集成过程。

以下是使用Spring Boot与Hibernate的基本步骤：

1. 添加依赖

在pom.xml文件中添加必要的依赖项。Spring Boot Starter Data JPA已经包含了Hibernate的相关依赖。

<dependencies>
    <!-- Spring Boot Starter Data JPA -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>

    <!-- 数据库驱动（例如 MySQL、PostgreSQL 等） -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>

    <!-- 其他依赖（如 Lombok 可选） -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

2. 配置数据库连接

在application.properties或application.yml中配置数据库连接信息。

application.properties 示例：
# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=your_password

# Hibernate 配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
application.yml 示例：
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_database_name?useSSL=false&serverTimezone=UTC
    username: root
    password: your_password
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true
    properties:
      hibernate:
        dialect: org.hibernate.dialect.MySQL8Dialect

说明：

  • spring.jpa.hibernate.ddl-auto: 控制Hibernate如何生成表结构。
    • create: 每次启动时都会删除并重新创建表。
    • update: 根据实体类更新表结构。
    • validate: 验证表结构是否与实体类匹配。
    • none: 不执行任何操作。
  • spring.jpa.show-sql: 是否打印SQL语句到控制台。

3. 创建实体类

使用JPA注解定义实体类。

import jakarta.persistence.*;
import lombok.Data;

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

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

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

    @Column(nullable = false)
    private String password;

    private String email;
}

常用注解：

  • @Entity: 声明这是一个JPA实体类。
  • @Table: 指定数据库中的表名。
  • @Id: 声明主键字段。
  • @GeneratedValue: 指定主键生成策略。
  • @Column: 定义字段对应的列属性。

4. 创建Repository接口

使用Spring Data JPA的JpaRepository接口来操作数据库。

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    // 自定义查询方法
    User findByUsername(String username);
}

说明：

  • JpaRepository<T, ID>: 提供了CRUD操作方法。
  • 可以通过方法命名规则自动生成查询逻辑（如findByUsername）。

5. 使用Service层调用Repository

创建一个服务类来封装业务逻辑。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.Optional;

@Service
public class UserService {

    @Autowired
    private UserRepository userRepository;

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

    public Optional<User> getUserById(Long id) {
        return userRepository.findById(id);
    }

    public User getUserByUsername(String username) {
        return userRepository.findByUsername(username);
    }
}

方法命名规则自动生成查询逻辑

在Spring Data JPA中，Repository接口支持通过方法命名规则自动生成查询逻辑。这种方式非常方便，开发者无需手动编写SQL或JPQL查询，只需要按照一定的命名规则定义方法即可。

以下是根据方法命名规则生成查询逻辑的常见模式：

1. 基本查询

  • 根据字段名生成简单的查询。
  • 方法名以findBy、readBy、queryBy或getBy开头，后面接实体类中的字段名。
示例：
User findByUsername(String username);
User readByEmail(String email);
List<User> queryByStatus(String status);

说明：

  • findByUsername: 查询username等于指定值的用户。
  • readByEmail: 查询email等于指定值的用户。
  • queryByStatus: 查询status等于指定值的用户列表。

2. 多条件查询

  • 使用And和Or连接多个字段。
示例：
User findByUsernameAndPassword(String username, String password);
List<User> findByStatusOrRole(String status, String role);

说明：

  • findByUsernameAndPassword: 查询username和password都匹配的用户。
  • findByStatusOrRole: 查询status或role匹配的用户列表。

3. 忽略大小写

  • 使用IgnoreCase忽略字段的大小写。
示例：
User findByUsernameIgnoreCase(String username);
List<User> findByEmailIgnoreCase(String email);

说明：

  • findByUsernameIgnoreCase: 查询username忽略大小写的用户。
  • findByEmailIgnoreCase: 查询email忽略大小写的用户列表。

4. 模糊查询

  • 使用Like进行模糊匹配。
  • 可以结合%通配符实现部分匹配。
示例：
List<User> findByUsernameLike(String pattern);
List<User> findByEmailContaining(String substring);

说明：

  • findByUsernameLike: 查询username符合指定模式的用户（如"%john%"）。
  • findByEmailContaining: 查询email包含指定子字符串的用户。

5. 排序

  • 使用OrderBy对结果进行排序。
示例：
List<User> findByStatusOrderByCreatedAtDesc(String status);
List<User> findByRoleOrderByAgeAsc(String role);

说明：

  • findByStatusOrderByCreatedAtDesc: 查询status匹配的用户，并按createdAt降序排序。
  • findByRoleOrderByAgeAsc: 查询role匹配的用户，并按age升序排序。

6. 范围查询

  • 使用GreaterThan、LessThan、Between等关键字进行范围查询。
示例：
List<User> findByAgeGreaterThan(int age);
List<User> findByCreatedAtBetween(LocalDateTime start, LocalDateTime end);

说明：

  • findByAgeGreaterThan: 查询age大于指定值的用户。
  • findByCreatedAtBetween: 查询createdAt在指定时间范围内的用户。

7. 布尔查询

  • 使用IsTrue、IsFalse、IsNull、IsNotNull等关键字。
示例：
List<User> findByActiveIsTrue();
List<User> findByEmailIsNull();

说明：

  • findByActiveIsTrue: 查询active为true的用户。
  • findByEmailIsNull: 查询email为null的用户。

8. 分页和排序

  • 使用Pageable和Sort参数实现分页和排序。
示例：
Page<User> findByStatus(String status, Pageable pageable);
List<User> findByRole(String role, Sort sort);

说明：

  • findByStatus: 查询status匹配的用户，并支持分页。
  • findByRole: 查询role匹配的用户，并支持排序。

9. 自定义返回类型

  • 可以返回特定字段的投影对象。
示例：
@Query("SELECT new com.example.dto.UserDto(u.id, u.username) FROM User u WHERE u.status = :status")
List<UserDto> findUserDtosByStatus(@Param("status") String status);

说明：

  • 返回一个自定义的UserDto对象，只包含id和username字段。

10. 删除操作

  • 使用deleteBy或removeBy前缀执行删除操作。
示例：
void deleteByUsername(String username);
long deleteByStatus(String status);

说明：

  • deleteByUsername: 删除username匹配的用户。
  • deleteByStatus: 删除status匹配的用户，并返回删除的数量。

10. 修改/保存操作

  • 使用save或saveAll前缀执行修改/保存操作。

以下是一些常用的关键字总结：

  • 条件关键字: And, Or, Is, Equals, Not, In, NotIn
  • 比较关键字: GreaterThan, LessThan, Between
  • 模糊匹配关键字: Like, Containing, StartingWith, EndingWith
  • 排序关键字: OrderBy, Asc, Desc
  • 布尔关键字: IsTrue, IsFalse, IsNull, IsNotNull
  • 分页和排序: Pageable, Sort

自定义查询

在Spring Data JPA中，如果默认的查询方法（通过方法命名规则生成的查询）无法满足需求，可以通过@Query注解编写自定义SQL或JPQL（Java Persistence Query Language）查询。以下是详细的步骤和示例：

1. 使用@Query注解

@Query注解可以直接定义在Repository接口的方法上，用于指定自定义的查询逻辑。

基本语法：
@Query("SELECT u FROM User u WHERE u.username = :username")
User findByUsername(@Param("username") String username);
  • @Query: 用于定义查询语句。
  • :username: 是一个命名参数，表示占位符。
  • @Param("username"): 将方法参数绑定到查询中的命名参数。

2. 支持的查询类型

Spring Data JPA支持两种类型的查询：

  • JPQL（Java Persistence Query Language）: 面向对象的查询语言，操作的是实体类而不是数据库表。
  • 原生SQL: 直接编写针对数据库的SQL语句。
示例：JPQL vs 原生SQL
// JPQL 查询
@Query("SELECT u FROM User u WHERE u.status = :status")
List<User> findUsersByStatus(@Param("status") String status);

// 原生 SQL 查询
@Query(value = "SELECT * FROM users WHERE status = :status", nativeQuery = true)
List<User> findUsersByStatusNative(@Param("status") String status);

说明：

  • JPQL中的User是实体类名，而不是数据库表名。
  • 原生SQL中的users是数据库表名。
  • 使用nativeQuery = true启用原生SQL查询。

3. 传递参数

可以使用命名参数（@Param）或位置参数（?1、?2等）传递查询条件。

示例：命名参数
@Query("SELECT u FROM User u WHERE u.username = :username AND u.email = :email")
User findByUsernameAndEmail(@Param("username") String username, @Param("email") String email);
示例：位置参数
@Query("SELECT u FROM User u WHERE u.username = ?1 AND u.email = ?2")
User findByUsernameAndEmail(String username, String email);

说明：

  • 命名参数更直观，推荐使用。
  • 位置参数按顺序匹配方法参数。

4. 更新和删除操作

对于更新和删除操作，需要配合@Modifying注解使用。

示例：更新操作
@Modifying
@Query("UPDATE User u SET u.password = :password WHERE u.id = :id")
void updatePassword(@Param("id") Long id, @Param("password") String password);
示例：删除操作
@Modifying
@Query("DELETE FROM User u WHERE u.id = :id")
void deleteUserById(@Param("id") Long id);

注意：

  • 更新和删除操作需要事务支持，因此方法上通常需要添加@Transactional注解。

5. 分页和排序

可以通过Pageable和Sort参数实现分页和排序功能。

示例：分页查询
@Query("SELECT u FROM User u WHERE u.status = :status")
Page<User> findUsersByStatus(@Param("status") String status, Pageable pageable);

调用时：

Page<User> users = userRepository.findUsersByStatus("active", PageRequest.of(0, 10));
示例：排序查询
@Query("SELECT u FROM User u WHERE u.status = :status")
List<User> findUsersByStatus(@Param("status") String status, Sort sort);

调用时：

List<User> users = userRepository.findUsersByStatus("active", Sort.by(Sort.Direction.DESC, "createdAt"));

6. 投影查询

如果只需要返回部分字段，可以使用投影（DTO或接口）来优化查询。

示例：返回DTO
@Query("SELECT new com.example.dto.UserDto(u.id, u.username) FROM User u WHERE u.status = :status")
List<UserDto> findUserDtosByStatus(@Param("status") String status);

说明：

  • UserDto是一个自定义的类，构造函数必须与查询结果匹配。
示例：返回接口
public interface UserNameOnly {
    String getUsername();
}

@Query("SELECT u.username FROM User u WHERE u.status = :status")
List<UserNameOnly> findUsernamesByStatus(@Param("status") String status);

说明：

  • 接口投影只允许返回简单的字段，不能包含复杂逻辑。

7. 动态查询

如果需要根据条件动态构建查询，可以使用Specification或Criteria API。

示例：使用Specification
public List<User> findUsers(Specification<User> spec) {
    return userRepository.findAll(spec);
}

调用时：

Specification<User> spec = (root, query, criteriaBuilder) -> 
    criteriaBuilder.equal(root.get("status"), "active");

List<User> users = userService.findUsers(spec);

总结

通过@Query注解，可以在Spring Data JPA中灵活地编写自定义SQL或JPQL查询，满足复杂的业务需求。以下是一些关键点：

  1. JPQL适用于面向对象的查询，而原生SQL适用于直接操作数据库表。
  2. 使用@Modifying和@Transactional处理更新和删除操作。
  3. 分页和排序可以通过Pageable和Sort参数实现。
  4. 投影查询可以优化性能，返回部分字段。
  5. 动态查询可以通过Specification或Criteria API实现。

希望这些内容对你有帮助！如果有其他问题，欢迎继续提问！

# spring boot # hibernate # 数据库
Logo
火山引擎 ADG 社区

火山引擎开发者社区是火山引擎打造的AI技术生态平台，聚焦Agent与大模型开发，提供豆包系列模型（图像/视频/视觉）、智能分析与会话工具，并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长，新用户可领50万Tokens权益，助力构建智能应用。

更多推荐

OpenClaw 本地部署完整指南（Windows + Ollama）

本文档基于实际部署经验编写，旨在帮助你在 Windows 系统上从零开始搭建 OpenClaw，并连接本地 Ollama 模型（如 Qwen2.5 或 Qwen3），使其具备完整的智能体能力。文档包含了所有关键步骤以及常见问题的解决方案。

avatar 火山引擎 ADG 社区

OpenClaw 小白安装指南（Windows版）

（类似一个能自动执行任务的AI机器人），不是游戏。API Key只保存在你本地电脑的加密文件里，不会上传到任何地方。访问：https://github.com/miaoxworld/openclaw-manager/releases。: 一键安装脚本会自动安装Node.js 22+，如果失败，手动下载安装：https://nodejs.org/：在PowerShell中，鼠标右键就是粘贴，不需要按

avatar 火山引擎 ADG 社区

飞书 × OpenClaw 接入指南：不用服务器，用长连接把机器人跑起来

这个项目存在的意义，就是把“飞书接 OpenClaw”这件事，整理成一套的配置入口，并把官方文档没覆盖到的坑集中写成排查清单。先说清楚它的角色：OpenClaw 现在已经内置官方飞书插件 @openclaw/feishu，功能更完整、维护也更及时。，说明飞书 + AI 的接入已经走通。另外，仓库也推荐了一个新项目：把 OpenClaw 变成“多 Agent 团队”，用多个 Agent 分工，Sla

avatar 火山引擎 ADG 社区