Spring Boot集成Hibernate实现自定义SQL查询

Spring Boot集成Hibernate实现自定义SQL查询

在Spring Boot中，Hibernate作为JPA的实现，提供了强大的ORM功能，但有时我们仍需要执行自定义SQL语句以满足复杂的查询需求。本文将介绍如何在Spring Boot中集成Hibernate并使用自定义SQL语句。

一、Spring Boot集成Hibernate的基础配置

1. 添加依赖

在 pom.xml 文件中，添加 spring-boot-starter-data-jpa 和数据库驱动依赖（以MySQL为例）：

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

    <!-- MySQL Driver -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

2. 配置数据源

在 application.properties 文件中，配置数据源和Hibernate参数：

# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/your_database_name?useSSL=false&serverTimezone=UTC
spring.datasource.username=your_username
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# Hibernate配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect

二、定义实体类和Repository

1. 创建实体类

定义一个与数据库表对应的实体类：

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

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

    // Getters and Setters
}

2. 创建Repository接口

在Repository接口中，使用 @Query 注解定义自定义SQL查询：

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

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    @Query(value = "SELECT * FROM users WHERE name LIKE %?1%", nativeQuery = true)
    List<User> findUsersByNameLike(String name);
}

在上述代码中，@Query 注解的 nativeQuery = true 表示使用原生SQL语句，而不是JPQL。

三、在Service层调用自定义查询

在Service层中，注入 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> searchUsersByName(String name) {
        return userRepository.findUsersByNameLike(name);
    }
}

四、在Controller层暴露API

创建一个REST控制器，提供接口供客户端调用：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping("/search")
    public List<User> searchUsers(@RequestParam String name) {
        return userService.searchUsersByName(name);
    }
}

五、执行复杂SQL语句

如果需要执行更复杂的SQL语句，可以在Repository中定义更多自定义方法。例如，执行一个复杂的查询：

@Query(value = "SELECT * FROM users WHERE age > ?1 AND email LIKE %?2%", nativeQuery = true)
List<User> findUsersByAgeAndEmail(int age, String email);

六、总结

通过Spring Boot集成Hibernate，我们可以方便地执行自定义SQL语句，满足复杂的查询需求。@Query 注解提供了强大的灵活性，允许开发者直接编写原生SQL语句，同时保持代码的简洁性和可维护性。

希望本文能帮助你在Spring Boot项目中更好地使用Hibernate执行自定义SQL查询。如果有更多问题，欢迎在评论区交流！