我荣幸地代表所有贡献者宣布Spring REST Docs 1.2.0.RELEASE 版本已发布。它可从Maven Central、JCenter和我们的发布仓库获取。

新增功能？

1.2版本新增功能的完整概述可在发行说明中找到。以下是一些亮点。

改进的Asciidoctor集成

REST Docs现在有一个新的模块，spring-restdocs-asciidoctor，它使在文档中使用生成的代码片段更容易。一个新的宏意味着您可以在一行中导入同一操作的多个代码片段。样本的此更新显示了采用宏的好处。

更好地支持大型和复杂有效负载的文档编制

为了使您的文档更容易阅读，现在可以拆分大型和复杂有效负载的文档。可以分别记录有效负载的子部分，允许您的文档指导用户完成重要的部分。

请求和响应正文的代码片段

记录请求或响应正文的代码片段现在包含在默认代码片段中。您还可以显式使用这些代码片段来记录大型或复杂正文的子部分。

将Spring REST Docs 1.2与Spring Boot 1.5一起使用

默认情况下，Spring Boot 1.5使用Spring REST Docs 1.1。要使用1.2，请在您的pom.xml中覆盖Boot的依赖项管理中配置的版本。

<properties>
    <spring-restdocs.version>1.2.0.RELEASE</spring-restdocs.version>
</properties>

或build.gradle

ext['spring-restdocs.version']=1.2.0.RELEASE

下一步是什么？

该项目的主要重点现在将转向Spring REST Docs 2.0。虽然1.2与即将推出的Spring Framework 5兼容，但2.0将需要它和Java 8。这应该允许REST Docs支持使用WebTestClient记录API，并利用Java 8语言特性。

GitHub | 问题 | 文档 | Twitter | Gitter | Stack Overflow