Java POST创建含嵌套对象的Order：方案选型及存在性校验咨询

针对你遇到的问题，最合理的方案是创建专门的请求DTO（数据传输对象），既解决Person存在性校验问题，又保持RESTful URL的规范性，同时避免客户端传递冗余数据。

核心思路 #

定义一个仅包含创建订单所需字段的CreateOrderRequestDTO，其中只保留personId而非完整的Person对象。后端通过personId校验数据库中是否存在对应Person，再将DTO转换为Order实体进行持久化。

代码实现 #

1. 定义请求DTO

import jakarta.validation.constraints.NotNull;
import java.math.BigDecimal;
import java.time.LocalDate;

public class CreateOrderRequestDTO {
    @NotNull(message = "订单日期不能为空")
    private LocalDate date;
    
    @NotNull(message = "订单金额不能为空")
    private BigDecimal price;
    
    @NotNull(message = "关联用户ID不能为空")
    private Long personId;

    // Getters & Setters
}

2. Controller层处理请求

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.server.ResponseStatusException;

@RestController
public class OrderController {
    private final OrderRepository orderRepository;
    private final PersonRepository personRepository;

    // 构造函数注入依赖
    public OrderController(OrderRepository orderRepository, PersonRepository personRepository) {
        this.orderRepository = orderRepository;
        this.personRepository = personRepository;
    }

    @PostMapping("/orders")
    public ResponseEntity<Void> createOrder(@RequestBody @Valid CreateOrderRequestDTO request) {
        // 校验Person是否存在
        Person person = personRepository.findById(request.getPersonId())
                .orElseThrow(() -> new ResponseStatusException(HttpStatus.BAD_REQUEST, "关联用户不存在"));
        
        // 将DTO转换为Order实体
        Order order = new Order();
        order.setDate(request.getDate());
        order.setPrice(request.getPrice());
        order.setPerson(person);
        
        orderRepository.save(order);
        return ResponseEntity.status(HttpStatus.CREATED).build();
    }
}

3. 请求JSON示例

{
    "date": "2023-01-01",
    "price": 10.00,
    "personId": 1
}

方案优势 #

• REST规范友好：POST请求到/orders是创建订单资源的标准路径，无歧义，符合API设计最佳实践
• 数据校验清晰：仅接收必要字段，避免客户端传递冗余的Person信息，同时在服务端严格校验Person存在性
• 解耦请求与实体：DTO与Order实体分离，后续若请求字段变化，无需修改核心实体类，扩展性更强

进阶优化：自定义校验注解 #

可以将Person存在性校验逻辑抽离为自定义注解，让Controller代码更简洁：

// 自定义校验注解
import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = PersonExistsValidator.class)
public @interface PersonExists {
    String message() default "关联用户不存在";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

// 注解实现类
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;

public class PersonExistsValidator implements ConstraintValidator<PersonExists, Long> {
    private final PersonRepository personRepository;

    public PersonExistsValidator(PersonRepository personRepository) {
        this.personRepository = personRepository;
    }

    @Override
    public boolean isValid(Long personId, ConstraintValidatorContext context) {
        return personId != null && personRepository.existsById(personId);
    }
}

在DTO中使用该注解：

public class CreateOrderRequestDTO {
    // ...其他字段
    @PersonExists
    private Long personId;
}

此时Controller无需手动编写校验逻辑，Spring会自动触发校验并抛出异常。

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