领先一步
VMware 提供培训和认证,以快速提升您的进度。
了解更多谨代表所有贡献者,我很高兴地宣布 Spring REST Docs 1.2.0.RC1 已发布,可从 https://repo.spring.io/milestone/ 获取。
可以在 发行说明 中找到 1.2 版的新增功能完整概述。以下是其中的一些亮点。
REST Docs 现在有一个新的模块,spring-restdocs-asciidoctor
,它使在您的文档中使用生成的代码片段更容易。一个 新的宏 意味着您可以使用一行代码导入同一操作的多个代码片段。样本的此更新 显示了采用宏的好处。
为了使您的文档更容易阅读,现在可以拆分大型和复杂有效负载的文档。可以单独记录有效负载的子部分,从而使您的文档能够指导用户完成重要的部分。
现在,默认代码片段中包含记录请求或响应正文的代码片段。您还可以显式使用这些代码片段来记录大型或复杂正文的子部分。
我们希望在几周内发布一个正式版本。请试用候选版本,如果您发现任何问题或对一些最后一刻的改进有任何建议,请 告知我们。