インターフェース 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たり、その他の
MapSE メソッドを使用したりできます。- パラメーター:
attributesConsumer- 属性マップを使用する関数- 戻り値:
- このビルダー
- 導入:
- 5.3
build
RouterFunction<ServerResponse> build()RouterFunctionをビルドします。作成されたすべてのルートは互いに構成され、フィルター(存在する場合)が結果に適用されます。- 戻り値:
- 内蔵ルーター関数