Browse Source

Move "Testing With Spring Security" How-to

See gh-26262
pull/26591/head
Phillip Webb 5 years ago
parent
commit
72d50ed2f8
  1. 2
      spring-boot-project/spring-boot-docs/src/docs/asciidoc/anchor-rewrite.properties
  2. 2
      spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/testing.adoc
  3. 4
      spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto.adoc
  4. 13
      spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/testing.adoc
  5. 2
      spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/howto/testing/withspringsecurity/MySecurityTests.java
  6. 2
      spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/howto/testing/withspringsecurity/UserController.java

2
spring-boot-project/spring-boot-docs/src/docs/asciidoc/anchor-rewrite.properties

@ -2527,7 +2527,7 @@ howto.spring-mvc.customize-view-resolvers @@ -2527,7 +2527,7 @@ howto.spring-mvc.customize-view-resolvers
# 2 == Testing With Spring Security
howto-use-test-with-spring-security=\
howto.testing-with-spring-security
howto.spring-mvc.testing.with-spring-security
# 2 == Jersey
howto-jersey=\

2
spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/testing.adoc

@ -404,7 +404,7 @@ If you define your own `webDriver` scope you may find it stops working when you @@ -404,7 +404,7 @@ If you define your own `webDriver` scope you may find it stops working when you
If you have Spring Security on the classpath, `@WebMvcTest` will also scan `WebSecurityConfigurer` beans.
Instead of disabling security completely for such tests, you can use Spring Security's test support.
More details on how to use Spring Security's `MockMvc` support can be found in this _<<howto#howto.testing-with-spring-security>>_ how-to section.
More details on how to use Spring Security's `MockMvc` support can be found in this _<<howto#howto.testing.with-spring-security>>_ how-to section.
TIP: Sometimes writing Spring MVC tests is not enough; Spring Boot can help you run <<features#features.testing.spring-boot-applications.with-running-server, full end-to-end tests with an actual server>>.

4
spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto.adoc

@ -23,8 +23,6 @@ include::howto/webserver.adoc[] @@ -23,8 +23,6 @@ include::howto/webserver.adoc[]
include::howto/spring-mvc.adoc[]
include::howto/testing-with-spring-security.adoc[]
include::howto/jersey.adoc[]
include::howto/http-clients.adoc[]
@ -45,6 +43,8 @@ include::howto/security.adoc[] @@ -45,6 +43,8 @@ include::howto/security.adoc[]
include::howto/hotswapping.adoc[]
include::howto/testing.adoc[]
include::howto/build.adoc[]
include::howto/traditional-deployment.adoc[]

13
spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/testing-with-spring-security.adoc → spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto/testing.adoc

@ -1,11 +1,18 @@ @@ -1,11 +1,18 @@
[[howto.testing-with-spring-security]]
== Testing With Spring Security
[[howto.testing]]
== Testing
Spring Boot includes a number of testing utilities and support classes as well as a dedicated starter that provides common test dependencies.
This section answers common questions about testing.
[[howto.testing.with-spring-security]]
=== Testing With Spring Security
Spring Security provides support for running tests as a specific user.
For example, the test in the snippet below will run with an authenticated user that has the `ADMIN` role.
[source,java,indent=0,subs="verbatim"]
----
include::{docs-java}/howto/testingwithspringsecurity/MySecurityTests.java[]
include::{docs-java}/howto/testing/withspringsecurity/MySecurityTests.java[]
----
Spring Security provides comprehensive integration with Spring MVC Test and this can also be used when testing controllers using the `@WebMvcTest` slice and `MockMvc`.

2
spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/howto/testingwithspringsecurity/MySecurityTests.java → spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/howto/testing/withspringsecurity/MySecurityTests.java

@ -14,7 +14,7 @@ @@ -14,7 +14,7 @@
* limitations under the License.
*/
package org.springframework.boot.docs.howto.testingwithspringsecurity;
package org.springframework.boot.docs.howto.testing.withspringsecurity;
import org.junit.jupiter.api.Test;

2
spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/howto/testingwithspringsecurity/UserController.java → spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/howto/testing/withspringsecurity/UserController.java

@ -14,7 +14,7 @@ @@ -14,7 +14,7 @@
* limitations under the License.
*/
package org.springframework.boot.docs.howto.testingwithspringsecurity;
package org.springframework.boot.docs.howto.testing.withspringsecurity;
class UserController {
Loading…
Cancel
Save