MockRestServiceServer (Spring Framework API)

java.lang.ObjectSE
- org.springframework.test.web.client.MockRestServiceServer

```
public final class MockRestServiceServer
extends ObjectSE
```
クライアント側 REST テストのメインエントリポイント。RestTemplate を直接または間接的に使用するテストに使用します。RestTemplate を介して実行される予想されるリクエストと、返送するモックレスポンスを設定する方法を提供するため、実際のサーバーの必要性がなくなります。
以下は、MockRestRequestMatchers、MockRestResponseCreators、ExpectedCount からの静的インポートを想定した例です。
```
 RestTemplate restTemplate = new RestTemplate()
 MockRestServiceServer server = MockRestServiceServer.bindTo(restTemplate).build();

 server.expect(manyTimes(), requestTo("/hotels/42")).andExpect(method(HttpMethod.GET))
     .andRespond(withSuccess("{ \"id\" : \"42\", \"name\" : \"Holiday Inn\"}", MediaType.APPLICATION_JSON));

 Hotel hotel = restTemplate.getForObject("/hotels/{id}", Hotel.class, 42);
 // Use the hotel instance...

 // Verify all expectations met
 server.verify();
 
```
上記の代わりに、MockMvc のインスタンスに対してリクエストを実行できるようにする RestTemplate に MockMvcClientHttpRequestFactory を設定することもできます。
導入:
3.2
作成者:
Craig Walls, Rossen Stoyanchev

ネストされたクラスのサマリー
ネストされたクラス
修飾子と型クラスと説明
static interface MockRestServiceServer.MockRestServiceServerBuilder
MockRestServiceServer を作成するビルダー。

ネストされたクラス
修飾子と型	クラスと説明
`static interface`	`MockRestServiceServer.MockRestServiceServerBuilder` `MockRestServiceServer` を作成するビルダー。

メソッドのサマリー

すべてのメソッド静的メソッドインスタンスメソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`static MockRestServiceServer.MockRestServiceServerBuilder`	`bindTo(AsyncRestTemplate asyncRestTemplate)` 使用すべきではありません。 `AsyncRestTemplate` 自体の非推奨通知を参照してください
`static MockRestServiceServer.MockRestServiceServerBuilder`	`bindTo(RestGatewaySupport restGatewaySupport)` 指定された `RestGatewaySupport` に応答するために使用する必要がある `MockRestServiceServer` のビルダーを返します。
`static MockRestServiceServer.MockRestServiceServerBuilder`	`bindTo(RestTemplate restTemplate)` 指定された `RestTemplate` に応答するために使用する必要がある `MockRestServiceServer` のビルダーを返します。
`static MockRestServiceServer`	`createServer(AsyncRestTemplate asyncRestTemplate)` 使用すべきではありません。 `AsyncRestTemplate` 自体の非推奨通知を参照してください
`static MockRestServiceServer`	`createServer(RestGatewaySupport restGateway)` `bindTo(restGateway).build()` のショートカット。
`static MockRestServiceServer`	`createServer(RestTemplate restTemplate)` `bindTo(restTemplate).build()` のショートカット。
`ResponseActions`	`expect(ExpectedCount count, RequestMatcher matcher)` リクエストの実行が予想される回数も示す `expect(RequestMatcher)` の代替。
`ResponseActions`	`expect(RequestMatcher matcher)` 単一の HTTP リクエストに対する期待を設定します。
`void`	`reset()` すべての期待値と記録されたリクエストを削除して内部状態をリセットします。
`void`	`verify()` `expect(RequestMatcher)` を介して設定されたすべての予想されるリクエストが実際に実行されたことを確認します。
`void`	`verify(DurationSE timeout)` すべての期待が満たされるまで指定された時間まで待機する `verify()` のバリアント。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- メソッドの詳細
  - expect
```
public ResponseActions expect(RequestMatcher matcher)
```
    単一の HTTP リクエストに対する期待を設定します。返された ResponseActions を使用して、さらに期待を設定し、レスポンスを定義できます。
    このメソッドは、予想されるすべてのリクエストをセットアップするために、基礎となる RestTemplate を介してリクエストを開始する前に何度でも呼び出すことができます。
    パラメーター:
    matcher - リクエストマッチャー
    戻り値:
    期待の表現
  - expect
```
public ResponseActions expect(ExpectedCount count,
                              RequestMatcher matcher)
```
    リクエストの実行が予想される回数も示す expect(RequestMatcher) の代替。
    リクエストの期待値が 1 よりも大きい場合、最初の実行のみが宣言の順序と一致することが期待されます。後続のリクエスト実行は、その後どこにでも挿入できます。
    パラメーター:
    count - 予想される数
    matcher - リクエストマッチャー
    戻り値:
    期待の表現
    導入:
    4.3
  - verify
```
public void verify()
```
    expect(RequestMatcher) を介して設定されたすべての予想されるリクエストが実際に実行されたことを確認します。
    例外:
    AssertionErrorSE - すべての期待が満たされていない場合
  - verify
```
public void verify(DurationSE timeout)
```
    すべての期待が満たされるまで指定された時間まで待機する verify() のバリアント。これは、非同期リクエストを含むテストに役立ちます。
    パラメーター:
    timeout - すべての期待が満たされるのを待つ時間
    例外:
    AssertionErrorSE - 指定されたタイムアウトまでにすべての期待が満たされなかった場合、またはそれ以前のいずれかの時点で期待が失敗した場合。
    導入:
    5.3.4
  - reset
```
public void reset()
```
    すべての期待値と記録されたリクエストを削除して内部状態をリセットします。
  - bindTo
```
public static MockRestServiceServer.MockRestServiceServerBuilder bindTo(RestTemplate restTemplate)
```
    指定された RestTemplate に応答するために使用する必要がある MockRestServiceServer のビルダーを返します。
    導入:
    4.3
  - bindTo
```
@DeprecatedSE
public static MockRestServiceServer.MockRestServiceServerBuilder bindTo(AsyncRestTemplate asyncRestTemplate)
```
    非推奨。AsyncRestTemplate 自体の非推奨通知を参照してください
    指定された AsyncRestTemplate に応答するために使用する必要がある MockRestServiceServer のビルダーを返します。
    導入:
    4.3
  - bindTo
```
public static MockRestServiceServer.MockRestServiceServerBuilder bindTo(RestGatewaySupport restGatewaySupport)
```
    指定された RestGatewaySupport に応答するために使用する必要がある MockRestServiceServer のビルダーを返します。
    導入:
    4.3
  - createServer
```
public static MockRestServiceServer createServer(RestTemplate restTemplate)
```
    bindTo(restTemplate).build() のショートカット。
    パラメーター:
    restTemplate - RestTemplate でモックテストをセットアップする
    戻り値:
    モックサーバー
  - createServer
```
@DeprecatedSE
public static MockRestServiceServer createServer(AsyncRestTemplate asyncRestTemplate)
```
    非推奨。AsyncRestTemplate 自体の非推奨通知を参照してください
    bindTo(asyncRestTemplate).build() のショートカット。
    パラメーター:
    asyncRestTemplate - AsyncRestTemplate でモックテストをセットアップする
    戻り値:
    作成されたモックサーバー
  - createServer
```
public static MockRestServiceServer createServer(RestGatewaySupport restGateway)
```
    bindTo(restGateway).build() のショートカット。
    パラメーター:
    restGateway - モックテスト用にセットアップする REST ゲートウェイ
    戻り値:
    作成されたモックサーバー

クラス MockRestServiceServer

ネストされたクラスのサマリー

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

メソッドの詳細

expect

expect

verify

verify

reset

bindTo

bindTo

bindTo

createServer

createServer

createServer