TestSecurityContextHolder (spring-security-docs API) - Javadoc

java.lang.Object
- org.springframework.security.test.context.TestSecurityContextHolder

```
public final class TestSecurityContextHolder
extends java.lang.Object
```
TestSecurityContextHolder は SecurityContextHolder と非常に似ていますが、テストに必要です。例: Web ベースのテスト用に SecurityContextHolder に目的の SecurityContext を設定することはできません。Web リクエストでは、SecurityContextPersistenceFilter は SecurityContextHolder を SecurityContextRepository によって返される値でオーバーライドします。FilterChain の終了時に、SecurityContextPersistenceFilter は SecurityContextHolder をクリアします。つまり、複数の Web リクエストを行うと、後続のリクエストでどの SecurityContext を使用するかがわかりません。一般的な使用箇所は次のとおりです。
- テストが実行される前に、TestSecurityContextHolder にデータが入力されます。通常、これは WithSecurityContextTestExecutionListener を使用して行われます
- テストが実行されます。MockMvc で使用する場合、通常は SecurityMockMvcRequestPostProcessors.testSecurityContext() で使用します。これにより、TestSecurityContextHolder からの SecurityContext が適切に設定されます。
- テストが実行された後、TestSecurityContextHolder と SecurityContextHolder はクリアされます
導入:
4.0

方法の概要

すべてのメソッド静的メソッド具象メソッド
修飾子と型	メソッド	説明
`static void`	`clearContext()`	`TestSecurityContextHolder` および `SecurityContextHolder` から `SecurityContext` をクリアします。
`static SecurityContext`	`getContext()`	`TestSecurityContextHolder` から `SecurityContext` を取得します。
`static void`	`setAuthentication(Authentication authentication)`	指定された `Authentication` で新しい `SecurityContext` を作成します。
`static void`	`setContext(SecurityContext context)`	`SecurityContext` を `TestSecurityContextHolder` および `SecurityContextHolder` に設定します。

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- メソッドの詳細
  - clearContext
```
public static void clearContext()
```
    TestSecurityContextHolder および SecurityContextHolder から SecurityContext をクリアします。
  - getContext
```
public static SecurityContext getContext()
```
    TestSecurityContextHolder から SecurityContext を取得します。
    戻り値:
    TestSecurityContextHolder から SecurityContext
  - setContext
```
public static void setContext(SecurityContext context)
```
    SecurityContext を TestSecurityContextHolder および SecurityContextHolder に設定します。
    パラメーター:
    context - 使用する SecurityContext
  - setAuthentication
```
public static void setAuthentication(Authentication authentication)
```
    指定された Authentication を使用して新しい SecurityContext を作成します。SecurityContext は TestSecurityContextHolder と SecurityContextHolder に設定されています。
    パラメーター:
    authentication - 使用する Authentication
    導入:
    5.1.1