
# SQLite データベース

`spring_boot_starter_data` とプロパティに SQL データベース (`spring.datasource.url`、または `spring.datasources.<name>.url`) があると、相対パスの `sqlite:file:books.db` はアプリ自身のディレクトリのファイルになり、SQLite の同期的な呼び出しは専用の isolate で実行されます。そのため長いクエリが UI を止めることはありません。何も書く必要はありません。

## 使う理由

Flutter アプリには、データベースを置く作業ディレクトリがありません。そして SQLite の呼び出しは同期的なので、UI の isolate では遅いクエリがフレームを落とします。スターターはデータのスターターが必要とする二つのプロパティを設定するため、同じリポジトリのコードがサーバーでもアプリでも動きます。

## 例

```yaml
# lib/resources/application.yml
spring:
  datasource:
    url: sqlite:file:books.db
    sqlite:
      location: support     # support (デフォルト)、cache、documents
```

```dart
// リポジトリはデータのスターターのもの。ファイルはアプリのディレクトリにある。
abstract interface class BookRepository
    implements ListCrudRepository<Book, int> {
  Future<List<Book>> findByAuthor(String author);
}
```

## スターターが設定するもの

アプリケーションの起動前に、スターターは `path_provider` からアプリのディレクトリを読みます。設定ファイルが読まれた後、プライマリのデータソースと名前付きの各データソースについて、次を設定します。

| キー | 値 | 意味 |
|---|---|---|
| `spring.datasource.sqlite.base-directory` | `location` のディレクトリ | 相対的なファイル名はここからの相対になる。ディレクトリがなければ作られる |
| `spring.datasource.sqlite.isolate` | `true` | 各接続が専用の isolate で実行される |

これらはすべての中で最も低い優先度を持ちます。独自のプロパティ (ファイル、`--dart-define`、`defaultProperties`) が優先されます。データソースがなければ何も設定されません。スターターは互いに依存しません。こちらは、もう一方が読むプロパティを設定するだけです。

## プロパティ

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.datasource.sqlite.location` | `support`、`cache`、`documents` | `support` | データベースを置くアプリのディレクトリ。それ以外の値は、この三つを示して起動を止める |
| `spring.datasources.<name>.sqlite.location` | 同じ | `support` | 名前付きのデータソースについての同じもの |

`support` はアプリのプライベートなデータで、システムが削除することはなく、デバイスとともにバックアップされます。`cache` は空き容量が足りなくなると削除されることがあるため、作り直せるデータベースのためのものです。`documents` はユーザーの書類フォルダーです。

| プラットフォーム | `support` のディレクトリ |
|---|---|
| Android | `Context.getDatabasePath` と同じ、アプリの `databases/` ディレクトリ |
| iOS | `Library/Application Support` |
| macOS | コンテナの `Application Support/<bundle id>` |
| Windows | `%LOCALAPPDATA%\<company>\<product>` (ローミングのディレクトリではない)。`cache` はその `cache` フォルダーなので、二つがフォルダーを共有することはない |
| Linux | `$XDG_DATA_HOME/<app id>` |

## 制限

- **Web** にはまだそうしたディレクトリがありません。そこでは何も設定されません。
- **ウィジェットテスト**には `path_provider` のプラグインがありません。何も設定されず、データベースは URL が示す場所にとどまります。ディレクトリをテストするには、`PathProviderPlatform` のフェイクを組み込んでください。
- **読めるディレクトリがない場合。** ディレクトリが読めず、何も指定されていない場合は `isolate` だけが設定され、相対的なファイル名は作業ディレクトリからの相対のままであることを警告が伝えます。
- **ローダーのオーバーライド。** `sqlite3` パッケージのローダーのオーバーライド (`open.overrideFor(...)`) は isolate ごとのものです。`main` で行ったものはワーカーの isolate には届きません。プラットフォームがオーバーライドを必要とする場合は、`spring.datasource.sqlite.isolate=false` を設定して (独自のプロパティが優先されます)、呼び出しを UI の isolate にとどめてください。

## 関連項目

- [アプリのファイル](files.md)
- [ジェネレーターのデータ](../spring-core-dart-generator/data.md)
- [Flutter アプリでの設定](configuration.md)
