メソッドの詳細

• onStatus

  WebClient.ResponseSpec onStatus(PredicateSE<HttpStatus> statusPredicate,
                                  FunctionSE<ClientResponse,reactor.core.publisher.Mono<? extends ThrowableSE>> exceptionFunction)

  特定のエラーステータスコードをエラーシグナルにマップして、レスポンスではなく下流に伝搬する関数を提供します。

  デフォルトでは、一致するステータスハンドラーがない場合、ステータスコードが 400 以上のレスポンスは、ClientResponse.createException() で作成された WebClientResponseException にマップされます。

  エラーとしてのステータスコードの処理を抑制し、それを通常のレスポンスとして処理するには、関数から Mono.empty() を返します。その後、レスポンスはダウンストリームに伝搬されて処理されます。

  エラーレスポンスを完全に無視し、レスポンスもエラーも伝播しないようにするには、filter を使用するか、onErrorResume ダウンストリームを追加します。例:

   webClient.get()
       .uri("https://abc.com/account/123")
       .retrieve()
       .bodyToMono(Account.class)
       .onErrorResume(WebClientResponseException.class,
            ex -> ex.getRawStatusCode() == 404 ? Mono.empty() : Mono.error(ex));
   

  パラメーター:

  statusPredicate - レスポンスを一致させる

  exceptionFunction - レスポンスをエラーシグナルにマッピングする

  戻り値:

  このビルダー

  関連事項:

  ClientResponse.createException()

• onRawStatus

  WebClient.ResponseSpec onRawStatus(IntPredicateSE statusCodePredicate,
                                     FunctionSE<ClientResponse,reactor.core.publisher.Mono<? extends ThrowableSE>> exceptionFunction)

  生のステータスコード値を処理する onStatus(Predicate, Function) のバリアント。これは、カスタムステータスコードに役立ちます。

  パラメーター:

  statusCodePredicate - レスポンスを一致させる

  exceptionFunction - レスポンスをエラーシグナルにマッピングする

  戻り値:

  このビルダー

  導入:

  5.1.9

• bodyToMono

  <T> reactor.core.publisher.Mono<T> bodyToMono(ClassSE<T> elementClass)

  ボディを Mono に抽出します。デフォルトでは、レスポンスのステータスコードが 4xx または 5xx の場合、Mono には WebClientException が含まれます。これは onStatus(Predicate, Function) でオーバーライドできます。

  型パラメーター:

  T - レスポンス本体型

  パラメーター:

  elementClass - 予期されるレスポンス本体要素クラス

  戻り値:

  本体を含む mono、またはステータスコードが 4xx または 5xx の場合は WebClientResponseException

• bodyToMono

  <T> reactor.core.publisher.Mono<T> bodyToMono(ParameterizedTypeReference<T> elementTypeRef)

  ボディを Mono に抽出します。デフォルトでは、レスポンスのステータスコードが 4xx または 5xx の場合、Mono には WebClientException が含まれます。これは onStatus(Predicate, Function) でオーバーライドできます。

  型パラメーター:

  T - レスポンス本体型

  パラメーター:

  elementTypeRef - 予期されるレスポンス本体要素型を説明する型参照

  戻り値:

  本体を含む mono、またはステータスコードが 4xx または 5xx の場合は WebClientResponseException

• bodyToFlux

  <T> reactor.core.publisher.Flux<T> bodyToFlux(ClassSE<T> elementClass)

  ボディを Flux に抽出します。デフォルトでは、レスポンスのステータスコードが 4xx または 5xx の場合、Flux には WebClientException が含まれます。これは onStatus(Predicate, Function) でオーバーライドできます。

  型パラメーター:

  T - レスポンスの要素の型

  パラメーター:

  elementClass - レスポンスの要素のクラス

  戻り値:

  本体を含む flux、またはステータスコードが 4xx または 5xx の場合は WebClientResponseException

• bodyToFlux

  <T> reactor.core.publisher.Flux<T> bodyToFlux(ParameterizedTypeReference<T> elementTypeRef)

  ボディを Flux に抽出します。デフォルトでは、レスポンスのステータスコードが 4xx または 5xx の場合、Flux には WebClientException が含まれます。これは onStatus(Predicate, Function) でオーバーライドできます。

  型パラメーター:

  T - レスポンスの要素の型

  パラメーター:

  elementTypeRef - 予期されるレスポンス本体要素型を説明する型参照

  戻り値:

  本体を含む flux、またはステータスコードが 4xx または 5xx の場合は WebClientResponseException

• toEntity

  <T> reactor.core.publisher.Mono<ResponseEntity<T>> toEntity(ClassSE<T> bodyClass)

  レスポンスを遅延 ResponseEntity として返します。デフォルトでは、レスポンスのステータスコードが 4xx または 5xx の場合、Mono には WebClientException が含まれます。これは onStatus(Predicate, Function) でオーバーライドできます。

  型パラメーター:

  T - レスポンス本体型

  パラメーター:

  bodyClass - 予想されるレスポンス本文型

  戻り値:

  Mono と ResponseEntity

  導入:

  5.2

• toEntity

  <T> reactor.core.publisher.Mono<ResponseEntity<T>> toEntity(ParameterizedTypeReference<T> bodyTypeReference)

  レスポンスを遅延 ResponseEntity として返します。デフォルトでは、レスポンスのステータスコードが 4xx または 5xx の場合、Mono には WebClientException が含まれます。これは onStatus(Predicate, Function) でオーバーライドできます。

  型パラメーター:

  T - レスポンス本体型

  パラメーター:

  bodyTypeReference - 予想されるレスポンス本文の種類を説明する型参照

  戻り値:

  Mono と ResponseEntity

  導入:

  5.2

• toEntityList

  <T> reactor.core.publisher.Mono<ResponseEntity<ListSE<T>>> toEntityList(ClassSE<T> elementClass)

  ResponseEntity の遅延リストとしてレスポンスを返します。デフォルトでは、レスポンスのステータスコードが 4xx または 5xx の場合、Mono には WebClientException が含まれます。これは onStatus(Predicate, Function) でオーバーライドできます。

  型パラメーター:

  T - リスト内の要素の型

  パラメーター:

  elementClass - 予想されるレスポンス本文リスト要素クラス

  戻り値:

   ResponseEntity のリストを持つ Mono 

  導入:

  5.2

• toEntityList

  <T> reactor.core.publisher.Mono<ResponseEntity<ListSE<T>>> toEntityList(ParameterizedTypeReference<T> elementTypeRef)

  ResponseEntity の遅延リストとしてレスポンスを返します。デフォルトでは、レスポンスのステータスコードが 4xx または 5xx の場合、Mono には WebClientException が含まれます。これは onStatus(Predicate, Function) でオーバーライドできます。

  型パラメーター:

  T - リスト内の要素の型

  パラメーター:

  elementTypeRef - 予想されるレスポンス本文リスト要素の参照型

  戻り値:

   ResponseEntity のリストを持つ Mono 

  導入:

  5.2

• toBodilessEntity

  reactor.core.publisher.Mono<ResponseEntity<VoidSE>> toBodilessEntity()

  ステータスとヘッダーを含むが本体は含まない遅延 ResponseEntity としてレスポンスを返します。デフォルトでは、レスポンスのステータスコードが 4xx または 5xx の場合、Mono には WebClientException が含まれます。これは onStatus(Predicate, Function) でオーバーライドできます。このメソッドを呼び出すと、レスポンスの本文が解放されます。

  戻り値:

  Mono とボディレス ResponseEntity

  導入:

  5.2