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。即使标识来自页面,服务端仍需验证归属和权限,不能因为用户看到了记录就默认允许修改。
事务与并发边界
真实数据库写入应把相互依赖的变化放进同一事务。例如创建订单并扣减库存不能只成功一半。编辑时可以使用版本号或更新时间做乐观锁,删除时应由外键、状态机或领域规则保护关联数据。
关键写操作要记录操作者、时间和变更内容。对于不可逆操作,可以采用软删除或二次确认,但最终安全边界仍在服务器和数据库,而不是确认弹窗。
按自己的节奏,确认真正理解。