SQLite データベース
spring_boot_starter_data とプロパティに SQL データベース (spring.datasource.url、または spring.datasources.<name>.url) があると、相対パスの sqlite:file:books.db はアプリ自身のディレクトリのファイルになり、SQLite の同期的な呼び出しは専用の isolate で実行されます。そのため長いクエリが UI を止めることはありません。何も書く必要はありません。
使う理由
Flutter アプリには、データベースを置く作業ディレクトリがありません。そして SQLite の呼び出しは同期的なので、UI の isolate では遅いクエリがフレームを落とします。スターターはデータのスターターが必要とする二つのプロパティを設定するため、同じリポジトリのコードがサーバーでもアプリでも動きます。
例
# lib/resources/application.yml
spring:
datasource:
url: sqlite:file:books.db
sqlite:
location: support # support (デフォルト)、cache、documents
// リポジトリはデータのスターターのもの。ファイルはアプリのディレクトリにある。
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 にとどめてください。