インターフェース ServerResponse
- すべての既知のサブインターフェース:
AsyncServerResponse
、EntityResponse<T>
、RenderingResponse
public interface ServerResponse
- 導入:
- 5.2
- 作成者:
- Arjen Poutsma
ネストされたクラスのサマリー
修飾子と型インターフェース説明static interface
レスポンスに本文を追加するビルダーを定義します。static interface
writeTo(HttpServletRequest, HttpServletResponse, Context)
中に使用されるコンテキストを定義します。static interface
レスポンスにヘッダーを追加するビルダーを定義します。static interface
サーバー送信イベントを送信するボディのビルダーを定義します。static interface
ストリーミングレスポンス本文のビルダーを定義します。メソッドのサマリー
修飾子と型メソッド説明static ServerResponse.BodyBuilder
accepted()
202 Accepted ステータスのビルダーを作成します。static ServerResponse
指定された非同期レスポンスを使用して(構築された)レスポンスを作成します。static ServerResponse
async
(ObjectSE asyncResponse, DurationSE timeout) 指定された非同期レスポンスを使用して(構築された)レスポンスを作成します。static ServerResponse.BodyBuilder
400 不正なリクエストステータスのビルダーを作成します。cookies()
このレスポンスの Cookie を返します。static ServerResponse.BodyBuilder
201 Created ステータスと特定の URI に設定されたロケーションヘッダーを使用してビルダーを作成します。static ServerResponse
from
(ErrorResponse response) 指定されたErrorResponse
からServerResponse
を作成します。static ServerResponse.BodyBuilder
from
(ServerResponse other) 指定されたレスポンスのステータスコードとヘッダーを使用してビルダーを作成します。headers()
このレスポンスのヘッダーを返します。static ServerResponse.HeadersBuilder<?>
204 コンテンツなしステータスのビルダーを作成します。static ServerResponse.HeadersBuilder<?>
notFound()
404 お探しのページが見つかりませんでしたステータスのビルダーを作成します。static ServerResponse.BodyBuilder
ok()
ステータスを 200 OK に設定してビルダーを作成します。static ServerResponse.BodyBuilder
permanentRedirect
(URISE location) 308 永久リダイレクトステータスと指定された URI に設定されたロケーションヘッダーを使用してビルダーを作成します。int
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。static ServerResponse.BodyBuilder
303 他を見るステータスと指定された URI に設定されたロケーションヘッダーを使用してビルダーを作成します。static ServerResponse
sse
(ConsumerSE<ServerResponse.SseBuilder> consumer) サーバー送信イベントレスポンスを作成します。static ServerResponse
sse
(ConsumerSE<ServerResponse.SseBuilder> consumer, DurationSE timeout) サーバー送信イベントレスポンスを作成します。static ServerResponse.BodyBuilder
status
(int status) 指定された HTTP ステータスでビルダーを作成します。static ServerResponse.BodyBuilder
status
(HttpStatusCode status) 指定された HTTP ステータスでビルダーを作成します。このレスポンスのステータスコードを返します。static ServerResponse.BodyBuilder
temporaryRedirect
(URISE location) 307 一時的なリダイレクトステータスと指定された URI に設定されたロケーションヘッダーを使用してビルダーを作成します。static ServerResponse.BodyBuilder
422 処理できないエンティティステータスのビルダーを作成します。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
- 例外:
ServletExceptionEE
IOExceptionSE
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 から削除