Spring との違い
spring_boot_starter_data は Spring Data JDBC と Spring Boot に従っています。アノテーション、インターフェース、クエリの文法、トランザクションのルール、そして意味のある範囲でプロパティの名前も同じです。このページでは、そうでない箇所をすべて、その理由とともに列挙します。
使う理由
Spring のアプリケーションを移植するとき、あるいは Spring Data のチュートリアルに従うとき、動作が期待どおりでない箇所を知る必要があります。違いのほとんどは、次の 3 つの事実から来ています。
- Dart は Java ではありません。 実行時のリフレクションも、オーバーロードも、チェック例外も、スレッドもありません。ビルドがリポジトリを書き、メソッドは別々の名前を持ち、すべての例外がロールバックし、トランザクションは
Zoneを通してawaitに従います。 - すべてが非同期です。 Dart は Isolate ごとに一つのスレッドを持つため、ブロックする API はありません。
- ビルドがより多くを知っています。 派生クエリの名前、
@Queryのテキスト、SpEL 式は、起動時ではなくビルドがチェックします。
例
abstract interface class BookRepository implements ListCrudRepository<Book, int> {
Future<List<Book>> findByTitleContaining(String part);
Future<Book?> findFirstByOrderByYearAsc();
}
interface BookRepository extends ListCrudRepository<Book, Long> {
List<Book> findByTitleContaining(String part);
Optional<Book> findFirstByOrderByYearAsc();
}
リポジトリ
| Spring Data | ここでは | 理由 |
|---|---|---|
Repository |
DataRepository |
@Repository はステレオタイプのアノテーション。 |
@NoRepositoryBean |
不要 | ジェネリックなインターフェースは決して Bean にならない。 |
@EnableJdbcRepositories |
不要 | スキャンされたコードのすべてのリポジトリのインターフェースが Bean になる。 |
同期的な結果、Optional |
Future または Stream、nullable な値 |
Dart は非同期。null 安全性が Optional の代わりになる。 |
findAll(Sort)、findAll(Pageable) |
findAllSorted(Sort)、findAllPaged(Pageable) |
オーバーロードがない。 |
deleteAll(Iterable) |
deleteAllOf(Iterable) |
オーバーロードがない。 |
Sort.Order |
SortOrder |
@Order は Bean を並べる。 |
| 起動時にチェックされるクエリの名前 | ビルドがチェックする | ジェネレーターがそれらを解析する。 |
パッケージごとのデータベース (jdbcOperationsRef) |
リポジトリごとの @UseDataSource('name') |
プロパティでより単純に。 |
| モジュールごとに一つのストア | @UseStore('memory')、@UseStore('jdbc') |
一つのスターター、複数のストア。 |
| モジュールにない機能は、そこには存在しない | ストアが機能を宣言する。それ以上を必要とするリポジトリは起動時に失敗する | 同じリポジトリのインターフェースが複数のストアで動く。 |
@Procedure(procedureName = "name") (Spring Data JPA のみ) |
@Procedure('name') |
名前で呼び出すデータベース関数。 |
| Spring Data JDBC に変更ストリームはない | 変更を報告するストアでの RowChange のストリーム |
@Query
- パラメーターは
@Paramなしで名前で照合されます。 {Entity}と{Entity.property}のプレースホルダーは追加されたものです。rowMapperClassとresultSetExtractorClassは、関数として与えるrowMapperとresultSetExtractorです。- テキスト、パラメーター、綴りを間違えたテーブルと列、SpEL 式はビルドがチェックします。SpEL は可能な場合は Dart にコンパイルされます。
name:(名前付きクエリ) にはまだ対応していません。@Queryには SQL のストアが必要です。メモリ上のストアは起動時にそれを拒否します。
モデル
- 参照: Spring Data JDBC と同じ
AggregateReferenceに加えて、Spring Data JDBC にはない@Reference(Author) int authorId。 - 外部キー、
@OnDelete(Hibernate の名前)、@Uniqueと@UniqueConstraint(JPA の名前) は追加されたものです。Spring Data JDBC はスキーマを利用者に任せます。 @MappedCollectionなしで型がエンティティであるフィールドはマッピングエラーです。Spring Data JDBC はそれを子とみなします。@EnableDataAuditingは Spring の@EnableJdbcAuditingです。
トランザクション
| Spring | ここでは | 理由 |
|---|---|---|
@Transactional("manager") |
@Transactional(transactionManager: 'manager') |
Dart では任意の位置引数と名前付き引数を混ぜられない。 |
| チェック例外はコミットする | すべての例外がロールバックする。コミットするものは noRollbackFor に列挙する |
Dart にはチェック例外がない。 |
トランザクションの外の @Lock のクエリはオートコミットで実行される |
IllegalTransactionStateException で失敗する |
ロックしない「ロックする」読み取りはバグ。 |
| スレッドに結び付いたトランザクション | Zone に結び付く: await に従う。await なしで開始され、トランザクションより長く生き残った処理は失敗する |
Dart にはスレッドがない。 |
同期的な @Transactional メソッド |
起動を止める | トランザクションは Future をカバーする。 |
PostgreSQL の 40001、40P01、55P03、25006 は CannotAcquireLockException、PessimisticLockingFailureException、UncategorizedSQLException になる (Spring 7 の JdbcTemplate) |
CannotSerializeTransactionException、DeadlockLoserDataAccessException、CannotAcquireLockException、InvalidDataAccessResourceUsageException |
同じスーパータイプを持つ、Spring の PostgreSQL のエラーコードの表のより細かいクラス。 |
残りは Spring と照合して測定されています。304 のシナリオ (伝播、ロールバックのルール、分離レベル、ロック、バージョン、タイムアウト) を、PostgreSQL 上で、スターターと Spring Boot 4.1 のアプリケーションの両方で実行し、CI のジョブが結果を比較しています。上の表は、意図的に残したものです。
データベースと設定
| Spring Boot | ここでは |
|---|---|
| クラスパス上の JDBC ドライバー | ジェネレーターが結び付ける sqlite3 または postgres パッケージ |
HikariCP、spring.datasource.hikari.* |
スターターのプール、spring.datasource.pool.* |
| コードでの 2 つ目のデータベース | spring.datasources.<name>.* |
Flyway、spring.flyway.* |
Flyway の命名を使うスターターのランナー、spring.sql.migration.* |
spring.jpa.hibernate.ddl-auto |
spring.data.jdbc.schema (none、validate、create、create-drop。update はない)。デフォルトは validate |
SpringApplication.run |
SQL データベースでは runApplicationAsync: スキーマは接続の上で準備され、Dart は await なしにそれを待てない |
| ログで値は決してマスクされない | 秘密に見える名前はマスクされる |
オーバーライドする DataSourceTransactionManager.prepareTransactionalConnection、DataSource のアダプター |
JdbcSessionHook の Bean |
ページング
PageRequest.ofは 2^53 - 1 を超えるオフセットを拒否するため、オフセットが一周することはありません。- メモリ上のストアと SQLite はテキストをコードユニットで並べ、PostgreSQL は Spring と同じくその照合順序で並べます。
- 大文字と小文字を区別しない並び順 (
SortOrder.ignoreCase、?sort=name,ignorecase) がカラムを小文字にするのは、Stringまたは enum のプロパティだけです。それ以外のプロパティでは通常の並び順になります。そうしないと、PostgreSQL ではクライアントが?sort=id,ignorecaseでデータベースのエラーを引き起こせてしまいます。Spring Data JPA が小文字にするのはStringのプロパティだけです。エンティティのプロパティではない@Queryメソッドの並び順の名前は、指定どおり小文字にされます。
テスト
@DataTest は、@AutoConfigureTestDatabase を伴う @DataJdbcTest の代わりです。それ自体がトランザクショナルで、テスト用のデータベースは常にメモリ上の SQLite のもの (replaceDatabase: false は自分のものを保ちます) で、失敗した @Commit のテストはロールバックされます。
まだ対応していないもの
- 名前付きクエリ (
@Query(name:))。 - 独自のコンバーター (
@ReadingConverter、@WritingConverter) とBigDecimal。金額はdoubleではなく、補助単位のintで保持してください。 - MongoDB とその他の SQL でないストア。
updateのスキーマモード (意図的: マイグレーションを書いてください)。- マイグレーションの clean コマンド (意図的: ランナーは決して何も削除しません)。