含计算属性的资源的REST POST端点设计可行模式咨询

核心思路 #

复用POST与GET的DTO结构，通过明确的字段规则和处理逻辑，既保证API表现力，又让行为完全可预测——核心是对自动生成字段做「输入忽略+强制覆盖」处理，同时通过文档明确告知消费者规则。

具体实现 #

• DTO设计：使用同一个BookDto结构承载POST输入和GET输出，在DTO的注释或API文档中标注：author字段由系统根据书名自动计算，用户输入的该字段值会被忽略。
• 请求处理逻辑：
  • 接收POST请求时，直接丢弃用户传入的author值（无论是否存在）。
  • 按照预设规则计算author并填充到DTO中。
  • 持久化后，返回包含完整字段的BookDto，和GET接口返回结构完全一致。
• 友好提示：如果用户传入了author字段，可在响应头中添加Warning: 299 "author字段由系统自动生成，你的输入已被忽略"，给用户明确的反馈但不中断请求。

方案优势 #

1. DTO一致性：消费者无需维护两套模型，降低对接成本。
2. 行为可预测：不管用户传不传author，最终结果都是API计算的确定值，不会出现不可控情况。
3. 无一致性问题：GET返回的author和POST创建时生成的值完全匹配，避免前后数据矛盾。
4. 表现力清晰：通过文档和响应提示明确规则，符合REST的透明化设计原则。

可选优化 #

如果需要更明确的场景区分，可以基于基础BookDto继承出CreateBookDto，仅调整author字段的校验规则（标记为可选且忽略输入），结构上和BookDto保持一致——既保留结构统一，又通过DTO命名强化创建场景的规则。

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