React / 系统课时
增删改查与分页
增删改查与分页
本课用一个可重复执行的 TypeScript 脚本串联 Prisma Client 的创建、查询、更新、删除与分页。完成后,你能把筛选条件、稳定排序、总数统计和写操作组织成可复用的数据访问逻辑。
学习目标
- 能使用 Prisma Client 完成常见 CRUD 操作
- 能组合
where、orderBy、skip和take实现页码分页 - 能处理分页边界、稳定排序和删除风险
先定义查询契约
本课沿用 User、Post 和 PostStatus 模型,但脚本会自行准备测试数据,因此可以独立运行。分页函数接收关键词、页码和每页条数,返回当前页数据与匹配总数。
页码必须从 1 开始,每页条数限制在 1~50。排序同时使用 createdAt 和唯一的 id,避免多条记录创建时间相同时出现跨页重复或遗漏。
完整实现 CRUD 与分页
将下面代码保存为 scripts/crud.ts。项目需要已经生成 Prisma Client,并安装 PostgreSQL 驱动适配器;生成目录与导入路径不同时,应同步调整导入语句。
import "dotenv/config";
import { PrismaPg } from "@prisma/adapter-pg";
import {
PostStatus,
PrismaClient,
} from "../generated/prisma/client";
const databaseUrl = process.env.DATABASE_URL;
if (!databaseUrl) {
throw new Error("缺少 DATABASE_URL 环境变量");
}
const adapter = new PrismaPg({ connectionString: databaseUrl });
const prisma = new PrismaClient({ adapter });
async function listPublishedPosts(
client: PrismaClient,
keyword: string,
page: number,
pageSize: number,
) {
const safePage = Math.max(1, page);
const safePageSize = Math.min(50, Math.max(1, pageSize));
const where = {
status: PostStatus.PUBLISHED,
title: { contains: keyword },
};
// 列表与总数使用同一组过滤条件,避免分页元数据口径不一致。
const [rows, total] = await client.$transaction([
client.post.findMany({
where,
orderBy: [{ createdAt: "desc" }, { id: "desc" }],
skip: (safePage - 1) * safePageSize,
take: safePageSize,
select: { title: true, status: true },
}),
client.post.count({ where }),
]);
return {
page: safePage,
pageSize: safePageSize,
total,
titles: rows.map((row) => row.title),
};
}
async function main() {
const user = await prisma.user.upsert({
where: { email: "course@example.com" },
update: { name: "Course User" },
create: {
email: "course@example.com",
name: "Course User",
},
});
// 清理本示例自己的旧数据,使脚本重复执行时仍得到相同结果。
await prisma.post.deleteMany({
where: { authorId: user.id },
});
await prisma.post.createMany({
data: [
{
title: "Prisma Schema 入门",
status: PostStatus.DRAFT,
authorId: user.id,
},
{
title: "Prisma CRUD 实战",
status: PostStatus.PUBLISHED,
authorId: user.id,
},
{
title: "React 与 Prisma",
status: PostStatus.PUBLISHED,
authorId: user.id,
},
],
});
const pageResult = await listPublishedPosts(prisma, "Prisma", 1, 2);
console.log("分页结果:", JSON.stringify(pageResult));
const created = await prisma.post.create({
data: {
title: "待修改文章",
authorId: user.id,
},
});
const updated = await prisma.post.update({
where: { id: created.id },
data: {
title: "已发布文章",
status: PostStatus.PUBLISHED,
},
select: { title: true, status: true },
});
console.log("更新结果:", JSON.stringify(updated));
// delete 需要唯一条件;删除前应确认记录确实属于当前业务范围。
const deleted = await prisma.post.delete({
where: { id: created.id },
select: { title: true },
});
console.log("删除结果:", deleted.title);
}
main()
.catch((error) => {
console.error(error);
process.exitCode = 1;
})
.finally(async () => {
await prisma.$disconnect();
});运行脚本:
npx tsx scripts/crud.ts预期输出:
分页结果: {"page":1,"pageSize":2,"total":1,"titles":["Prisma CRUD 实战"]}
更新结果: {"title":"已发布文章","status":"PUBLISHED"}
删除结果: 已发布文章输出不包含数据库自增 ID,因此只要示例使用独立测试账号并成功连接数据库,重复执行仍能得到相同的可见结果。
读懂查询与写操作
findMany 负责列表查询,where 组合状态与标题条件,orderBy 保证结果顺序,skip 和 take 截取当前页。count 必须复用同一个 where,否则页面数据与总数会使用不同口径。
create 返回新记录,适合需要立即获得主键的写入;createMany 适合批量插入。update 和 delete 通常要求唯一条件,目标不存在时会抛出错误,因此接口层应把“记录不存在”转换成明确的业务响应。
选择分页方式并处理边界
| 方案 | 主要参数 | 适用场景 | 关键限制 |
|---|---|---|---|
| 页码分页 | skip、take |
管理后台、小到中等数据量、需要跳页 | 页码很深时数据库仍需越过大量记录 |
| 游标分页 | cursor、skip、take |
无限滚动、时间线、批量扫描 | 游标应使用唯一且稳定的排序字段,不能直接跳到任意页 |
本课使用页码分页,因为调用方需要明确的页码和总数。数据量很大或持续新增时,可改用唯一 ID 作为游标,并用 skip: 1 排除上一页最后一条记录。
删除是不可逆写操作。真实接口至少要校验资源归属,并根据业务选择软删除、事务或审计日志;不要直接把前端传入的 ID 交给 delete 而忽略权限条件。