Add support for using WebFlux's WebTestClient to document an API

Closes gh-384

samples/web-test-client/src/docs/asciidoc/index.adoc

@@ -0,0 +1,33 @@
+= Spring REST Docs WebTestClient Sample
+Andy Wilkinson;
+:doctype: book
+:icons: font
+:source-highlighter: highlightjs
+
+Sample application demonstrating how to use Spring REST Docs with Spring Framework's
+WebTestClient.
+
+`SampleWebTestClientApplicationTests` makes a call to a very simple service. Six
+snippets are produced. One showing how to make a request using cURL:
+
+include::{snippets}/sample/curl-request.adoc[]
+
+One showing how to make a request using HTTPie:
+
+include::{snippets}/sample/httpie-request.adoc[]
+
+One showing the HTTP request:
+
+include::{snippets}/sample/http-request.adoc[]
+
+One showing the request body:
+
+include::{snippets}/sample/request-body.adoc[]
+
+One showing the HTTP response:
+
+include::{snippets}/sample/http-response.adoc[]
+
+And one showing the response body:
+
+include::{snippets}/sample/response-body.adoc[]

samples/web-test-client/src/main/java/com/example/webtestclient/SampleWebTestClientApplication.java

@@ -0,0 +1,48 @@
+/*
+ * Copyright 2014-2017 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.webtestclient;
+
+import org.springframework.context.annotation.AnnotationConfigApplicationContext;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.server.reactive.ReactorHttpHandlerAdapter;
+import org.springframework.web.reactive.config.EnableWebFlux;
+import org.springframework.web.reactive.function.server.RequestPredicates;
+import org.springframework.web.reactive.function.server.RouterFunction;
+import org.springframework.web.reactive.function.server.RouterFunctions;
+import org.springframework.web.reactive.function.server.ServerResponse;
+
+import reactor.ipc.netty.http.server.HttpServer;
+
+@EnableWebFlux
+@Configuration
+public class SampleWebTestClientApplication {
+
+	@Bean
+	public RouterFunction<ServerResponse> routerFunction() {
+		return RouterFunctions.route(RequestPredicates.GET("/"), (request) -> ServerResponse.status(HttpStatus.OK).syncBody("Hello, World"));
+	}
+
+	public static void main(String[] args) {
+		RouterFunction<?> routerFunction = new AnnotationConfigApplicationContext(SampleWebTestClientApplication.class).getBean(RouterFunction.class);
+		ReactorHttpHandlerAdapter adapter = new ReactorHttpHandlerAdapter(RouterFunctions.toHttpHandler(routerFunction));
+		HttpServer httpServer = HttpServer.create(8080);
+		httpServer.startAndAwait(adapter);
+	}
+
+}

samples/web-test-client/src/test/java/com/example/webtestclient/SampleWebTestClientApplicationTests.java

@@ -0,0 +1,60 @@
+/*
+ * Copyright 2014-2017 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.webtestclient;
+
+import org.junit.Before;
+import org.junit.Rule;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.context.ApplicationContext;
+import org.springframework.restdocs.JUnitRestDocumentation;
+import org.springframework.test.context.ContextConfiguration;
+import org.springframework.test.context.junit4.SpringRunner;
+import org.springframework.test.web.reactive.server.WebTestClient;
+
+import static org.springframework.restdocs.webtestclient.WebTestClientRestDocumentation.document;
+import static org.springframework.restdocs.webtestclient.WebTestClientRestDocumentation.documentationConfiguration;
+
+@RunWith(SpringRunner.class)
+@ContextConfiguration(classes = SampleWebTestClientApplication.class)
+public class SampleWebTestClientApplicationTests {
+
+	@Rule
+	public final JUnitRestDocumentation restDocumentation = new JUnitRestDocumentation();
+
+	@Autowired
+	ApplicationContext context;
+
+	private WebTestClient webTestClient;
+
+	@Before
+	public void setUp() {
+		this.webTestClient = WebTestClient.bindToApplicationContext(context)
+			.configureClient().baseUrl("https://api.example.com")
+			.filter(documentationConfiguration(restDocumentation))
+			.build();
+	}
+
+	@Test
+	public void sample() throws Exception {
+		this.webTestClient.get().uri("/").exchange()
+			.expectStatus().isOk().expectBody()
+			.consumeWith(document("sample"));
+	}
+
+}