Spring Boot中如何将Map参数传入HQL并查询Employee列表

下面提供两种常用的实现方式，直接满足你将Map参数传入HQL并获取结果的需求：

方法一：使用EntityManager手动绑定参数 #

通过JPA的EntityManager创建查询，遍历Map批量设置参数：

import jakarta.persistence.EntityManager;
import org.springframework.stereotype.Repository;
import java.util.List;
import java.util.Map;

@Repository
public class EmployeeDao {

    private final EntityManager entityManager;

    // 构造注入EntityManager
    public EmployeeDao(EntityManager entityManager) {
        this.entityManager = entityManager;
    }

    public List<Employee> queryEmployees(Map<String, Object> params) {
        String hql = "Select x from Employee x where x.id = (:id) and x.name = (:name)";
        // 创建指定返回类型的Query对象
        var query = entityManager.createQuery(hql, Employee.class);
        
        // 遍历Map自动绑定所有参数
        params.forEach(query::setParameter);
        
        return query.getResultList();
    }
}

方法二：使用Spring Data JPA直接传入Map #

如果项目使用Spring Data JPA，可以在Repository接口中定义支持Map参数的查询方法（Spring Data JPA 2.0+版本支持）：

1. 定义Repository接口 #

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

public interface EmployeeRepository extends JpaRepository<Employee, Integer> {

    @Query("Select x from Employee x where x.id = :id and x.name = :name")
    List<Employee> findByParams(Map<String, Object> params);
}

2. 调用查询方法 #

// 在Service或业务类中注入Repository
@Autowired
private EmployeeRepository employeeRepository;

// 执行查询
Map<String, Object> params = new HashMap<>();
params.put("id", 1);
params.put("name", "Testname");
List<Employee> employeeList = employeeRepository.findByParams(params);

注意事项 #

• 确保你的Employee实体类添加了JPA注解，否则无法完成表映射：

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Table;

@Entity
@Table(name = "Employee")
public class Employee {
    @Id
    int id;
    String name;

    // 必须添加无参构造方法，JPA规范要求
    public Employee() {}

    // 按需添加getter、setter方法
}

• HQL中的参数名必须和Map的键完全匹配，否则会抛出参数绑定异常。

内容的提问来源于stack exchange，提问作者user2755407