跨平台开发 / 系统课时
更新和删除指定记录
更新和删除指定记录
本地数据发生变化时,通常只应修改用户正在操作的那一条记录,而不是重写整张表。本节使用 sqflite 的 update 和 delete,通过主键与参数化条件精确定位记录,并利用受影响行数验证操作是否真正生效。
学习目标
- 使用
where和whereArgs精确更新指定记录 - 按主键或业务条件删除数据
- 根据受影响行数判断更新、删除是否成功
用条件限制修改范围
sqflite 的 update 和 delete 都允许通过 where 指定筛选条件。最重要的规则是:需要修改单条记录时,必须提供足够精确的条件。
例如以自增主键 id 定位一条待办记录时,应写成 where: 'id = ?',再通过 whereArgs 传入实际 ID。不要把 ID 直接拼进 SQL 字符串;当条件值来自输入或其他动态数据时,参数绑定更安全,也更不容易出现转义错误。
如果省略 where,更新或删除可能作用于整张表,因此这类操作必须特别谨慎。
更新并删除指定记录
下面的完整示例创建两条记录:先把第一条待办更新为已完成,再删除第二条过期记录。update 和 delete 的返回值都是受影响的行数,可以直接用于验证操作结果。
import 'package:flutter/material.dart';
import 'package:path/path.dart' as p;
import 'package:sqflite/sqflite.dart';
Future<void> main() async {
WidgetsFlutterBinding.ensureInitialized();
final dbPath = p.join(await getDatabasesPath(), 'update_delete_demo.db');
await deleteDatabase(dbPath);
final db = await openDatabase(
dbPath,
version: 1,
onCreate: (database, version) async {
await database.execute('''
CREATE TABLE todos (
id INTEGER PRIMARY KEY AUTOINCREMENT,
title TEXT NOT NULL,
done INTEGER NOT NULL DEFAULT 0
)
''');
},
);
final firstId = await db.insert(
'todos',
{'title': '整理发票', 'done': 0},
);
await db.insert(
'todos',
{'title': '过期草稿', 'done': 0},
);
// 只更新主键匹配的记录,避免影响其他待办事项。
final updatedRows = await db.update(
'todos',
{'title': '整理本月发票', 'done': 1},
where: 'id = ?',
whereArgs: [firstId],
);
final deletedRows = await db.delete(
'todos',
where: 'title = ?',
whereArgs: ['过期草稿'],
);
final remainingRows = await db.query(
'todos',
orderBy: 'id ASC',
);
print('updated=$updatedRows');
print('deleted=$deletedRows');
for (final row in remainingRows) {
print(
'${row['id']} ${row['title']} done=${(row['done'] as int) == 1}',
);
}
await db.close();
}预期输出
updated=1
deleted=1
1 整理本月发票 done=true示例每次启动前删除教学数据库,所以自增主键从 1 开始。真实应用通常不会删除数据库,实际 ID 应以 insert 返回值或已有业务对象中的主键为准。
用受影响行数判断结果
update 和 delete 返回的不是修改后的对象,而是实际受影响的记录数量。如果按主键操作时返回 1,通常表示目标记录存在且操作成功;返回 0 则意味着当前条件没有匹配记录。
例如删除一个可能已经不存在的 ID,可以显式判断结果:
final affected = await db.delete(
'todos',
where: 'id = ?',
whereArgs: [targetId],
);
if (affected == 0) {
print('记录不存在或已经被删除');
}这是片段示例,依赖已经打开的 db 以及调用方提供的 targetId。当 targetId 没有匹配记录时,预期输出为:
记录不存在或已经被删除通过受影响行数判断结果,比在执行后默认认为数据库已经修改成功更可靠。对于需要刷新页面状态、显示提示或记录日志的场景,这个返回值尤其有用。
避免误更新和误删除
主键是修改单条记录时最稳定的条件。使用标题、名称等普通字段删除时,要先确认它们是否唯一;否则一次操作可能匹配多行。
当业务确实要求批量修改时,可以使用业务条件,例如删除所有已完成记录:where: 'done = ?'、whereArgs: [1]。此时返回值可能大于 1,应用应把它视为预期的批量行为,而不是错误。
对于需要同时执行多次相互依赖的修改,应进一步使用数据库事务,避免前一条更新已经提交而后一条操作失败。单条记录的普通更新和删除,则优先保持条件明确、参数绑定,并检查受影响行数即可。