インターフェース ServerResponse
- すべての既知のサブインターフェース:
AsyncServerResponse、EntityResponse<T>、RenderingResponse
public interface ServerResponse
- 導入:
- 5.2
- 作成者:
- Arjen Poutsma
ネストされたクラスの要約
ネストされたクラス修飾子と型インターフェース説明static interfaceレスポンスに本文を追加するビルダーを定義します。static interfacewriteTo(HttpServletRequest, HttpServletResponse, Context)中に使用されるコンテキストを定義します。static interfaceレスポンスにヘッダーを追加するビルダーを定義します。static interfaceサーバー送信イベントを送信するボディのビルダーを定義します。static interfaceストリーミングレスポンス本文のビルダーを定義します。メソッドのサマリー
修飾子と型メソッド説明static ServerResponse.BodyBuilderaccepted()202 Accepted ステータスのビルダーを作成します。static ServerResponse指定された非同期レスポンスを使用して(構築された)レスポンスを作成します。static ServerResponseasync(ObjectSE asyncResponse, DurationSE timeout) 指定された非同期レスポンスを使用して(構築された)レスポンスを作成します。static ServerResponse.BodyBuilder400 不正なリクエストステータスのビルダーを作成します。cookies()このレスポンスの Cookie を返します。static ServerResponse.BodyBuilder201 Created ステータスと特定の URI に設定されたロケーションヘッダーを使用してビルダーを作成します。static ServerResponsefrom(ErrorResponse response) 指定されたErrorResponseからServerResponseを作成します。static ServerResponse.BodyBuilderfrom(ServerResponse other) 指定されたレスポンスのステータスコードとヘッダーを使用してビルダーを作成します。headers()このレスポンスのヘッダーを返します。static ServerResponse.HeadersBuilder<?>204 コンテンツなしステータスのビルダーを作成します。static ServerResponse.HeadersBuilder<?>notFound()404 お探しのページが見つかりませんでしたステータスのビルダーを作成します。static ServerResponse.BodyBuilderok()ステータスを 200 OK に設定してビルダーを作成します。static ServerResponse.BodyBuilderpermanentRedirect(URISE location) 308 永久リダイレクトステータスと指定された URI に設定されたロケーションヘッダーを使用してビルダーを作成します。int非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。static ServerResponse.BodyBuilder303 他を見るステータスと指定された URI に設定されたロケーションヘッダーを使用してビルダーを作成します。static ServerResponsesse(ConsumerSE<ServerResponse.SseBuilder> consumer) サーバー送信イベントレスポンスを作成します。static ServerResponsesse(ConsumerSE<ServerResponse.SseBuilder> consumer, DurationSE timeout) サーバー送信イベントレスポンスを作成します。static ServerResponse.BodyBuilderstatus(int status) 指定された HTTP ステータスでビルダーを作成します。static ServerResponse.BodyBuilderstatus(HttpStatusCode status) 指定された HTTP ステータスでビルダーを作成します。このレスポンスのステータスコードを返します。static ServerResponse.BodyBuildertemporaryRedirect(URISE location) 307 一時的なリダイレクトステータスと指定された URI に設定されたロケーションヘッダーを使用してビルダーを作成します。static ServerResponse.BodyBuilder422 処理できないエンティティステータスのビルダーを作成します。writeTo(HttpServletRequestEE request, HttpServletResponseEE response, ServerResponse.Context context) このレスポンスを特定のサーブレットレスポンスに書き込みます。
メソッドの詳細
statusCode
HttpStatusCode statusCode()このレスポンスのステータスコードを返します。- 戻り値:
- HttpStatusCode 値としてのステータス
rawStatusCode
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。statusCode()を推奨し、7.0 から削除このレスポンスのステータスコードを整数で返します。- 戻り値:
- 整数としてのステータス
headers
HttpHeaders headers()このレスポンスのヘッダーを返します。cookies
MultiValueMap<StringSE,CookieEE> cookies()このレスポンスの Cookie を返します。writeTo
@Nullable ModelAndView writeTo(HttpServletRequestEE request, HttpServletResponseEE response, ServerResponse.Context context) throws ServletExceptionEE, IOExceptionSE このレスポンスを特定のサーブレットレスポンスに書き込みます。- パラメーター:
request- 現在のリクエストresponse- 書き込むレスポンスcontext- 書くときに使用するコンテキスト- 戻り値:
- レンダリングする
ModelAndView、または直接処理される場合はnull - 例外:
ServletExceptionEEIOExceptionSE
from
指定されたレスポンスのステータスコードとヘッダーを使用してビルダーを作成します。- パラメーター:
other- ステータスとヘッダーをコピーするレスポンス- 戻り値:
- 作成されたビルダー
from
指定されたErrorResponseからServerResponseを作成します。- パラメーター:
response- 初期化するErrorResponse- 戻り値:
- 構築されたレスポンス
- 導入:
- 6.0
status
指定された HTTP ステータスでビルダーを作成します。- パラメーター:
status- レスポンスステータス- 戻り値:
- 作成されたビルダー
status
指定された HTTP ステータスでビルダーを作成します。- パラメーター:
status- レスポンスステータス- 戻り値:
- 作成されたビルダー
ok
ステータスを 200 OK に設定してビルダーを作成します。- 戻り値:
- 作成されたビルダー
created
201 Created ステータスと特定の URI に設定されたロケーションヘッダーを使用してビルダーを作成します。- パラメーター:
location- ロケーション URI- 戻り値:
- 作成されたビルダー
accepted
202 Accepted ステータスのビルダーを作成します。- 戻り値:
- 作成されたビルダー
noContent
204 コンテンツなしステータスのビルダーを作成します。- 戻り値:
- 作成されたビルダー
seeOther
303 他を見るステータスと指定された URI に設定されたロケーションヘッダーを使用してビルダーを作成します。- パラメーター:
location- ロケーション URI- 戻り値:
- 作成されたビルダー
temporaryRedirect
307 一時的なリダイレクトステータスと指定された URI に設定されたロケーションヘッダーを使用してビルダーを作成します。- パラメーター:
location- ロケーション URI- 戻り値:
- 作成されたビルダー
permanentRedirect
308 永久リダイレクトステータスと指定された URI に設定されたロケーションヘッダーを使用してビルダーを作成します。- パラメーター:
location- ロケーション URI- 戻り値:
- 作成されたビルダー
badRequest
400 不正なリクエストステータスのビルダーを作成します。- 戻り値:
- 作成されたビルダー
notFound
404 お探しのページが見つかりませんでしたステータスのビルダーを作成します。- 戻り値:
- 作成されたビルダー
unprocessableEntity
422 処理できないエンティティステータスのビルダーを作成します。- 戻り値:
- 作成されたビルダー
async
指定された非同期レスポンスを使用して(構築された)レスポンスを作成します。パラメーターasyncResponseは、CompletableFuture<ServerResponse>SE またはPublisher<ServerResponse>(またはReactiveAdapterRegistryを介して適合させることができる単一のServerResponseの非同期プロデューサー)にすることができます。このメソッドを使用して、非同期の結果に基づいてレスポンスステータスコード、ヘッダー、本文を設定できます。本体のみが非同期の場合は、代わりに
ServerResponse.BodyBuilder.body(Object)を使用できます。- パラメーター:
asyncResponse-CompletableFuture<ServerResponse>またはPublisher<ServerResponse>- 戻り値:
- 非同期レスポンス
- 導入:
- 5.3
async
指定された非同期レスポンスを使用して(構築された)レスポンスを作成します。パラメーターasyncResponseは、CompletableFuture<ServerResponse>SE またはPublisher<ServerResponse>(またはReactiveAdapterRegistryを介して適合させることができる単一のServerResponseの非同期プロデューサー)にすることができます。このメソッドを使用して、非同期の結果に基づいてレスポンスステータスコード、ヘッダー、本文を設定できます。本体のみが非同期の場合は、代わりに
ServerResponse.BodyBuilder.body(Object)を使用できます。- パラメーター:
asyncResponse-CompletableFuture<ServerResponse>またはPublisher<ServerResponse>timeout- タイムアウトする前に待機する最大期間- 戻り値:
- 非同期レスポンス
- 導入:
- 5.3.2
sse
サーバー送信イベントレスポンスを作成します。consumerに提供されたServerResponse.SseBuilderは、イベントの作成と送信に使用できます。例:
public ServerResponse handleSse(ServerRequest request) { return ServerResponse.sse(sse -> sse.send("Hello World!")); }または、ID とイベント型の両方を設定するには:
public ServerResponse handleSse(ServerRequest request) { return ServerResponse.sse(sse -> sse .id("42) .event("event") .send("Hello World!")); }- パラメーター:
consumer- イベントビルダーが提供されるコンシューマー- 戻り値:
- サーバー側のイベントレスポンス
- 導入:
- 5.3.2
- 関連事項:
sse
サーバー送信イベントレスポンスを作成します。consumerに提供されたServerResponse.SseBuilderは、イベントの作成と送信に使用できます。例:
public ServerResponse handleSse(ServerRequest request) { return ServerResponse.sse(sse -> sse.send("Hello World!")); }または、ID とイベント型の両方を設定するには:
public ServerResponse handleSse(ServerRequest request) { return ServerResponse.sse(sse -> sse .id("42) .event("event") .send("Hello World!")); }- パラメーター:
consumer- イベントビルダーが提供されるコンシューマーtimeout- タイムアウトするまで待機する最大時間- 戻り値:
- サーバー側のイベントレスポンス
- 導入:
- 5.3.2
- 関連事項:
statusCode()を推奨し、7.0 から削除