From ad2cb501b8f8b6d2f47974b58ec45f15cfd3b37c Mon Sep 17 00:00:00 2001
From: Rob Winch <rwinch@users.noreply.github.com>
Date: Mon, 11 Jun 2018 17:13:24 -0500
Subject: [PATCH] Add cross references to ReactorContextTestExecutionListener

Fixes: gh-5418
---
 docs/manual/src/docs/asciidoc/_includes/test.adoc               | 1 +
 .../test/context/annotation/SecurityTestExecutionListeners.java | 2 ++
 .../context/support/ReactorContextTestExecutionListener.java    | 2 ++
 .../support/WithSecurityContextTestExecutionListener.java       | 2 ++
 4 files changed, 7 insertions(+)

diff --git a/docs/manual/src/docs/asciidoc/_includes/test.adoc b/docs/manual/src/docs/asciidoc/_includes/test.adoc
index 7d4b125e09..6cef09b01b 100644
--- a/docs/manual/src/docs/asciidoc/_includes/test.adoc
+++ b/docs/manual/src/docs/asciidoc/_includes/test.adoc
@@ -54,6 +54,7 @@ This is a basic example of how to setup Spring Security Test. The highlights are
 
 NOTE: Spring Security hooks into Spring Test support using the `WithSecurityContextTestExecutionListener` which will ensure our tests are ran with the correct user.
 It does this by populating the `SecurityContextHolder` prior to running our tests.
+If you are using reactive method security, you will also need `ReactorContextTestExecutionListener` which populates `ReactiveSecurityContextHolder`.
 After the test is done, it will clear out the `SecurityContextHolder`.
 If you only need Spring Security related support, you can replace `@ContextConfiguration` with `@SecurityTestExecutionListeners`.
 
diff --git a/test/src/main/java/org/springframework/security/test/context/annotation/SecurityTestExecutionListeners.java b/test/src/main/java/org/springframework/security/test/context/annotation/SecurityTestExecutionListeners.java
index d8cab45f09..406841eaee 100644
--- a/test/src/main/java/org/springframework/security/test/context/annotation/SecurityTestExecutionListeners.java
+++ b/test/src/main/java/org/springframework/security/test/context/annotation/SecurityTestExecutionListeners.java
@@ -36,6 +36,8 @@ import org.springframework.test.context.TestExecutionListeners;
  *
  * @author Rob Winch
  * @since 4.0.2
+ * @see WithSecurityContextTestExecutionListener
+ * @see ReactorContextTestExecutionListener
  */
 @Documented
 @Inherited
diff --git a/test/src/main/java/org/springframework/security/test/context/support/ReactorContextTestExecutionListener.java b/test/src/main/java/org/springframework/security/test/context/support/ReactorContextTestExecutionListener.java
index c6616897af..d6e0f10faa 100644
--- a/test/src/main/java/org/springframework/security/test/context/support/ReactorContextTestExecutionListener.java
+++ b/test/src/main/java/org/springframework/security/test/context/support/ReactorContextTestExecutionListener.java
@@ -37,6 +37,8 @@ import reactor.util.context.Context;
  *
  * @author Rob Winch
  * @since 5.0
+ * @see WithSecurityContextTestExecutionListener
+ * @see org.springframework.security.test.context.annotation.SecurityTestExecutionListeners
  */
 public class ReactorContextTestExecutionListener
 	extends DelegatingTestExecutionListener {
diff --git a/test/src/main/java/org/springframework/security/test/context/support/WithSecurityContextTestExecutionListener.java b/test/src/main/java/org/springframework/security/test/context/support/WithSecurityContextTestExecutionListener.java
index 50304b39da..97268bb980 100644
--- a/test/src/main/java/org/springframework/security/test/context/support/WithSecurityContextTestExecutionListener.java
+++ b/test/src/main/java/org/springframework/security/test/context/support/WithSecurityContextTestExecutionListener.java
@@ -42,6 +42,8 @@ import org.springframework.test.web.servlet.MockMvc;
  * @author Rob Winch
  * @author Eddú Meléndez
  * @since 4.0
+ * @see ReactorContextTestExecutionListener
+ * @see org.springframework.security.test.context.annotation.SecurityTestExecutionListeners
  */
 public class WithSecurityContextTestExecutionListener
 		extends AbstractTestExecutionListener {