
# ビルドに含まれるもの

`spring_boot_starter_data` を使うアプリケーションのビルドに何が含まれ、どんなときに何が含まれないか。キーで決まるモジュールは、`build_runner` の実行時に、プロファイルなしの `application.yml` または `application.properties` からそのキーを読みます ([ビルドから外されるモジュール](../spring-core-dart-generator/optimizations/build-conditions.md) を参照)。依存するパッケージのモジュールは一緒に入ります。`spring_boot_dart` については [自動構成](../spring-boot-dart/auto-configuration.md) を参照してください。

## 常に含まれるもの

`build:` も `platform:` もありません。スターターに依存するアプリケーションのすべてのビルドに含まれます。

| モジュール | 含むもの |
|---|---|
| `springBootStarterDataAutoConfiguration` | SQL のデータソース、トランザクションマネージャー、テンプレート、マッピングコンテキスト、エンティティコンバーター、ストア (メモリ上のストアを含む)、監査ハンドラー、リポジトリを作るファクトリー。 |

## キーで決まるもの

`build: AutoConfigurationBuild(key)`: `true` はモジュールをすべてのビルドに含め、`false` はコードごと外し、キーが未設定のときは「未設定」の列が決めます。

| モジュール | キー | 未設定 | 含むもの |
|---|---|---|---|
| `springBootStarterDataStartupChecksAutoConfiguration` | `spring.main.startup-checks.enabled` | デバッグとプロファイルのビルドだけ | `transactionValidator` (async ではない、または存在しないトランザクションマネージャーを指す `@Transactional` メソッドで起動を止めます) と `dataFailureAnalyzer` (起動に失敗するデータベースを説明します)。これらがないと、誤った `@Transactional` メソッドは最初の呼び出しで失敗します。 |
| `springBootStarterDataSqlLoggingAutoConfiguration` | `spring.data.jdbc.show-sql` | デバッグとプロファイルのビルドだけ | `show-sql`、`format-sql`、`show-parameters` の `jdbcLogSettings`。プロファイルなしの設定の `true` はすべてのビルドに含め、`dev` などのプロファイルは、アプリケーションの実行時にそれを有効にできます。遅いクエリのログ (`jdbcSlowQueryLogSettings`) はメインのモジュールに残るので、遅い文はすべてのビルドで warn で記録されます。 |

`notInRelease` に任せたモジュールは、Flutter のリリースビルドと `dart compile exe` では外されます。`dart run` と `dart compile js` / `wasm` は `dart.vm.product` を定義しないので、そこではキーが未設定ならモジュールは残り、`false` だけがモジュールを外します。

## ジェネレーターがこのスターターのために書くもの

ジェネレーターのパート ([スターターのパート](../spring-core-dart-generator/how-it-works.md#スターターのパート) を参照) は、アプリケーションがそのパッケージに届くときだけ動きます。

| パートまたはビルダー | 行うこと |
|---|---|
| データのメタデータパート (`spring_boot_starter_data`) | `spring_metadata.json` の `entities` (テーブル、カラム、リレーションを持つ `@Table` クラス) と `repositories`。 |
| データパート (`spring_boot_starter_data`) | データ層のために各 `@Table` クラスを記述します。各リポジトリのクラスとその Bean、`EntityIntrospections` Bean、アプリケーションが列挙したドライバー (`sqlite3`、`postgres`) のグルーを書きます。導出クエリ、エンティティとスキーマに対する `@Query` のテキスト、デフォルトのストアに対する `@Transactional` を確認し、誤りはビルドを失敗させます。 |
| Web グルー (データパート) | アプリケーションが Web スターターにも届くとき: `dataAccessExceptionResolver` (データのエラーを HTTP ステータスで答えます) と `pagingArgumentResolvers` (`Pageable` と `Sort` のパラメーター)。 |
| 依存関係を通して | スターターが `spring_boot_actuator` と `spring_web_dart` に依存するため、Actuator パートと Web パート。 |

## 知っておくこと

- スキーマのステップ (`create`、`validate`) とメモリ上のストアは、まだ切り替えられません。すべてのビルドに含まれます。

## 関連項目

- [ビルドから外されるモジュール](../spring-core-dart-generator/optimizations/build-conditions.md)
- [生成の仕組み: スターターのパート](../spring-core-dart-generator/how-it-works.md#スターターのパート)
- [ビルダー](../spring-core-dart-generator/builders.md)
- [SQL のロギング](logging.md)
- [スキーマとマイグレーション](schema.md)
- [エラー](errors.md)
