
# Spring との違い

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

## 使う理由

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

- **Dart は Java ではありません。** 実行時のリフレクションも、オーバーロードも、チェック例外も、スレッドもありません。ビルドがリポジトリを書き、メソッドは別々の名前を持ち、すべての例外がロールバックし、トランザクションは `Zone` を通して `await` に従います。
- **すべてが非同期です。** Dart は Isolate ごとに一つのスレッドを持つため、ブロックする API はありません。
- **ビルドがより多くを知っています。** 派生クエリの名前、`@Query` のテキスト、SpEL 式は、起動時ではなくビルドがチェックします。

## 例

```dart
abstract interface class BookRepository implements ListCrudRepository<Book, int> {
  Future<List<Book>> findByTitleContaining(String part);
  Future<Book?> findFirstByOrderByYearAsc();
}
```

```java
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')` | 一つのスターター、複数のストア。 |
| モジュールにない機能は、そこには存在しない | ストアが[機能](stores.md)を宣言する。それ以上を必要とするリポジトリは起動時に失敗する | 同じリポジトリのインターフェースが複数のストアで動く。 |
| `@Procedure(procedureName = "name")` (Spring Data JPA のみ) | [`@Procedure('name')`](database-functions.md) | 名前で呼び出すデータベース関数。 |
| Spring Data JDBC に変更ストリームはない | 変更を報告するストアでの [`RowChange` のストリーム](changes.md) | |

## @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`](session-hooks.md) の 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 コマンド (意図的: ランナーは決して何も削除しません)。

## 関連項目

- [概要](index.md)
- [すべてのプロパティ](properties.md)
- [トランザクション](transactions.md)
