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>

制限

関連項目