Flutter数据库查询构建插件database_query_builder的使用

由Jean Roldan开发

• 介绍
• 插入语句
• 选择语句
• 条件语句
• 更新语句
• 删除语句
• 连接语句
• 过滤器
• 表操作

# 介绍

数据库查询构建器为Dart提供了一个简单、高效且流畅的接口来构建或运行数据库查询。它可用于执行大多数基本（临时）数据库操作，并与postgresql完美配合。我们希望以后能支持其他管理器。

此项目将暂时依赖于我们的源postgres库来连接到该管理器并执行查询，尽管确实存在多个基于ORM的库，但我们想要做一些自己的东西，一些疯狂的东西！

您可以使用我们的文件或使用自己的数据库进行测试，无需担心成功与否。

# 数据方法

我们有几个方法可以从查询中获取信息：

• get() 返回一个类型为map<String, dynamic>的列表，根据您的查询。
• getModel<T>() 返回一个强类型的类列表，以生成直接模型。
• toSql() 获取由查询构建器生成的查询，不需要数据库连接，您可以使用此函数生成所需的SQL，帮助您避免SQL注入。

DB.table('products').get();
DB.table('products').getModel<Product>(Product.fromJson);
DB.table('products').toSql();

原始表达式

# 插入语句

基本插入

提供了一个insert方法，可以使用键值对的映射来插入记录。

final numRowAffected = await DB.table('persons').insert({
    'firstName': 'testFirstName',
    'lastName': 'testLastName',
    'age': 30,
}).save()

多条插入

您可以一次性插入多条记录，通过传递一个包含键值对映射的列表来使用insertAll方法。

final sql03 = await DB.table('persons').insertAll([
  {
    'firstName': 'testFirstName1',
    'lastName': 'testLastName1',
    'age': 10,
  },
  {
    'firstName': 'testFirstName2',
    'lastName': 'testLastName2',
    'age': 20,
  },
  {
    'firstName': 'testFirstName3',
    'lastName': 'testLastName3',
    'age': 30,
  }
]).save();

获取插入ID

您可以使用insertGetId获取受影响行的ID，这将执行内部查询以获取主键。

final numRowAffected = await DB.table('persons').insertGetId({
    'firstName': 'testFirstName',
    'lastName': 'testLastName',
    'age': 30,
}).save()

如果您想避免双查询或者您没有读取这些属性的权限并且想提高查询性能，可以指定您的主键。

final numRowAffected = await DB.table('persons').insertGetId({
    'firstName': 'testFirstName',
    'lastName': 'testLastName',
    'age': 30,
},
'id').save()

同样地，您可以插入多条记录并获取它们的ID。

final numRowAffected = DB.table('people').insertAllGetIds(
  [
    {
      'first_name': 'new first name 1',
      'last_name': 'new first last name 1',
      'age': 12,
    },
    {
      'first_name': 'new first name 2',
      'last_name': 'new first last name 2',
      'age': 17,
    },
    {
      'first_name': 'new first last name 3',
      'last_name': 'new first last name 3',
      'age': 118,
    }
  ],
  'id',
);

# 选择语句

选择

DB.table('persons').select(['firstName','age']).get();

唯一性

# 条件语句

条件子句

创建简单的查询。

DB.table('people').where('age', '10').get();

您也可以使用自定义条件。

await DB.table('people').where('age', '=', 10).get();

否则，我们为您提供强类型的条件。

await DB.table('people').where('age', WhereType.equal, '10').get();
await DB.table('people').where('age', WhereType.greaterThan, '10').get();
await DB.table('people').where('age', WhereType.greaterThanOrEqual, '10').get();
await DB.table('people').where('age', WhereType.lessThan, '10').get();
await DB.table('people').where('age', WhereType.lessThanOrEqual, '10').get();
await DB.table('people').where('age', WhereType.like, '10').get();

嵌套条件

如果您已经看到如何分配where语句的工作方式，您可以随意以嵌套的方式进行。

DB.table('people')
  .where('age', 25)
  .where('age', '=', 10)
  .where('age', WhereType.greaterThan, 80)
  .get();

IN 条件

DB.table('people').whereIN('age', [10, 20, 30])

OR 条件

# 更新语句

更新

DB.table('persons')
  .update({'firstName': 'new first name', 'lastName': 'new last name'})
  .save();

带有条件更新

DB.table('persons')
  .update({'firstName': 'new first name', 'lastName': 'new last name'})
  .where('id', '1')
  .save();

更新或插入

# 删除语句

删除

您可以删除表中的所有记录。

DB.table('people').delete().save()

带有条件删除

执行搜索以删除记录。

DB.table('people').delete().where('id', 5).save();