ビルドに含まれるもの
spring_boot_starter_data を使うアプリケーションのビルドに何が含まれ、どんなときに何が含まれないか。キーで決まるモジュールは、build_runner の実行時に、プロファイルなしの application.yml または application.properties からそのキーを読みます (ビルドから外されるモジュール を参照)。依存するパッケージのモジュールは一緒に入ります。spring_boot_dart については 自動構成 を参照してください。
常に含まれるもの
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_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) とメモリ上のストアは、まだ切り替えられません。すべてのビルドに含まれます。