
# マッピング

`/actuator/mappings` は、アプリケーションが応答するすべてのアドレスを列挙します。パス、メソッド、メディアタイプを持つ各コントローラーメソッド、静的リソース、そしてナビゲーションスターターを使うアプリではその画面です。Spring Boot の `mappings` エンドポイントに当たります。

## 使う理由

「`/api/books/123` に応答するのはどのエンドポイントか?」は、ルーティング、プロキシ、セキュリティのルールをデバッグするときによくある問いです。mappings エンドポイントは、ディスパッチャーから見たとおりに、動作中のアプリケーションからそれに答えます。

## 例

```properties
# lib/resources/application.properties
management.endpoints.web.exposure.include=health,mappings
```

```console
$ curl localhost:8080/actuator/mappings
```

```json
{"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` を追加してください。すべてのアドレスを示すため、保護してください ([セキュリティ](security.md) を参照)。

## Spring (Java) との対応

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

## 関連項目

- [エンドポイント](endpoints.md)
- [セキュリティ](security.md)
- [spring_boot_starter_web](../spring-boot-starter-web/index.md)
