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 驱动适配器;生成目录与导入路径不同时,应同步调整导入语句。

ts
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();
  });

运行脚本:

bash
npx tsx scripts/crud.ts

预期输出:

text
分页结果: {"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 而忽略权限条件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

增删改查与分页

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通