如何在Spring Data JPA中通过equals()查询实体（无需手动指定字段）

当用户提交房产地址注册请求时，需要检查该地址对应的ObjectAddress实体是否已在数据库中存在（无法获取ID），希望借助已重写的equals()和hashCode()方法完成查询，且不想手动拼接所有字段的查询条件，该如何实现？

实体类代码（修正笔误后） #

原代码中equals()方法存在类名拼写错误（ObjectAdress应为ObjectAddress），修正后的完整代码如下：

@Getter
@Setter
@Entity
public class ObjectAddress {

    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private UUID id;
    
    private String country;
    private String region;
    private String county;
    private String settlement;
    private String district;
    private String street;
    private String houseNumber;
    private String building;
    private Integer apartmentNumber;

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        ObjectAddress that = (ObjectAddress) o;
        return Objects.equals(country, that.country) 
            && Objects.equals(region, that.region) 
            && Objects.equals(county, that.county) 
            && Objects.equals(settlement, that.settlement) 
            && Objects.equals(district, that.district) 
            && Objects.equals(street, that.street) 
            && Objects.equals(houseNumber, that.houseNumber) 
            && Objects.equals(building, that.building) 
            && Objects.equals(apartmentNumber, that.apartmentNumber);
    }

    @Override
    public int hashCode() {
        return Objects.hash(country, region, county, settlement, district, street, houseNumber, building, apartmentNumber);
    }
}

解决方案：使用Spring Data JPA的Example查询（最优方案） #

Spring Data JPA提供的Example查询正好匹配需求：它会根据实体实例的非空字段自动生成查询条件，完全对应你equals()方法中用到的所有字段，无需手动编写查询语句。

步骤1：扩展Repository接口

让你的Repository继承QueryByExampleExecutor接口，获得Example查询能力：

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.repository.query.QueryByExampleExecutor;
import java.util.UUID;

public interface ObjectAddressRepository extends JpaRepository<ObjectAddress, UUID>, QueryByExampleExecutor<ObjectAddress> {
}

步骤2：业务层实现查询

将用户提交的地址数据封装成ObjectAddress实例（ID留空），通过Example.of()创建查询实例，再调用Repository的方法完成检查：

// 1. 封装用户提交的地址数据（id设为null，其他字段赋值）
ObjectAddress submittedAddr = new ObjectAddress();
submittedAddr.setCountry("中国");
submittedAddr.setRegion("上海市");
submittedAddr.setCounty("浦东新区");
// 依次填充settlement、district、street等其他字段...

// 2. 创建Example查询实例
Example<ObjectAddress> example = Example.of(submittedAddr);

// 3. 检查地址是否已存在
boolean isExists = objectAddressRepository.exists(example);

// 或者查询已存在的实体（如果需要后续操作）
Optional<ObjectAddress> existingAddr = objectAddressRepository.findOne(example);

原理说明

Example查询会自动遍历实体的非空字段，生成对应的WHERE条件（例如country = ? AND region = ? ...），这和你equals()方法中判断的字段完全一致，相当于把内存中的equals逻辑映射到数据库查询中，完美匹配需求。

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