配置 (Configuration) | Spring REST Docsversion 3.0.2-SNAPSHOT中文文档|Spring官方文档|SpringBoot 教程|Spring中文网

配置

本节介绍如何配置 Spring REST Docs。spring-doc.cn

记录的 URI

本节介绍如何配置记录的 URI。spring-doc.cn

MockMvc URI 自定义

使用 MockMvc 时，Spring REST Docs 记录的 URI 的默认配置如下：spring-doc.cn

设置违约

设置	违约
方案spring-doc.cn	`http`spring-doc.cn
主机spring-doc.cn	`localhost`spring-doc.cn
港口spring-doc.cn	`8080`spring-doc.cn

方案spring-doc.cn

httpspring-doc.cn

主机spring-doc.cn

localhostspring-doc.cn

港口spring-doc.cn

8080spring-doc.cn

此配置由应用。您可以使用其 API 更改一个或多个默认值以满足您的需求。以下示例显示了如何执行此操作：MockMvcRestDocumentationConfigurerspring-doc.cn

this.mockMvc = MockMvcBuilders.webAppContextSetup(this.context)
	.apply(documentationConfiguration(this.restDocumentation).uris()
		.withScheme("https")
		.withHost("example.com")
		.withPort(443))
	.build();

如果端口设置为已配置方案的默认值（HTTP 的端口 80 或 HTTPS 的端口 443），则生成的代码段中的任何 URI 都会省略该端口。

要配置请求的上下文路径，请使用上的方法。contextPathMockHttpServletRequestBuilder

REST Assured URI 自定义

REST Assured 通过发出实际的 HTTP 请求来测试服务。因此，URI 必须为在对服务执行操作后但在执行之前进行自定义记录。特定于 REST 的为此目的提供了 preprocessor。spring-doc.cn

WebTestClient URI 自定义

使用 WebTestClient 时，Spring REST Docs 记录的 URI 的默认基数是。您可以使用 WebTestClient.Builder 上的 baseUrl（String） 方法自定义此基础。以下示例显示了如何执行此操作：http://localhost:8080spring-doc.cn

@Before
public void setUp() {
	this.webTestClient = WebTestClient.bindToApplicationContext(this.context)
		.configureClient()
		.baseUrl("https://api.example.com") (1)
		.filter(documentationConfiguration(this.restDocumentation))
		.build();
}

1	将记录的 URI 的基数配置为。`https://api.example.com`

代码段编码

默认代码段编码为 . 您可以使用 API 更改默认代码段编码。例如，以下示例使用：UTF-8RestDocumentationConfigurerISO-8859-1spring-doc.cn

MockMvc

this.mockMvc = MockMvcBuilders.webAppContextSetup(this.context)
	.apply(documentationConfiguration(this.restDocumentation).snippets().withEncoding("ISO-8859-1"))
	.build();

WebTest客户端

this.webTestClient = WebTestClient.bindToApplicationContext(this.context).configureClient()
	.filter(documentationConfiguration(this.restDocumentation)
		.snippets().withEncoding("ISO-8859-1"))
	.build();

放心

this.spec = new RequestSpecBuilder()
	.addFilter(documentationConfiguration(this.restDocumentation).snippets().withEncoding("ISO-8859-1"))
	.build();

当 Spring REST Docs 将请求或响应的内容转换为 a 时，如果可用，则使用 Headers 中指定的内容。如果没有它，则使用 JVM 的默认值。您可以使用 system 属性配置 JVM 的默认值。StringcharsetContent-TypeCharsetCharsetfile.encoding

代码段模板格式

默认的 snippet 模板格式为 Asciidoctor。 Markdown 也支持开箱即用。您可以使用 API 更改默认格式。以下示例说明如何执行此操作：RestDocumentationConfigurerspring-doc.cn

MockMvc

this.mockMvc = MockMvcBuilders.webAppContextSetup(this.context)
	.apply(documentationConfiguration(this.restDocumentation).snippets()
		.withTemplateFormat(TemplateFormats.markdown()))
	.build();

WebTest客户端

this.webTestClient = WebTestClient.bindToApplicationContext(this.context).configureClient()
	.filter(documentationConfiguration(this.restDocumentation)
		.snippets().withTemplateFormat(TemplateFormats.markdown()))
	.build();

放心

this.spec = new RequestSpecBuilder()
	.addFilter(documentationConfiguration(this.restDocumentation).snippets()
		.withTemplateFormat(TemplateFormats.markdown()))
	.build();

默认代码段

默认情况下，会生成 6 个代码段：spring-doc.cn

curl-requestspring-doc.cn
http-requestspring-doc.cn
http-responsespring-doc.cn
httpie-requestspring-doc.cn
request-bodyspring-doc.cn
response-bodyspring-doc.cn

您可以在设置过程中使用 API 更改默认代码段配置。默认情况下，以下示例仅生成代码段：RestDocumentationConfigurercurl-requestspring-doc.cn

MockMvc

this.mockMvc = MockMvcBuilders.webAppContextSetup(this.context)
	.apply(documentationConfiguration(this.restDocumentation).snippets().withDefaults(curlRequest()))
	.build();

WebTest客户端

this.webTestClient = WebTestClient.bindToApplicationContext(this.context)
	.configureClient().filter(
		documentationConfiguration(this.restDocumentation)
			.snippets().withDefaults(curlRequest()))
	.build();

放心

this.spec = new RequestSpecBuilder()
	.addFilter(documentationConfiguration(this.restDocumentation).snippets().withDefaults(curlRequest()))
	.build();

默认操作预处理器

您可以在设置过程中使用 API 配置默认请求和响应预处理器。以下示例从所有请求中删除标头并漂亮打印所有响应：RestDocumentationConfigurerFoospring-doc.cn

MockMvc

this.mockMvc = MockMvcBuilders.webAppContextSetup(this.context)
	.apply(documentationConfiguration(this.restDocumentation).operationPreprocessors()
		.withRequestDefaults(modifyHeaders().remove("Foo")) (1)
		.withResponseDefaults(prettyPrint())) (2)
	.build();

1	应用一个请求预处理器，该处理器将删除名为 .`Foo`
2	应用一个响应预处理器，该预处理器可以漂亮地打印其内容。

WebTest客户端

this.webTestClient = WebTestClient.bindToApplicationContext(this.context)
	.configureClient()
	.filter(documentationConfiguration(this.restDocumentation)
		.operationPreprocessors()
			.withRequestDefaults(modifyHeaders().remove("Foo")) (1)
			.withResponseDefaults(prettyPrint())) (2)
	.build();

1	应用一个请求预处理器，该处理器将删除名为 .`Foo`
2	应用一个响应预处理器，该预处理器可以漂亮地打印其内容。

放心

this.spec = new RequestSpecBuilder()
	.addFilter(documentationConfiguration(this.restDocumentation).operationPreprocessors()
		.withRequestDefaults(modifyHeaders().remove("Foo")) (1)
		.withResponseDefaults(prettyPrint())) (2)
	.build();

1	应用一个请求预处理器，该处理器将删除名为 .`Foo`
2	应用一个响应预处理器，该预处理器可以漂亮地打印其内容。