Spring との違い

spring_boot_starter_data は Spring Data JDBC と Spring Boot に従っています。アノテーション、インターフェース、クエリの文法、トランザクションのルール、そして意味のある範囲でプロパティの名前も同じです。このページでは、そうでない箇所をすべて、その理由とともに列挙します。

使う理由

Spring のアプリケーションを移植するとき、あるいは Spring Data のチュートリアルに従うとき、動作が期待どおりでない箇所を知る必要があります。違いのほとんどは、次の 3 つの事実から来ています。

例

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

モデル

トランザクション

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

ページング

テスト

@DataTest は、@AutoConfigureTestDatabase を伴う @DataJdbcTest の代わりです。それ自体がトランザクショナルで、テスト用のデータベースは常にメモリ上の SQLite のもの (replaceDatabase: false は自分のものを保ちます) で、失敗した @Commit のテストはロールバックされます。

まだ対応していないもの

関連項目