public interface Invocation
Invocation.Builder
修飾子と型 | インターフェースと説明 |
---|---|
static interface | Invocation.Builder クライアントリクエスト呼び出しビルダー。 |
修飾子と型 | メソッドと説明 |
---|---|
Response | invoke() リクエストを同期的に呼び出し、レスポンスを受信します。 |
<T> T | invoke(ClassSE<T> responseType) リクエストを同期的に呼び出し、指定された型のレスポンスを受信します。 |
<T> T | invoke(GenericType<T> responseType) リクエストを同期的に呼び出し、指定されたジェネリクス型のレスポンスを受け取ります。 |
Invocation | property(StringSE name, ObjectSE value) この呼び出しによって表されるリクエストのコンテキストで新しいプロパティを設定します。 |
FutureSE<Response> | submit() 非同期呼び出しのリクエストを送信し、将来のレスポンスを受け取ります。 |
<T> FutureSE<T> | submit(ClassSE<T> responseType) 非同期呼び出しのリクエストを送信し、指定された型の将来のレスポンスを受信します。 |
<T> FutureSE<T> | submit(GenericType<T> responseType) 非同期呼び出しのリクエストを送信し、指定されたジェネリクス型の将来のレスポンスを受け取ります。 |
<T> FutureSE<T> | submit(InvocationCallback<T> callback) 非同期呼び出しのリクエストを送信し、 InvocationCallback を登録して、呼び出しの将来の結果を処理します。 |
Invocation property(StringSE name, ObjectSE value)
プロパティは ClientRequestContext.getProperty(String)
または InterceptorContext.getProperty(String)
を介して後で取得できます。指定された名前のプロパティがリクエストコンテキストですでに設定されている場合、プロパティの既存の値が更新されます。null
値をプロパティに設定すると、リクエストプロパティバッグからプロパティが効果的に削除されます。
name
- プロパティ名。value
- (新規)プロパティ値。null
値は、指定された名前のプロパティを削除します。Invocation.Builder.property(String, Object)
Response invoke()
response
オブジェクト。ResponseProcessingException
- 受信した HTTP レスポンスの処理が失敗した場合(たとえば、フィルターで、レスポンスエンティティデータを特定の Java 型のインスタンスに変換中に)。ProcessingException
- リクエスト処理または後続の I/O 操作が失敗した場合。<T> T invoke(ClassSE<T> responseType)
T
- レスポンスタイプ responseType
- レスポンスを変換する必要がある Java 型。ResponseProcessingException
- 受信した HTTP レスポンスの処理が失敗した場合(たとえば、フィルターで、レスポンスエンティティデータを特定の Java 型のインスタンスに変換中に)。ProcessingException
- リクエスト処理または後続の I/O 操作が失敗した場合。WebApplicationException
- サーバーから返されたレスポンスのレスポンスステータスコードが successful
ではなく、指定されたレスポンス型が Response
ではない場合。<T> T invoke(GenericType<T> responseType)
T
- 一般的なレスポンス型 responseType
- レスポンスを変換する必要があるジェネリクス Java 型を表す型リテラル。ResponseProcessingException
- 受信した HTTP レスポンスの処理が失敗した場合(たとえば、フィルターで、レスポンスエンティティデータを特定の Java 型のインスタンスに変換中に)。ProcessingException
- リクエスト処理または後続の I/O 操作が失敗した場合。WebApplicationException
- サーバーから返されたレスポンスのレスポンスステータスコードが successful
でない場合。FutureSE<Response> submit()
返された Future
インスタンスで Future.get()
SE メソッドを呼び出すと、呼び出し処理が失敗した場合にスローされた ProcessingException
をラップする ExecutionException
SE がスローされる可能性があることに注意してください。正しく受信されたレスポンスの処理が失敗した場合、ラップされた処理例外は ResponseProcessingException
型になり、処理が失敗した Response
インスタンスが含まれます。
response
オブジェクト。<T> FutureSE<T> submit(ClassSE<T> responseType)
返された Future
インスタンスで Future.get()
SE メソッドを呼び出すと、呼び出し処理が失敗した場合にスローされる ProcessingException
、または受信したレスポンスステータスコードが successful
でなく、指定された場合にスローされる WebApplicationException
またはそのサブクラスのいずれかをラップする ExecutionException
SE がスローされる場合があることに注意してください。レスポンス型は Response
ではありません。正しく受信されたレスポンスの処理が失敗した場合、ラップされた処理例外は ResponseProcessingException
型になり、処理が失敗した Response
インスタンスが含まれます。
T
- レスポンスタイプ responseType
- レスポンスを変換する必要がある Java 型。<T> FutureSE<T> submit(GenericType<T> responseType)
返された Future
インスタンスで Future.get()
SE メソッドを呼び出すと、呼び出し処理が失敗した場合にスローされる ProcessingException
、または受信したレスポンスステータスコードが successful
でなく、指定された場合にスローされる WebApplicationException
またはそのサブクラスのいずれかをラップする ExecutionException
SE がスローされる場合があることに注意してください。レスポンス型は Response
ではありません。正しく受信されたレスポンスの処理が失敗した場合、ラップされた処理例外は ResponseProcessingException
型になり、処理が失敗した Response
インスタンスが含まれます。
T
- 一般的なレスポンス型 responseType
- レスポンスを変換する必要があるジェネリクス Java 型を表す型リテラル。<T> FutureSE<T> submit(InvocationCallback<T> callback)
InvocationCallback
を登録して、呼び出しの将来の結果を処理します。 返された Future
インスタンスで Future.get()
SE メソッドを呼び出すと、呼び出し処理が失敗した場合にスローされる ProcessingException
、または受信したレスポンスステータスコードが successful
および汎用でない場合にスローされる WebApplicationException
またはそのサブクラスのいずれかをラップする ExecutionException
SE がスローされる場合があることに注意してください。提供されたレスポンスコールバックの型は Response
ではありません。正しく受信されたレスポンスの処理が失敗した場合、ラップされた処理例外は ResponseProcessingException
型になり、処理が失敗した Response
インスタンスが含まれます。
T
- レスポンスタイプ callback
- リクエスト呼び出し結果の非同期処理のための呼び出しコールバック。Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.