How Can I Generate Spring REST Docs Snippets from the Contracts?

当希望使用 Spring REST Docs 包含 API 的请求和响应时，如果您正在使用 MockMvc 和 RestAssuredMockMvc，您只需要对设置进行一些细微的更改。要执行此操作，请包含以下依赖项（如果您尚未这样做）：

  • maven

  • gradle

link:{standalone_restdocs_path}/http-server/pom.xml[role=include]
link:{standalone_restdocs_path}/http-server/build.gradle[role=include]

接下来，您需要对基类进行一些更改。以下示例使用 WebAppContext 和 RestAssured 的独立选项：

  • WebAppContext

  • Standalone

link:{standalone_restdocs_path}/http-server/src/test/java/com/example/fraud/FraudBaseWithWebAppSetup.java[role=include]
link:{standalone_restdocs_path}/http-server/src/test/java/com/example/fraud/FraudBaseWithStandaloneSetup.java[role=include]

您无需指定为生成的片段设置的输出目录（从 Spring REST Docs 版本 1.2.0.RELEASE 开始）。