我很高兴代表所有做出贡献的人宣布 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，请覆盖在 Boot 的依赖项管理中配置的版本 在您的 pom.xml 中

<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