自定义JpaRepository：同属性实体通用查询仓库可行性问询

完全符合你的需求——我们可以创建一个带有自定义通用查询的仓库接口，让所有需要这些通用逻辑的实体仓库都继承它，同时保留JpaRepository的全部基础功能。下面是具体的实现步骤，一步步来：

1. 定义通用仓库接口 #

首先创建你的自定义通用仓库接口，它需要继承JpaRepository，同时添加你需要的通用查询方法。为了保证通用性，我们使用泛型来适配不同的实体和主键类型：

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

public interface MyCustomJpaRepository<T, ID> extends JpaRepository<T, ID> {
    // 通用的根据name查询的方法，假设你的实体都有name属性
    Optional<T> findByName(String name);
}

如果你的实体都继承了一个包含共同属性（比如name）的基类，比如BaseEntity，可以进一步约束泛型，让接口更类型安全：

// 先定义包含通用属性的基类
public abstract class BaseEntity {
    private String name;
    // getter、setter省略
}

// 通用仓库接口约束泛型为BaseEntity的子类
public interface MyCustomJpaRepository<T extends BaseEntity, ID> extends JpaRepository<T, ID> {
    Optional<T> findByName(String name);
}

2. 实现通用仓库的自定义方法 #

Spring Data JPA的自定义方法需要一个实现类，我们可以基于默认的SimpleJpaRepository来扩展，这样就能复用它的基础JPA操作逻辑：

import org.springframework.data.jpa.repository.support.SimpleJpaRepository;
import jakarta.persistence.EntityManager;
import java.util.Optional;

public class MyCustomJpaRepositoryImpl<T extends BaseEntity, ID> extends SimpleJpaRepository<T, ID> implements MyCustomJpaRepository<T, ID> {

    private final EntityManager entityManager;

    // 构造方法需要传入实体类和EntityManager，这是Spring Data JPA的要求
    public MyCustomJpaRepositoryImpl(Class<T> domainClass, EntityManager entityManager) {
        super(domainClass, entityManager);
        this.entityManager = entityManager;
    }

    // 实现通用的findByName方法
    @Override
    public Optional<T> findByName(String name) {
        // 用JPQL实现通用查询，通过getDomainClass()动态获取实体类名
        String jpql = "SELECT t FROM " + getDomainClass().getSimpleName() + " t WHERE t.name = :name";
        return entityManager.createQuery(jpql, getDomainClass())
                .setParameter("name", name)
                .getResultStream()
                .findFirst();
    }
}

3. 配置Spring Data JPA使用自定义仓库实现 #

接下来需要告诉Spring，我们的自定义仓库实现类要作为所有仓库的基础类。你可以在Spring Boot的启动类或者配置类上添加@EnableJpaRepositories注解，并指定repositoryBaseClass属性：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.data.jpa.repository.config.EnableJpaRepositories;

@SpringBootApplication
@EnableJpaRepositories(repositoryBaseClass = MyCustomJpaRepositoryImpl.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

4. 让实体仓库继承自定义通用仓库 #

现在，你的具体实体仓库就可以直接继承MyCustomJpaRepository，而不是JpaRepository了，这样它们自动拥有JPA的所有基础方法（比如save、findAll、deleteById等），以及我们自定义的findByName方法：

// User实体仓库
public interface UserRepository extends MyCustomJpaRepository<User, Long> {
    // 这里可以添加User特有的查询方法，比如根据邮箱查询
    Optional<User> findByEmail(String email);
}

// Product实体仓库
public interface ProductRepository extends MyCustomJpaRepository<Product, Long> {
    // Product特有的查询方法，比如查询价格大于指定值的商品
    List<Product> findByPriceGreaterThan(BigDecimal price);
}

一些额外的小提示 #

• 如果你的通用查询逻辑比较复杂，推荐使用Criteria API代替硬编码的JPQL，这样能更好地适配不同实体的属性，避免字符串拼接的错误。
• 如果你不需要所有实体都使用这个通用仓库，也可以让部分实体仓库继承它，其他的依然直接继承JpaRepository，完全灵活。
• 别忘了确保你的实体类（或者它们的基类）确实包含name属性，否则运行时会抛出JPQL解析错误。

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