Flutter——数据库Drift开发详细教程(五)

参考

https://drift.simonbinder.eu/dart_api/schema_inspection/

正文运行时模式检查

得益于 Drift 生成的类型安全表类，在 Dart 中编写 SQL 查询既简单又安全。然而，这些查询通常针对特定的表。虽然 Drift 支持表的继承，但有时通过反射访问表会更容易。幸运的是，Drift 生成的代码实现了可用于执行此操作的接口。

由于大多数漂移用户并不需要这个主题，因此本页面主要提供一些启发性的示例以及相关漂移类文档的链接。例如，您可能有多个包含同一id列的独立表。并且您可能希望按列筛选行id。当针对单个表（例如入门Todos页面中所示的表）编写此查询时，操作非常简单：

个人理解：其实就是针对数据库操作相关代码进行二次封装；

Selectable<Todo> findTodoEntryById(int id) {return select(todos)..where((row) => row.id.equals(id));
}

但是，假设我们想将此查询推广到每个数据库表，该怎么办呢？以下代码片段展示了如何实现这一点（请注意，代码片段中的链接直接指向相关文档）：

extension FindById<Table extends HasResultSet, Row>on ResultSetImplementation<Table, Row> {Selectable<Row> findById(int id) {return select()..where((row) {final idColumn = columnsByName['id'];if (idColumn == null) {throw ArgumentError.value(this, 'this', 'Must be a table with an id column');}if (idColumn.type != DriftSqlType.int) {throw ArgumentError('Column `id` is not an integer');}return idColumn.equals(id);});}
}

由于这比仅适用于单个表的查询要复杂得多，让我们详细看看每一行有趣的内容：

• FindById是ResultSetImplementation的扩展。此类是 Drift
  生成的每个表或视图的超类。它定义了一些有用的方法来检查模式，或将Map表示数据库行的原始数据转换为生成的数据类。
• ResultSetImplementation使用两个类型参数进行实例化：原始表类和生成的行类。例如，如果您定义了一个表class
  Todos extends Table，drift 会生成一个继承自该表的类Todos，同时实现该类。
• ResultSetImplementation<Todos, Todo>（其中，driftTodo是生成的数据类）。
• ResultSetImplementation有两个子类：TableInfo和ViewInfo，分别混合到生成的表和视图类中。
• HasResultSetTable是和的超类View，这两个类用于在drift 中声明表和视图。
• **Selectable表示一个查询，您可以使用get()、watch()和getSingle()等方法watchSingle()**来运行该查询。
• select()所使用的扩展可findById用于启动选择语句，而无需引用数据库类 - 您所需要的只是表实例。
• 在 SQL 中，我们可以columnsByName通过名称查找列。这里，我们期望int存在一个列。
• GeneratedColumn类表示数据库中的一列。可以从列实例中读取诸如列约束、类型或默认值等信息。
• 具体来说，我们使用它来断言该表确实有一个IntColumn名为的id。

更新和插入

同样的方法也适用于构造更新、删除和插入语句（尽管 由于视图是只读的，这些语句需要TableInfo而不是ResultSetImplementationInsertable ）。此外，更新和插入分别使用一个对象来表示更新或插入列的部分行。对于已知表，可以使用生成的类型化Companion对象来实现。但这也可以通过模式自省来实现，这要归功于RawValuesInsertable，它可以用作Insertable由列名到值的映射支持的泛型。

此示例在前一个示例的基础上，title根据id列的过滤器来更新通用表的列：

extension UpdateTitle on DatabaseConnectionUser {Future<Row?> updateTitle<T extends TableInfo<Table, Row>, Row>(T table, int id, String newTitle) async {final columnsByName = table.columnsByName;final stmt = update(table)..where((tbl) {final idColumn = columnsByName['id'];if (idColumn == null) {throw ArgumentError.value(this, 'this', 'Must be a table with an id column');}if (idColumn.type != DriftSqlType.int) {throw ArgumentError('Column `id` is not an integer');}return idColumn.equals(id);});final rows = await stmt.writeReturning(RawValuesInsertable({'title': Variable<String>(newTitle),}));return rows.singleOrNull;}
}

在数据库或数据库访问器类中，可以像这样调用该方法：

Future<Todo?> updateTodoTitle(int id, String newTitle) {return updateTitle(todos, id, newTitle);
}

具体详细使用方法，可以去学习源码