Spring Boot中无需查询关联对象手动赋值的实体保存最佳实践

问题场景 #

我是Spring Boot和Java新手，遇到如下场景：
定义的Venue实体类：

public class Venue {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    @Column(nullable = false, updatable = false, columnDefinition = "serial")
    private Long id;

    @Column(nullable = false, unique = true)
    private String name;
    @Column(nullable = false)
    private String city;

    @OneToOne()
    @JoinColumn(name = "address_id")
    private Address address;

    private String description;

    // getters and setters

}

对应的VenueDTO类：

public class VenueDTO {

    private Long id;
    private String name;
    private String city;
    private String address_id;
    private String description;
}

当前save方法实现：

public Venue save(VenueDTO venue) {
    Optional<Address> address = addressRepository.findById(Long.parseLong(venue.getAddress_id()));
  
    Venue newVenue = new Venue();
    newVenue.setName(venue.getName());
    newVenue.setCity(venue.getCity());
    newVenue.setAddress(address.get());
    newVenue.setDescription(venue.getDescription());

    return venueRepository.save(newVenue);
}

希望实现：保存Venue实体时，无需查询Address对象，也不用手动给每个字段赋值，完成关联关系的保存。

最佳实践方案 #

1. 使用JPA代理对象避免查询Address数据库 #

JPA提供了getReferenceById（Spring Data JPA 2.5+版本，旧版本用getOne）方法，它不会真正查询数据库，而是返回一个Address的代理对象，仅持有ID，当后续需要访问该对象的其他属性时才会触发查询。这样就能避免不必要的数据库查询，直接完成关联设置。

修改后的save方法：

public Venue save(VenueDTO venue) {
    // 获取Address代理对象，不查询数据库
    Address addressProxy = addressRepository.getReferenceById(Long.parseLong(venue.getAddress_id()));
  
    Venue newVenue = new Venue();
    newVenue.setName(venue.getName());
    newVenue.setCity(venue.getCity());
    newVenue.setAddress(addressProxy);
    newVenue.setDescription(venue.getDescription());

    return venueRepository.save(newVenue);
}

2. 用DTO映射工具自动处理字段赋值 #

手动逐个set字段不仅繁琐，还容易出错，推荐使用MapStruct这类DTO映射工具，它能自动生成字段映射的实现代码，无需手动编写赋值逻辑。

步骤：

• 首先添加MapStruct依赖（Maven示例）：

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>1.5.5.Final</version>
</dependency>
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>1.5.5.Final</version>
    <scope>provided</scope>
</dependency>

• 定义映射接口：

@Mapper(componentModel = "spring")
public interface VenueMapper {
    VenueMapper INSTANCE = Mappers.getMapper(VenueMapper.class);

    // 基础字段映射，先忽略address字段后续手动设置
    @Mapping(target = "address", ignore = true)
    Venue toVenue(VenueDTO venueDTO);
}

• 修改save方法：

@Autowired
private VenueMapper venueMapper;

public Venue save(VenueDTO venue) {
    Address addressProxy = addressRepository.getReferenceById(Long.parseLong(venue.getAddress_id()));
    // 自动映射DTO到实体
    Venue newVenue = venueMapper.toVenue(venue);
    newVenue.setAddress(addressProxy);
    
    return venueRepository.save(newVenue);
}

3. 规范DTO字段命名 #

建议把DTO中的address_id改为addressId，符合Java驼峰命名规范，这样映射工具能更自然地识别字段，也让代码更易读。修改后的VenueDTO：

public class VenueDTO {

    private Long id;
    private String name;
    private String city;
    private Long addressId; // 改为驼峰命名，类型直接用Long避免手动转换
    private String description;
}

对应的save方法可省去Long.parseLong步骤：

Address addressProxy = addressRepository.getReferenceById(venue.getAddressId());

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