React / 系统课时

完成数据更新

完成数据更新

本课用一个任务列表完成新增、编辑和删除三类数据变更。你将把页面表单连接到独立服务端操作,并通过仓储层集中管理数据,而不是把所有写入逻辑堆在组件中。

学习目标

  • 为新增、编辑和删除分别设计服务端操作
  • 使用 bind 为操作预绑定记录标识
  • 在变更后重新验证列表页面并观察更新结果

最小实现结构

页面负责展示数据和声明表单,actions.ts 负责接收请求并执行权限、校验与刷新,store.ts 负责数据读写。拆分后,页面不需要知道数据如何保存,仓储也不依赖 React 组件。

本课使用进程内数组模拟数据库,只适合本地学习。多实例部署、进程重启和并发事务必须交给真实数据库处理。

主示例:任务增删改

以下三个文件属于同一个可运行示例,单个文件均是依赖同目录其他文件的片段示例。

ts
// app/tasks/store.ts
export type Task = {
  id: number
  title: string
}

const store = globalThis as typeof globalThis & {
  __tasks?: Task[]
  __nextTaskId?: number
}

store.__tasks ??= [{ id: 1, title: '学习 Server Actions' }]
store.__nextTaskId ??= 2

export async function listTasks(): Promise<Task[]> {
  return [...(store.__tasks ?? [])]
}

export async function createTask(title: string): Promise<void> {
  const id = store.__nextTaskId ?? 1
  store.__tasks?.push({ id, title })
  store.__nextTaskId = id + 1
}

export async function updateTask(id: number, title: string): Promise<void> {
  const task = store.__tasks?.find((item) => item.id === id)

  if (!task) {
    throw new Error('任务不存在')
  }

  task.title = title
}

export async function deleteTask(id: number): Promise<void> {
  store.__tasks = (store.__tasks ?? []).filter((item) => item.id !== id)
}
ts
// app/tasks/actions.ts
'use server'

import { revalidatePath } from 'next/cache'
import {
  createTask as insertTask,
  deleteTask as removeTask,
  updateTask as changeTask,
} from './store'

function readTitle(formData: FormData): string {
  const title = String(formData.get('title') ?? '').trim()

  if (!title) {
    throw new Error('任务标题不能为空')
  }

  return title
}

export async function createTask(formData: FormData) {
  await insertTask(readTitle(formData))
  revalidatePath('/tasks')
}

export async function updateTask(id: number, formData: FormData) {
  await changeTask(id, readTitle(formData))
  revalidatePath('/tasks')
}

export async function deleteTask(id: number) {
  await removeTask(id)
  revalidatePath('/tasks')
}
tsx
// app/tasks/page.tsx
import {
  createTask,
  deleteTask,
  updateTask,
} from './actions'
import { listTasks } from './store'

export default async function TasksPage() {
  const tasks = await listTasks()

  return (
    <main>
      <h1>任务管理</h1>

      <form action={createTask}>
        <label htmlFor="new-title">新任务</label>
        <input id="new-title" name="title" required />
        <button type="submit">新增</button>
      </form>

      <ul>
        {tasks.map((task) => {
          const updateTaskWithId = updateTask.bind(null, task.id)
          const deleteTaskWithId = deleteTask.bind(null, task.id)

          return (
            <li key={task.id}>
              <form action={updateTaskWithId}>
                <label htmlFor={`title-${task.id}`}>任务 {task.id}</label>
                <input
                  id={`title-${task.id}`}
                  name="title"
                  defaultValue={task.title}
                  required
                />
                <button type="submit">保存修改</button>
              </form>

              <form action={deleteTaskWithId}>
                <button type="submit">删除</button>
              </form>
            </li>
          )
        })}
      </ul>
    </main>
  )
}

预期结果

text
首次访问 /tasks 时显示“学习 Server Actions”。
新增“完成表单章节”后,列表出现第二条任务。
修改任意标题并保存后,列表显示新标题。
点击删除后,对应任务从列表中移除。

三类操作的差异

新增操作通常只需要输入字段,由服务器生成主键和审计信息。编辑操作必须携带目标标识,并检查记录是否存在、当前用户是否有修改权限。删除操作输入最少,但风险最高,常需要确认、软删除或引用关系检查。

bind(null, task.id) 会预绑定服务端已渲染的记录标识,使表单提交时操作函数收到 id 和 FormData。即使标识来自页面,服务端仍需验证归属和权限,不能因为用户看到了记录就默认允许修改。

事务与并发边界

真实数据库写入应把相互依赖的变化放进同一事务。例如创建订单并扣减库存不能只成功一半。编辑时可以使用版本号或更新时间做乐观锁,删除时应由外键、状态机或领域规则保护关联数据。

关键写操作要记录操作者、时间和变更内容。对于不可逆操作,可以采用软删除或二次确认,但最终安全边界仍在服务器和数据库,而不是确认弹窗。

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

目录与阅读设置

阅读设置

17

记录一个想法

完成数据更新

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

登录哪都通