マッピング
/actuator/mappings は、アプリケーションが応答するすべてのアドレスを列挙します。パス、メソッド、メディアタイプを持つ各コントローラーメソッド、静的リソース、そしてナビゲーションスターターを使うアプリではその画面です。Spring Boot の mappings エンドポイントに当たります。
使う理由
「/api/books/123 に応答するのはどのエンドポイントか?」は、ルーティング、プロキシ、セキュリティのルールをデバッグするときによくある問いです。mappings エンドポイントは、ディスパッチャーから見たとおりに、動作中のアプリケーションからそれに答えます。
例
# lib/resources/application.properties
management.endpoints.web.exposure.include=health,mappings
$ curl localhost:8080/actuator/mappings
{"contexts": {"shop": {"mappings": {
"dispatcherHandlers": {"webHandler": [
{"predicate": "{GET [/api/books/{isbn}], produces [application/json]}",
"handler": "BookController#find(String)",
"details": {"handlerMethod": {"className": "BookController", "name": "find",
"descriptor": "(String isbn) -> Future<Book>"},
"requestMappingConditions": {"consumes": [], "headers": [], "methods": ["GET"],
"params": [], "patterns": ["/api/books/{isbn}"],
"produces": [{"mediaType": "application/json", "negated": false}]}}},
{"predicate": "/**", "handler": "ResourceWebHandler [resources:static/, resources:public/]"}]}},
"parentId": null}}}
列挙されるもの
- すべての
MappingDescriptionsの Bean は、mappingsの下にそのキーを追加します。Web スターターのdispatcherHandlers、ナビゲーションスターターのscreensです。 - コンテキストは
spring.application.name(デフォルトはapplication) にちなんで名付けられます。parentIdはnullです。 - メソッドの
descriptorはその Dart のシグネチャ、classNameは Dart のクラス名です。
このエンドポイントはデフォルトで有効ですが、公開されていません。management.endpoints.web.exposure.include に mappings を追加してください。すべてのアドレスを示すため、保護してください (セキュリティ を参照)。
Spring (Java) との対応
同じエンドポイントで、Spring WebFlux の形をとります (Web スターターはサーブレットコンテナではないため、dispatcherServlets ではなく常に dispatcherHandlers)。screens はこのプロジェクト独自のものです。