Spring Boot中处理不同API操作的多接口设计最佳实践

针对你遇到的三个场景，用DTO（数据传输对象）区分不同业务场景，配合JPA关联映射处理关系是行业通用的最佳实践，具体实现如下：

1. 先完善实体类的JPA关联映射 #

首先要在实体类中建立Question和QuestionChoice的一对多关联，这样后续保存时能自动处理外键关联：

Question实体 #

@Entity
@Table(name = "Question")
public class Question {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;
    
    @Column(name = "id_survey")
    private Integer surveyId;
    
    private String description;
    // 其他数据库字段
    
    // 关联QuestionChoice，cascade=ALL表示保存/删除Question时同步处理选项
    @OneToMany(mappedBy = "question", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<QuestionChoice> choices = new ArrayList<>();
    
    // 辅助方法：添加选项时自动绑定关联关系
    public void addChoice(QuestionChoice choice) {
        choices.add(choice);
        choice.setQuestion(this);
    }
    
    // getter、setter
}

QuestionChoice实体 #

@Entity
@Table(name = "QuestionChoice")
public class QuestionChoice {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;
    
    // 关联Question，对应数据库id_question字段
    @ManyToOne
    @JoinColumn(name = "id_question")
    private Question question;
    
    private String description;
    // 其他数据库字段
    
    // getter、setter
}

2. 为不同场景定义DTO #

实体类只负责映射数据库，不同场景的请求/响应数据用DTO来封装：

场景1：仅返回Question实体 #

直接使用Question实体即可，如果需要屏蔽某些敏感字段，也可以定义一个QuestionBasicDTO，只保留需要返回的字段（比如id、surveyId、description等）。

场景2：返回包含QuestionChoices的Question #

创建带选项的响应DTO：

// 带选项的题目DTO
public class QuestionWithChoicesDTO {
    private Integer id;
    private Integer surveyId;
    private String description;
    // 其他需要返回的Question字段
    private List<QuestionChoiceDTO> choices;
    
    // getter、setter、全参/无参构造
}

// 选项DTO
public class QuestionChoiceDTO {
    private Integer id;
    private String description;
    // 其他需要返回的QuestionChoice字段
    
    // getter、setter
}

在Service或Controller层，将实体转换为DTO（可以用MapStruct、ModelMapper等工具简化转换，也可以手动赋值）。

场景3：创建Question的请求DTO #

创建时不需要传入id，选项也不需要传入id_question，定义专门的请求DTO：

// 创建题目的请求DTO
public class CreateQuestionRequest {
    private Integer surveyId;
    private String description;
    // 其他需要传入的Question字段（不含id）
    private List<CreateQuestionChoiceRequest> choices;
    
    // getter、setter
}

// 创建选项的请求DTO
public class CreateQuestionChoiceRequest {
    private String description;
    // 其他需要传入的QuestionChoice字段（不含id、id_question）
    
    // getter、setter
}

3. Controller层实现各场景接口 #

场景2：查询带选项的题目 #

@RestController
@RequestMapping("/api/questions")
public class QuestionController {
    private final QuestionRepository questionRepository;
    private final ModelMapper modelMapper; // 假设用ModelMapper做转换

    public QuestionController(QuestionRepository questionRepository, ModelMapper modelMapper) {
        this.questionRepository = questionRepository;
        this.modelMapper = modelMapper;
    }

    @GetMapping("/{id}/with-choices")
    public ResponseEntity<QuestionWithChoicesDTO> getQuestionWithChoices(@PathVariable Integer id) {
        Question question = questionRepository.findById(id)
                .orElseThrow(() -> new RuntimeException("题目不存在"));
        
        // 实体转DTO
        QuestionWithChoicesDTO dto = modelMapper.map(question, QuestionWithChoicesDTO.class);
        return ResponseEntity.ok(dto);
    }
}

场景3：创建带选项的题目 #

@PostMapping
public ResponseEntity<Question> createQuestion(@RequestBody CreateQuestionRequest request) {
    // 把请求DTO转成实体
    Question question = new Question();
    question.setSurveyId(request.getSurveyId());
    question.setDescription(request.getDescription());
    // 设置其他实体字段
    
    // 处理选项
    for (CreateQuestionChoiceRequest choiceReq : request.getChoices()) {
        QuestionChoice choice = new QuestionChoice();
        choice.setDescription(choiceReq.getDescription());
        // 设置其他选项字段
        question.addChoice(choice); // 自动绑定Question关联，无需手动设置id_question
    }
    
    Question savedQuestion = questionRepository.save(question);
    return ResponseEntity.status(HttpStatus.CREATED).body(savedQuestion);
}

关键说明 #

• DTO的核心作用：解耦数据库实体和前端数据结构，避免直接暴露实体导致的字段泄露、结构不匹配问题，同时灵活适配不同场景的字段需求。
• JPA关联的优势：通过cascade = CascadeType.ALL实现级联保存，配合addChoice方法自动维护外键关系，无需手动操作id_question字段。
• 转换工具：推荐用MapStruct（编译期生成转换代码，性能更高）替代手动赋值，减少重复代码。

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