マッピング

/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}}}

列挙されるもの

このエンドポイントはデフォルトで有効ですが、公開されていません。management.endpoints.web.exposure.include に mappings を追加してください。すべてのアドレスを示すため、保護してください (セキュリティ を参照)。

Spring (Java) との対応

同じエンドポイントで、Spring WebFlux の形をとります (Web スターターはサーブレットコンテナではないため、dispatcherServlets ではなく常に dispatcherHandlers)。screens はこのプロジェクト独自のものです。

関連項目