インターフェース RouterFunctions.Builder
- 含まれているクラス:
- RouterFunctions
RouterFunctions.route()
経由で取得します。メソッドのサマリー
修飾子と型メソッド説明add
(RouterFunction<ServerResponse> routerFunction) 指定されたルートをこのビルダーに追加します。after
(BiFunctionSE<ServerRequest, ServerResponse, ServerResponse> responseProcessor) 指定されたレスポンス処理関数を使用して、このビルダーによって作成されたすべてのルートのレスポンスオブジェクトをフィルターに掛けます。before
(FunctionSE<ServerRequest, ServerRequest> requestProcessor) 指定されたリクエスト処理関数を使用して、このビルダーによって作成されたすべてのルートのリクエストオブジェクトをフィルタリングします。build()
RouterFunction
をビルドします。DELETE
(StringSE pattern, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンに一致するすべての HTTPDELETE
リクエストを処理する指定されたハンドラー関数にルートを追加します。DELETE
(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPDELETE
リクエストを処理する指定されたハンドラー関数にルートを追加します。DELETE
(HandlerFunction<ServerResponse> handlerFunction) HTTPDELETE
リクエストを処理する指定されたハンドラー関数にルートを追加します。DELETE
(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPDELETE
リクエストを処理する指定されたハンドラー関数にルートを追加します。filter
(HandlerFilterFunction<ServerResponse, ServerResponse> filterFunction) このビルダーによって作成されたすべてのルートを、指定されたフィルター関数でフィルターします。GET
(StringSE pattern, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンに一致するすべての HTTPGET
リクエストを処理する指定されたハンドラー関数にルートを追加します。GET
(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPGET
リクエストを処理する指定されたハンドラー関数にルートを追加します。GET
(HandlerFunction<ServerResponse> handlerFunction) HTTPGET
リクエストを処理する指定されたハンドラー関数にルートを追加します。GET
(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPGET
リクエストを処理する指定されたハンドラー関数にルートを追加します。HEAD
(StringSE pattern, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンに一致するすべての HTTPHEAD
リクエストを処理する指定されたハンドラー関数にルートを追加します。HEAD
(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPHEAD
リクエストを処理する指定されたハンドラー関数にルートを追加します。HEAD
(HandlerFunction<ServerResponse> handlerFunction) HTTPHEAD
リクエストを処理する指定されたハンドラー関数にルートを追加します。HEAD
(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPHEAD
リクエストを処理する指定されたハンドラー関数にルートを追加します。nest
(RequestPredicate predicate, ConsumerSE<RouterFunctions.Builder> builderConsumer) 指定されたリクエスト述語が適用される場合、構築されたルーター関数にルーティングします。nest
(RequestPredicate predicate, SupplierSE<RouterFunction<ServerResponse>> routerFunctionSupplier) 指定されたリクエスト述語が適用される場合、提供されたルーター関数にルーティングします。onError
(ClassSE<? extends ThrowableSE> exceptionType, BiFunctionSE<ThrowableSE, ServerRequest, ServerResponse> responseProvider) 指定されたレスポンスプロバイダー関数を適用することにより、指定された型のすべての例外をフィルターに掛けます。onError
(PredicateSE<ThrowableSE> predicate, BiFunctionSE<ThrowableSE, ServerRequest, ServerResponse> responseProvider) 指定されたレスポンスプロバイダー関数を適用することにより、述語に一致するすべての例外をフィルターに掛けます。OPTIONS
(StringSE pattern, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンに一致するすべての HTTPOPTIONS
リクエストを処理する指定されたハンドラー関数にルートを追加します。OPTIONS
(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPOPTIONS
リクエストを処理する指定されたハンドラー関数にルートを追加します。OPTIONS
(HandlerFunction<ServerResponse> handlerFunction) HTTPOPTIONS
リクエストを処理する指定されたハンドラー関数にルートを追加します。OPTIONS
(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPOPTIONS
リクエストを処理する指定されたハンドラー関数にルートを追加します。PATCH
(StringSE pattern, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンに一致するすべての HTTPPATCH
リクエストを処理する指定されたハンドラー関数にルートを追加します。PATCH
(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPPATCH
リクエストを処理する指定されたハンドラー関数にルートを追加します。PATCH
(HandlerFunction<ServerResponse> handlerFunction) HTTPPATCH
リクエストを処理する指定されたハンドラー関数にルートを追加します。PATCH
(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPPATCH
リクエストを処理する指定されたハンドラー関数にルートを追加します。path
(StringSE pattern, ConsumerSE<RouterFunctions.Builder> builderConsumer) 指定されたパスプレフィックスパターンが適用される場合、構築されたルーター関数にルーティングします。path
(StringSE pattern, SupplierSE<RouterFunction<ServerResponse>> routerFunctionSupplier) 指定されたパスプレフィックスパターンが適用される場合は、提供されたルーター関数にルーティングします。POST
(StringSE pattern, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンに一致するすべての HTTPPOST
リクエストを処理する指定されたハンドラー関数にルートを追加します。POST
(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPPOST
リクエストを処理する指定されたハンドラー関数にルートを追加します。POST
(HandlerFunction<ServerResponse> handlerFunction) HTTPPOST
リクエストを処理する指定されたハンドラー関数にルートを追加します。POST
(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPPOST
リクエストを処理する指定されたハンドラー関数にルートを追加します。PUT
(StringSE pattern, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンに一致するすべての HTTPPUT
リクエストを処理する指定されたハンドラー関数にルートを追加します。PUT
(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPPUT
リクエストを処理する指定されたハンドラー関数にルートを追加します。PUT
(HandlerFunction<ServerResponse> handlerFunction) HTTPPUT
リクエストを処理する指定されたハンドラー関数にルートを追加します。PUT
(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPPUT
リクエストを処理する指定されたハンドラー関数にルートを追加します。resource
(RequestPredicate predicate, Resource resource) 指定された述語に一致するリクエストを指定されたリソースにルーティングします。resource
(RequestPredicate predicate, Resource resource, BiConsumerSE<Resource, HttpHeaders> headersConsumer) 指定された述語に一致するリクエストを指定されたリソースにルーティングします。指定されたパターンに一致するリクエストを、指定されたルートの場所を基準としたリソースにルーティングします。resources
(StringSE pattern, Resource location, BiConsumerSE<Resource, HttpHeaders> headersConsumer) 指定されたパターンに一致するリクエストを、指定されたルートの場所を基準としたリソースにルーティングします。resources
(FunctionSE<ServerRequest, OptionalSE<Resource>> lookupFunction) 提供された検索機能を使用してリソースにルーティングします。resources
(FunctionSE<ServerRequest, OptionalSE<Resource>> lookupFunction, BiConsumerSE<Resource, HttpHeaders> headersConsumer) 提供された検索機能を使用してリソースにルーティングします。route
(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべてのリクエストを処理する指定されたハンドラー関数にルートを追加します。withAttribute
(StringSE name, ObjectSE value) このビルダーで作成された最後のルートに、指定された名前と値の属性を追加します。withAttributes
(ConsumerSE<MapSE<StringSE, ObjectSE>> attributesConsumer) 特定のコンシューマーで構築された最後のルートの属性を操作します。
メソッドの詳細
GET
HTTPGET
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
handlerFunction
- すべてのGET
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
GET
指定されたパターンに一致するすべての HTTPGET
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
pattern
- 照合するパターンhandlerFunction
-pattern
に一致するすべてのGET
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
GET
RouterFunctions.Builder GET(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPGET
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
predicate
- 一致する述語handlerFunction
-predicate
に一致するすべてのGET
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
- 関連事項:
GET
RouterFunctions.Builder GET(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPGET
リクエストを処理する指定されたハンドラー関数にルートを追加します。たとえば、次の例では、JSON を受け入れる "/user" の GET リクエストを
userController
のlistUsers
メソッドにルーティングします。RouterFunction<ServerResponse> route = RouterFunctions.route() .GET("/user", RequestPredicates.accept(MediaType.APPLICATION_JSON), userController::listUsers) .build();
- パラメーター:
pattern
- 照合するパターンpredicate
- 一致する追加の述語handlerFunction
-pattern
および述語に一致するすべてのGET
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
HEAD
HTTPHEAD
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
handlerFunction
- すべてのHEAD
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
HEAD
指定されたパターンに一致するすべての HTTPHEAD
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
pattern
- 照合するパターンhandlerFunction
-pattern
に一致するすべてのHEAD
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
HEAD
RouterFunctions.Builder HEAD(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPHEAD
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
predicate
- 一致する述語handlerFunction
-predicate
に一致するすべてのHEAD
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
- 関連事項:
HEAD
RouterFunctions.Builder HEAD(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPHEAD
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
pattern
- 照合するパターンpredicate
- 一致する追加の述語handlerFunction
-pattern
に一致するすべてのHEAD
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
POST
HTTPPOST
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
handlerFunction
- すべてのPOST
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
POST
指定されたパターンに一致するすべての HTTPPOST
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
pattern
- 照合するパターンhandlerFunction
-pattern
に一致するすべてのPOST
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
POST
RouterFunctions.Builder POST(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPPOST
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
predicate
- 一致する述語handlerFunction
-predicate
に一致するすべてのPOST
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
- 関連事項:
POST
RouterFunctions.Builder POST(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPPOST
リクエストを処理する指定されたハンドラー関数にルートを追加します。たとえば、次の例では、JSON を含む "/user" の POST リクエストを
userController
のaddUser
メソッドにルーティングします。RouterFunction<ServerResponse> route = RouterFunctions.route() .POST("/user", RequestPredicates.contentType(MediaType.APPLICATION_JSON), userController::addUser) .build();
- パラメーター:
pattern
- 照合するパターンpredicate
- 一致する追加の述語handlerFunction
-pattern
に一致するすべてのPOST
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
PUT
HTTPPUT
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
handlerFunction
- すべてのPUT
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
PUT
指定されたパターンに一致するすべての HTTPPUT
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
pattern
- 照合するパターンhandlerFunction
-pattern
に一致するすべてのPUT
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
PUT
RouterFunctions.Builder PUT(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPPUT
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
predicate
- 一致する述語handlerFunction
-predicate
に一致するすべてのPUT
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
- 関連事項:
PUT
RouterFunctions.Builder PUT(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPPUT
リクエストを処理する指定されたハンドラー関数にルートを追加します。たとえば、次の例では、JSON を含む "/user" の PUT リクエストを
userController
のeditUser
メソッドにルーティングします。RouterFunction<ServerResponse> route = RouterFunctions.route() .PUT("/user", RequestPredicates.contentType(MediaType.APPLICATION_JSON), userController::editUser) .build();
- パラメーター:
pattern
- 照合するパターンpredicate
- 一致する追加の述語handlerFunction
-pattern
に一致するすべてのPUT
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
PATCH
HTTPPATCH
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
handlerFunction
- すべてのPATCH
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
PATCH
指定されたパターンに一致するすべての HTTPPATCH
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
pattern
- 照合するパターンhandlerFunction
-pattern
に一致するすべてのPATCH
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
PATCH
RouterFunctions.Builder PATCH(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPPATCH
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
predicate
- 一致する述語handlerFunction
-predicate
に一致するすべてのPATCH
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
- 関連事項:
PATCH
RouterFunctions.Builder PATCH(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPPATCH
リクエストを処理する指定されたハンドラー関数にルートを追加します。たとえば、次の例では、JSON を含む "/user" の PATCH リクエストを
userController
のeditUser
メソッドにルーティングします。RouterFunction<ServerResponse> route = RouterFunctions.route() .PATCH("/user", RequestPredicates.contentType(MediaType.APPLICATION_JSON), userController::editUser) .build();
- パラメーター:
pattern
- 照合するパターンpredicate
- 一致する追加の述語handlerFunction
-pattern
に一致するすべてのPATCH
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
DELETE
HTTPDELETE
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
handlerFunction
- すべてのDELETE
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
DELETE
指定されたパターンに一致するすべての HTTPDELETE
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
pattern
- 照合するパターンhandlerFunction
-pattern
に一致するすべてのDELETE
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
DELETE
RouterFunctions.Builder DELETE(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPDELETE
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
predicate
- 一致する述語handlerFunction
-predicate
に一致するすべてのDELETE
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
- 関連事項:
DELETE
RouterFunctions.Builder DELETE(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPDELETE
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
pattern
- 照合するパターンpredicate
- 一致する追加の述語handlerFunction
-pattern
に一致するすべてのDELETE
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
OPTIONS
HTTPOPTIONS
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
handlerFunction
- すべてのOPTIONS
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
OPTIONS
指定されたパターンに一致するすべての HTTPOPTIONS
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
pattern
- 照合するパターンhandlerFunction
-pattern
に一致するすべてのOPTIONS
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
OPTIONS
RouterFunctions.Builder OPTIONS(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべての HTTPOPTIONS
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
predicate
- 一致する述語handlerFunction
-predicate
に一致するすべてのOPTIONS
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 導入:
- 5.3
- 関連事項:
OPTIONS
RouterFunctions.Builder OPTIONS(StringSE pattern, RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定されたパターンと述語に一致するすべての HTTPOPTIONS
リクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
pattern
- 照合するパターンpredicate
- 一致する追加の述語handlerFunction
-pattern
に一致するすべてのOPTIONS
リクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
route
RouterFunctions.Builder route(RequestPredicate predicate, HandlerFunction<ServerResponse> handlerFunction) 指定された述語に一致するすべてのリクエストを処理する指定されたハンドラー関数にルートを追加します。- パラメーター:
predicate
- 一致するリクエスト述語handlerFunction
- 述語に一致するすべてのリクエストを処理するハンドラー関数- 戻り値:
- このビルダー
- 関連事項:
add
指定されたルートをこのビルダーに追加します。外部で定義されたルーター関数をこのビルダーにマージするために使用できます。または、RouterFunctions.route(RequestPredicate, HandlerFunction)
と組み合わせて、より柔軟な述語マッチングを可能にすることができます。たとえば、次の例では、
OrderController.routerFunction()
から返されたルーター関数を追加しています。userController
のchangeUser
メソッドに:RouterFunction<ServerResponse> route = RouterFunctions.route() .GET("/users", userController::listUsers) .add(orderController.routerFunction()); .build();
- パラメーター:
routerFunction
- 追加するルーター関数- 戻り値:
- このビルダー
- 関連事項:
resource
指定された述語に一致するリクエストを指定されたリソースにルーティングします。たとえばResource resource = new ClassPathResource("static/index.html") RouterFunction<ServerResponse> resources = RouterFunctions.resource(path("/api/**").negate(), resource);
- パラメーター:
predicate
- 一致する述語resource
- 提供するリソース- 戻り値:
- リソースにルーティングするルーター関数
- 導入:
- 6.1.4
resource
RouterFunctions.Builder resource(RequestPredicate predicate, Resource resource, BiConsumerSE<Resource, HttpHeaders> headersConsumer) 指定された述語に一致するリクエストを指定されたリソースにルーティングします。たとえばResource resource = new ClassPathResource("static/index.html") RouterFunction<ServerResponse> resources = RouterFunctions.resource(path("/api/**").negate(), resource);
- パラメーター:
predicate
- 一致する述語resource
- 提供するリソースheadersConsumer
- 提供されるリソースの HTTP ヘッダーへのアクセスを提供します- 戻り値:
- リソースにルーティングするルーター関数
- 導入:
- 6.1.4
resources
指定されたパターンに一致するリクエストを、指定されたルートの場所を基準にしたリソースにルーティングします。たとえばResource location = new FileUrlResource("public-resources/"); RouterFunction<ServerResponse> resources = RouterFunctions.resources("/resources/**", location);
- パラメーター:
pattern
- マッチングするパターンlocation
- リソースを解決する必要のある場所のディレクトリ- 戻り値:
- このビルダー
- 関連事項:
resources
RouterFunctions.Builder resources(StringSE pattern, Resource location, BiConsumerSE<Resource, HttpHeaders> headersConsumer) 指定されたパターンに一致するリクエストを、指定されたルートの場所を基準にしたリソースにルーティングします。たとえばResource location = new FileUrlResource("public-resources/"); RouterFunction<ServerResponse> resources = RouterFunctions.resources("/resources/**", location);
- パラメーター:
pattern
- マッチングするパターンlocation
- リソースを解決する必要のある場所のディレクトリheadersConsumer
- 提供されるリソースの HTTP ヘッダーへのアクセスを提供します- 戻り値:
- このビルダー
- 導入:
- 6.1
- 関連事項:
resources
提供された検索機能を使用してリソースにルーティングします。ルックアップ関数が指定されたリクエストにResource
を提供する場合、GET、HEAD、OPTIONS リクエストを処理するHandlerFunction
を使用して公開されます。- パラメーター:
lookupFunction
-ServerRequest
を指定してResource
を提供する関数- 戻り値:
- このビルダー
resources
RouterFunctions.Builder resources(FunctionSE<ServerRequest, OptionalSE<Resource>> lookupFunction, BiConsumerSE<Resource, HttpHeaders> headersConsumer) 提供された検索機能を使用してリソースにルーティングします。ルックアップ関数が指定されたリクエストにResource
を提供する場合、GET、HEAD、OPTIONS リクエストを処理するHandlerFunction
を使用して公開されます。- パラメーター:
lookupFunction
-ServerRequest
を指定してResource
を提供する関数headersConsumer
- 提供されるリソースの HTTP ヘッダーへのアクセスを提供します- 戻り値:
- このビルダー
- 導入:
- 6.1
nest
RouterFunctions.Builder nest(RequestPredicate predicate, SupplierSE<RouterFunction<ServerResponse>> routerFunctionSupplier) 指定されたリクエスト述語が適用される場合、提供されたルーター関数にルーティングします。このメソッドを使用して、ネストされたルートを作成できます。ルートのグループは、共通のパス(プレフィックス)、ヘッダー、その他のリクエスト述語を共有します。たとえば、次の例では、"/user" パス述語を使用してネストされたルートを作成します。これにより、"/user" の GET リクエストはユーザーを一覧表示し、"/user" の POST リクエストは新しいユーザーを作成します。
RouterFunction<ServerResponse> nestedRoute = RouterFunctions.route() .nest(RequestPredicates.path("/user"), () -> RouterFunctions.route() .GET(this::listUsers) .POST(this::createUser) .build()) .build();
- パラメーター:
predicate
- テストする述語routerFunctionSupplier
- 述語が適用される場合に委譲するネストされたルーター関数のサプライヤー- 戻り値:
- このビルダー
- 関連事項:
nest
RouterFunctions.Builder nest(RequestPredicate predicate, ConsumerSE<RouterFunctions.Builder> builderConsumer) 指定されたリクエスト述語が適用される場合、構築されたルーター関数にルーティングします。このメソッドを使用して、ネストされたルートを作成できます。ルートのグループは、共通のパス(プレフィックス)、ヘッダー、その他のリクエスト述語を共有します。たとえば、次の例では、"/user" パス述語を使用してネストされたルートを作成します。これにより、"/user" の GET リクエストはユーザーを一覧表示し、"/user" の POST リクエストは新しいユーザーを作成します。
RouterFunction<ServerResponse> nestedRoute = RouterFunctions.route() .nest(RequestPredicates.path("/user"), builder -> builder.GET(this::listUsers) .POST(this::createUser)) .build();
- パラメーター:
predicate
- テストする述語builderConsumer
- ネストされたルーター関数を提供するBuilder
のコンシューマー- 戻り値:
- このビルダー
- 関連事項:
path
RouterFunctions.Builder path(StringSE pattern, SupplierSE<RouterFunction<ServerResponse>> routerFunctionSupplier) 指定されたパスプレフィックスパターンが適用される場合は、提供されたルーター関数にルーティングします。このメソッドを使用すると、ルートのグループが共通のパスプレフィックスを共有するネストされたルートを作成できます。具体的には、このメソッドを使用して、外部で定義されたルーター関数をパス接頭辞にマージできます。たとえば、次の例では、
userController
で定義されたルーター関数に委譲する "/user" パス述語と、orderController
に委譲する "/order" パスを使用してネストされたルートを作成します。RouterFunction<ServerResponse> nestedRoute = RouterFunctions.route() .path("/user", userController::routerFunction) .path("/order", orderController::routerFunction) .build();
- パラメーター:
pattern
- 照合するパターンrouterFunctionSupplier
- パターンが一致する場合に委譲するネストされたルーター関数のサプライヤー- 戻り値:
- このビルダー
- 関連事項:
path
指定されたパスプレフィックスパターンが適用される場合、構築されたルーター関数にルーティングします。このメソッドを使用すると、ルートのグループが共通のパスプレフィックスを共有するネストされたルートを作成できます。たとえば、次の例では、"/user" パス述語を使用してネストされたルートを作成します。これにより、"/user" の GET リクエストはユーザーを一覧表示し、"/user" の POST リクエストは新しいユーザーを作成します。
RouterFunction<ServerResponse> nestedRoute = RouterFunctions.route() .path("/user", builder -> builder.GET(this::listUsers) .POST(this::createUser)) .build();
- パラメーター:
pattern
- 照合するパターンbuilderConsumer
- ネストされたルーター関数を提供するBuilder
のコンシューマー- 戻り値:
- このビルダー
- 関連事項:
filter
このビルダーによって作成されたすべてのルートを、指定されたフィルター関数でフィルターします。フィルター機能は通常、ロギング、セキュリティなどの横断的問題に対処するために使用されます。たとえば、次の例では、リクエストに必要な認証ヘッダーが含まれていない場合に 401 Unauthorized レスポンスを返すフィルターを作成します。
RouterFunction<ServerResponse> filteredRoute = RouterFunctions.route() .GET("/user", this::listUsers) .filter((request, next) -> { // check for authentication headers if (isAuthenticated(request)) { return next.handle(request); } else { return ServerResponse.status(HttpStatus.UNAUTHORIZED).build(); } }) .build();
- パラメーター:
filterFunction
- このビルダーによって作成されたすべてのルートをフィルタリングする関数- 戻り値:
- このビルダー
before
指定されたリクエスト処理関数を使用して、このビルダーによって作成されたすべてのルートのリクエストオブジェクトをフィルタリングします。フィルターは通常、ロギング、セキュリティなどの横断的問題に対処するために使用されます。たとえば、次の例では、ハンドラー関数が実行される前にリクエストをログに記録するフィルターを作成します。
RouterFunction<ServerResponse> filteredRoute = RouterFunctions.route() .GET("/user", this::listUsers) .before(request -> { log(request); return request; }) .build();
- パラメーター:
requestProcessor
- リクエストを変換する関数- 戻り値:
- このビルダー
after
RouterFunctions.Builder after(BiFunctionSE<ServerRequest, ServerResponse, ServerResponse> responseProcessor) 指定されたレスポンス処理関数を使用して、このビルダーによって作成されたすべてのルートのレスポンスオブジェクトをフィルターに掛けます。フィルターは通常、ロギング、セキュリティなどの横断的問題に対処するために使用されます。たとえば、次の例では、ハンドラー関数の実行後にレスポンスを記録するフィルターを作成します。
RouterFunction<ServerResponse> filteredRoute = RouterFunctions.route() .GET("/user", this::listUsers) .after((request, response) -> { log(response); return response; }) .build();
- パラメーター:
responseProcessor
- レスポンスを変換する関数- 戻り値:
- このビルダー
onError
RouterFunctions.Builder onError(PredicateSE<ThrowableSE> predicate, BiFunctionSE<ThrowableSE, ServerRequest, ServerResponse> responseProvider) 指定されたレスポンスプロバイダー関数を適用することにより、述語に一致するすべての例外をフィルターに掛けます。たとえば、次の例では、
IllegalStateException
が発生したときに 500 レスポンスステータスを返すフィルターを作成します。RouterFunction<ServerResponse> filteredRoute = RouterFunctions.route() .GET("/user", this::listUsers) .onError(e -> e instanceof IllegalStateException, (e, request) -> ServerResponse.status(HttpStatus.INTERNAL_SERVER_ERROR).build()) .build();
- パラメーター:
predicate
- フィルタリングする例外の型responseProvider
- レスポンスを作成する関数- 戻り値:
- このビルダー
onError
RouterFunctions.Builder onError(ClassSE<? extends ThrowableSE> exceptionType, BiFunctionSE<ThrowableSE, ServerRequest, ServerResponse> responseProvider) 指定されたレスポンスプロバイダー関数を適用することにより、指定された型のすべての例外をフィルターに掛けます。たとえば、次の例では、
IllegalStateException
が発生したときに 500 レスポンスステータスを返すフィルターを作成します。RouterFunction<ServerResponse> filteredRoute = RouterFunctions.route() .GET("/user", this::listUsers) .onError(IllegalStateException.class, (e, request) -> ServerResponse.status(HttpStatus.INTERNAL_SERVER_ERROR).build()) .build();
- パラメーター:
exceptionType
- フィルタリングする例外の型responseProvider
- レスポンスを作成する関数- 戻り値:
- このビルダー
withAttribute
このビルダーで作成された最後のルートに、指定された名前と値の属性を追加します。- パラメーター:
name
- 属性名value
- 属性値- 戻り値:
- このビルダー
- 導入:
- 5.3
withAttributes
特定のコンシューマーで構築された最後のルートの属性を操作します。コンシューマーに提供されるマップは「ライブ」であるため、コンシューマーを使用して、既存の属性を上書きしSEたり、属性を削除しSEたり、その他の
Map
SE メソッドを使用したりできます。- パラメーター:
attributesConsumer
- 属性マップを使用する関数- 戻り値:
- このビルダー
- 導入:
- 5.3
build
RouterFunction<ServerResponse> build()RouterFunction
をビルドします。作成されたすべてのルートは互いに構成され、フィルター(存在する場合)が結果に適用されます。- 戻り値:
- 内蔵ルーター関数