From b9a0e6bbf2b6fe5f0ed222f506efc644d0d9a4f0 Mon Sep 17 00:00:00 2001
From: Sebastien Deleuze <sdeleuze@pivotal.io>
Date: Fri, 27 Oct 2017 13:52:51 +0200
Subject: [PATCH] Update documentation about WebTestClient Kotlin issue

Issue: SPR-16057
---
 .../test/web/reactive/server/WebTestClient.java      |  7 +++++++
 src/docs/asciidoc/languages/kotlin.adoc              | 12 ++++++++++++
 src/docs/asciidoc/testing-webtestclient.adoc         |  4 ++++
 3 files changed, 23 insertions(+)

diff --git a/spring-test/src/main/java/org/springframework/test/web/reactive/server/WebTestClient.java b/spring-test/src/main/java/org/springframework/test/web/reactive/server/WebTestClient.java
index b35b347fd47..1462468fde5 100644
--- a/spring-test/src/main/java/org/springframework/test/web/reactive/server/WebTestClient.java
+++ b/spring-test/src/main/java/org/springframework/test/web/reactive/server/WebTestClient.java
@@ -66,6 +66,13 @@ import org.springframework.web.util.UriBuilderFactory;
  *
  * <p>See the static {@code bindToXxx} entry points for creating an instance.
  *
+ * <p><strong>Warning</strong>: {@code WebTestClient} is not usable yet in Kotlin due to a
+ * <a href="https://youtrack.jetbrains.com/issue/KT-5464">type inference issue</a> which is
+ * expected to be fixed as of Kotlin 1.3. You can watch
+ * <a href="https://jira.spring.io/browse/SPR-16057">SPR-16057</a> for up-to-date information.
+ * Meanwhile, the proposed alternative is to use directly {@link WebClient} with its Reactor
+ * and Spring Kotlin extensions to perform integration tests on an embedded WebFlux server.
+ *
  * @author Rossen Stoyanchev
  * @since 5.0
  */
diff --git a/src/docs/asciidoc/languages/kotlin.adoc b/src/docs/asciidoc/languages/kotlin.adoc
index 2fc2df615fa..46a29332ea1 100644
--- a/src/docs/asciidoc/languages/kotlin.adoc
+++ b/src/docs/asciidoc/languages/kotlin.adoc
@@ -654,6 +654,17 @@ class SpecificationLikeTests {
 ----
 
 
+[[kotlin-webtestclient-issue]]
+==== `WebTestClient` type inference issue in Kotlin
+
+`WebTestClient` is not usable yet in Kotlin due to a
+https://youtrack.jetbrains.com/issue/KT-5464[type inference issue] which is
+expected to be fixed as of Kotlin 1.3. You can watch
+https://jira.spring.io/browse/SPR-16057[SPR-16057] for up-to-date information. Meanwhile,
+the proposed alternative is to use directly `WebClient` with its Reactor and Spring Kotlin
+extensions to perform integration tests on an embedded WebFlux server.
+
+
 
 
 [[kotlin-getting-started]]
@@ -729,6 +740,7 @@ Here is a list of pending issues related to Spring + Kotlin support.
 
 ==== Spring Framework
 
+* https://jira.spring.io/browse/SPR-16057[Unable to use WebTestClient with mock server in Kotlin]
 * https://jira.spring.io/browse/SPR-15413[Add support for Kotlin coroutines]
 
 
diff --git a/src/docs/asciidoc/testing-webtestclient.adoc b/src/docs/asciidoc/testing-webtestclient.adoc
index 31740d49d22..f804201dc08 100644
--- a/src/docs/asciidoc/testing-webtestclient.adoc
+++ b/src/docs/asciidoc/testing-webtestclient.adoc
@@ -8,6 +8,10 @@ to any server over an HTTP connection. It can also bind directly to WebFlux appl
 with <<testing.adoc#mock-objects-web-reactive,mock request and response>> objects,
 without the need for an HTTP server.
 
+[NOTE]
+====
+`WebTestClient` is not usable yet in Kotlin, see <<languages.adoc#kotlin-webtestclient-issue, this section>> for more details.
+====