使用 Spring Rest Docs 记录单值响应控制器

【问题标题】：Documenting Single Value Response Controller w/ Spring Rest Docs使用 Spring Rest Docs 记录单值响应控制器
【发布时间】：2017-02-28 04:44:15
【问题描述】：

是否可以为返回单个值的控制器记录响应字段？

示例： [GET] /book/count

JSON 响应： 1

【问题讨论】：

【解决方案1】：

您不能使用响应字段 sn-p。它需要结构化的 JSON 或 XML 响应。鉴于您的响应是一个单一的数值，我认为您不会从 REST Docs 文档中获得太多收益。它几乎不需要记录和验证。

REST Docs 仍会自动生成您可以使用的 HTTP 响应 sn-p。如果你想要更多的东西，你可以很容易地编写自己的 Snippet 实现。

【讨论】：