brick下载 - brick源代码下载

brick

其他源码

1.0.0

下载

DART中使用持久数据的直观方式。

完整的文档

GraphQl
休息
supabase

为什么要砖？

离线访问数据的开箱即用
处理和隐藏复杂的序列化/避免逻辑
单一访问点和自以为是的DSL
自动，智能生成的迁移
清晰的查询接口

什么是砖？

砖是DART应用程序的可扩展查询接口。这是一个多合一的解决方案，负责代表应用程序中的业务数据，无论您的数据来自何处。使用砖，开发人员可以专注于实施应用程序，而不必担心数据的寿命。 Brick的启发是受到应用程序首先离线工作的必要性，即使API代表了您的真理来源。

快速开始

添加软件包：

 dependencies :
  # Or brick_offline_first_with_graphql
  # Or brick_offline_first_with_supabase
  brick_offline_first_with_rest :
  sqflite : # optional
dev_dependencies :
  # Or brick_offline_first_with_graphql_build: any
  # Or brick_offline_first_with_supabase_build: any
  brick_offline_first_with_rest_build :
  build_runner :

配置您的应用程序目录结构以符合Brick的期望：
```
mkdir -p lib/brick/adapters lib/brick/db ;
```
添加包含您应用程序逻辑的模型。必须使用.model.dart后缀（即lib/brick/models/person.model.dart ）保存模型。
运行dart run build_runner build以生成您的模型，有时会迁移。重新运行每一个新的型号更改或dart run build_runner watch in Automatic Generations。第一次迁移后，您需要再次运行此操作。

扩展现有存储库或创建自己的（supabase有一些例外）：

 // lib/brick/repository.dart
import 'package:brick_offline_first_with_rest/brick_offline_first_with_rest.dart' ;
import 'package:brick_rest/brick_rest.dart' ;
import 'package:brick_sqlite/brick_sqlite.dart' ;
import 'package:my_app/brick/brick.g.dart' ;
import 'package:sqflite/sqflite.dart' show databaseFactory;
import 'package:my_app/brick/db/schema.g.dart' ;
export 'package:brick_core/query.dart' show And, Or, Query, QueryAction, Where, WherePhrase;

class Repository extends OfflineFirstWithRestRepository {
  Repository ()
      : super (
          migrations : migrations,
          restProvider : RestProvider (
            'http://0.0.0.0:3000' ,
            modelDictionary : restModelDictionary,
          ),
          sqliteProvider : SqliteProvider (
            _DB_NAME ,
            databaseFactory : databaseFactory,
            modelDictionary : sqliteModelDictionary,
          ),
          offlineQueueManager : RestRequestSqliteCacheManager (
            'brick_offline_queue.sqlite' ,
            databaseFactory : databaseFactory,
          ),
        );
}

利润。

用法

创建一个模型作为应用程序的业务逻辑：

 // brick/models/user.dart
@ConnectOfflineFirstWithRest ()
class User extends OfflineFirstWithRestModel {}

并生成（de）序列化代码以获取多个提供商：

$ (flutter) pub run build_runner build

获取数据

存储库获取并返回多个提供商的数据。这是您应用中数据的单个访问点：

 class MyRepository extends OfflineFirstWithRestRepository {
  MyRepository ();
}

final repository = MyRepository ();

// Now the models can be queried:
final users = await repository. get < User >();

在幕后，此存储库可以轮询内存缓存，然后是SQLite，然后是REST API。存储库明智地确定了如何以及何时使用每个提供商返回最快，最可靠的数据。

 // Queries can be general:
final query = Query (where : [ Where ( 'lastName' ). contains ( 'Muster' )]);
final users = await repository. get < User >(query : query);

// Or singular:
final query = Query . where ( 'email' , '[email protected]' , limit1 : true );
final user = await repository. get < User >(query : query);

查询还可以接收反应性更新。每当更新本地副本时，订阅的流都会从其查询中接收所有模型（例如，当数据在应用程序的另一部分中进行水合时）：

 final users = repository. subscribe < User >(). listen ((users) {})

突变数据

创建模型后，它将发送到存储库并返回每个提供商：

 final user = User ();
await repository. upsert < User >(user);

关联数据

存储库可以支持儿童模型的关联和自动（DE）序列化。

 class Hat extends OfflineFirstWithRestModel {
  final String color;
  Hat ({ this .color});
}
class User extends OfflineFirstWithRestModel {
  // user has many hats
  final List < Hat > hats;
}

final query = Query . where ( 'hats' , Where ( 'color' ). isExactly ( 'brown' ));
final usersWithBrownHats = repository. get < User >(query : query);