如何使用JPA查询无关联实体：从MainEntity获取完整Language实体

我有两个JPA实体：

@Entity
public class Language {

    @Id
    @GeneratedValue
    private int id;

    private String name;

    private String isoCode;

}

以及另一个实体：

@Entity
public class MainEntity {

    @Id
    @GeneratedValue
    private int id;

    private String anotherField;

    private Language language;  // 希望此处返回完整实体

}

这两个实体无数据库关联，MainEntity的language字段在数据库中实际存储的是Language的isoCode字符串。现在需要查询MainEntity时，自动获取对应的完整Language实体，支持调用mainEntity.getLanguage().getName()这类方法。

数据库示例数据：
Language表：

MainEntity表：

已有的仓库代码：

public interface MainRepository extends JpaRepository<MainEntity, Integer> {
    List<MainEntity> findAll(); // 原代码中User为笔误，修正为List<MainEntity>
}

方案1：实体层用@PostLoad触发加载 #

通过添加临时字段存储数据库中的isoCode，利用JPA的@PostLoad注解在实体加载后自动查询关联的Language实体。

步骤1：修改MainEntity #

@Entity
public class MainEntity {

    @Id
    @GeneratedValue
    private int id;

    private String anotherField;

    // 映射数据库实际存储的language字段（isoCode字符串）
    @Column(name = "language")
    private String languageIsoCode;

    // 不映射数据库，用于存储加载后的完整Language实体
    @Transient
    private Language language;

    // 自动注入LanguageRepository
    @Autowired
    @Transient
    private LanguageRepository languageRepository;

    // 实体加载后触发，查询对应的Language
    @PostLoad
    private void loadLanguage() {
        if (languageIsoCode != null) {
            this.language = languageRepository.findByIsoCode(languageIsoCode);
        }
    }

    // getter、setter方法省略
}

步骤2：创建LanguageRepository #

public interface LanguageRepository extends JpaRepository<Language, Integer> {
    Language findByIsoCode(String isoCode);
}

注意：此方案会导致N+1查询问题（每个MainEntity加载时都触发一次Language查询），仅适合数据量较小的场景。

方案2：仓库层自定义JPQL查询 #

通过JPQL的JOIN语句一次性关联查询两个表，避免多次查询。

步骤1：修改MainEntity #

@Entity
public class MainEntity {

    @Id
    @GeneratedValue
    private int id;

    private String anotherField;

    @Column(name = "language")
    private String languageIsoCode;

    @Transient
    private Language language;

    // getter、setter方法省略
}

步骤2：扩展MainRepository #

提供两种实现方式：

方式A：返回对象数组

public interface MainRepository extends JpaRepository<MainEntity, Integer> {

    @Query("SELECT m, l FROM MainEntity m LEFT JOIN Language l ON m.languageIsoCode = l.isoCode")
    List<Object[]> findAllWithLanguage();
}

使用时需要手动将数组转换为实体：

List<Object[]> results = mainRepository.findAllWithLanguage();
List<MainEntity> mainEntities = new ArrayList<>();
for (Object[] result : results) {
    MainEntity m = (MainEntity) result[0];
    Language l = (Language) result[1];
    m.setLanguage(l);
    mainEntities.add(m);
}

方式B：构造函数投影返回DTO

先定义DTO类：

public class MainEntityDto {
    private int id;
    private String anotherField;
    private Language language;

    // 必须提供对应参数的构造函数
    public MainEntityDto(int id, String anotherField, Language language) {
        this.id = id;
        this.anotherField = anotherField;
        this.language = language;
    }

    // getter方法省略
}

然后在仓库中定义查询：

public interface MainRepository extends JpaRepository<MainEntity, Integer> {

    @Query("SELECT new com.yourpackage.dto.MainEntityDto(m.id, m.anotherField, l) FROM MainEntity m LEFT JOIN Language l ON m.languageIsoCode = l.isoCode")
    List<MainEntityDto> findAllWithLanguageDto();
}

此方案仅需一次查询，性能更优。

方案3：Service层批量关联查询 #

通过批量查询Language再手动关联，完全避免N+1问题，适合大数据量场景。

步骤1：修改MainEntity（同方案2的实体定义） #

步骤2：扩展LanguageRepository #

public interface LanguageRepository extends JpaRepository<Language, Integer> {
    List<Language> findByIsoCodeIn(Set<String> isoCodes);
}

步骤3：在Service层实现关联逻辑 #

@Service
public class MainEntityService {

    @Autowired
    private MainRepository mainRepository;

    @Autowired
    private LanguageRepository languageRepository;

    public List<MainEntity> findAllWithLanguage() {
        // 1. 查询所有MainEntity
        List<MainEntity> mainEntities = mainRepository.findAll();
        
        // 2. 收集所有非空的isoCode
        Set<String> isoCodes = mainEntities.stream()
                .map(MainEntity::getLanguageIsoCode)
                .filter(Objects::nonNull)
                .collect(Collectors.toSet());
        
        // 3. 批量查询对应的Language，转成isoCode为key的Map
        Map<String, Language> languageMap = languageRepository.findByIsoCodeIn(isoCodes).stream()
                .collect(Collectors.toMap(Language::getIsoCode, Function.identity()));
        
        // 4. 手动关联到MainEntity
        mainEntities.forEach(m -> m.setLanguage(languageMap.get(m.getLanguageIsoCode())));
        
        return mainEntities;
    }
}

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