React / 系统课时
实现项目管理功能
实现项目管理功能
本课将完成项目列表、创建、编辑、详情和删除的完整 CRUD 流程,并处理加载、空数据、权限不足、资源不存在和网络失败等状态。完成后,登录用户可以管理自己的项目,界面与服务端数据保持一致。
学习目标
- 设计项目数据结构与统一请求层
- 实现项目 CRUD 页面及数据刷新
- 处理权限、并发提交和常见异常状态
定义项目模型与接口
项目最小字段包括 id、name、description、ownerId 和 updatedAt。接口采用 REST 风格:列表使用 GET /api/projects,创建使用 POST /api/projects,详情与编辑使用 /api/projects/:id,删除使用 DELETE /api/projects/:id。
export type Project = {
id: string;
name: string;
description: string;
ownerId: string;
updatedAt: string;
};
export type ProjectInput = {
name: string;
description: string;
};这些类型用于约束表单输入和接口响应。验证方法是在编辑器中故意遗漏 name 字段,TypeScript 应提示类型错误;恢复字段后错误消失。
建立项目数据流
项目页面会同时涉及路由参数、表单状态、请求状态、服务端权限和列表缓存。把这些关系明确后,才能避免删除后列表不刷新、编辑页展示旧数据或无权限时仍显示操作按钮。

统一请求层负责发送 JSON、携带会话凭据并把不同状态码转换为可识别的错误。下面是可直接复用的完整模块。
export class ApiError extends Error {
constructor(
message: string,
public readonly status: number,
) {
super(message);
}
}
export async function api<T>(
url: string,
init?: RequestInit,
): Promise<T> {
const response = await fetch(url, {
...init,
credentials: "include",
headers: {
"Content-Type": "application/json",
...init?.headers,
},
});
if (!response.ok) {
const body = await response.json().catch(() => null);
throw new ApiError(body?.message ?? "请求失败", response.status);
}
if (response.status === 204) {
return undefined as T;
}
return response.json() as Promise<T>;
}预期结果:成功响应被解析为目标类型;删除接口返回 204 时得到 undefined;异常响应抛出带 status 的 ApiError,页面可据此显示不同提示。
200 -> 返回 JSON 数据
204 -> 返回 undefined
403 -> 抛出 ApiError,status 为 403
404 -> 抛出 ApiError,status 为 404实现列表与创建
列表页加载时显示骨架或“正在加载”,成功但数组为空时显示空状态,请求失败时显示重试按钮。创建成功后跳转到详情页,或返回列表并重新请求数据,不能只在本地拼接一个缺少服务端字段的临时对象。
下面的片段示例展示列表加载与删除后的刷新逻辑,依赖前面的 api 模块和项目类型。
import { useCallback, useEffect, useState } from "react";
import { api, ApiError } from "./api";
import type { Project } from "./types";
export function ProjectListPage() {
const [projects, setProjects] = useState<Project[]>([]);
const [loading, setLoading] = useState(true);
const [error, setError] = useState("");
const loadProjects = useCallback(async () => {
setLoading(true);
setError("");
try {
setProjects(await api<Project[]>("/api/projects"));
} catch (cause) {
setError(cause instanceof Error ? cause.message : "加载失败");
} finally {
setLoading(false);
}
}, []);
useEffect(() => {
void loadProjects();
}, [loadProjects]);
async function removeProject(id: string) {
if (!window.confirm("确定删除这个项目吗?")) {
return;
}
try {
await api<void>(`/api/projects/${id}`, { method: "DELETE" });
await loadProjects();
} catch (cause) {
if (cause instanceof ApiError && cause.status === 403) {
setError("你没有删除该项目的权限");
return;
}
setError(cause instanceof Error ? cause.message : "删除失败");
}
}
if (loading) return <p>正在加载项目...</p>;
if (error) return <button onClick={loadProjects}>{error},点击重试</button>;
if (projects.length === 0) return <p>暂无项目,请先创建。</p>;
return (
<ul>
{projects.map((project) => (
<li key={project.id}>
<span>{project.name}</span>
<button onClick={() => void removeProject(project.id)}>删除</button>
</li>
))}
</ul>
);
}预期结果:进入页面后显示项目列表;列表为空时显示创建提示;删除确认后请求服务端并重新加载;接口返回 403 时保留列表并显示无权限信息。
GET /api/projects -> 渲染项目列表
DELETE /api/projects/<ID> -> 204
再次 GET /api/projects -> 被删除项目不再出现实现详情与编辑
详情页从路由参数读取项目 ID,请求 /api/projects/:id。编辑表单初始化时使用服务端返回值,提交前执行 trim() 并校验名称非空。提交期间禁用保存按钮,成功后用服务端最新数据替换页面状态。
权限判断不能只依赖前端按钮隐藏。前端可以根据 ownerId 决定是否显示编辑和删除入口,但后端仍必须校验当前用户是否有权修改目标项目。资源已被其他人删除时,编辑请求可能返回 404;使用版本号或更新时间做并发控制时,还可能返回 409。
async function updateProject(
id: string,
input: { name: string; description: string },
) {
const name = input.name.trim();
if (!name) {
throw new Error("项目名称不能为空");
}
return api<Project>(`/api/projects/${id}`, {
method: "PUT",
body: JSON.stringify({
name,
description: input.description.trim(),
}),
});
}预期结果:合法输入返回更新后的项目;空名称在发送请求前被阻止;资源不存在或无权限时,由调用页面根据 ApiError.status 显示对应提示。
合法输入 -> PUT /api/projects/<ID> -> 返回更新后的项目
空名称 -> 不发送请求 -> 显示“项目名称不能为空”
403 -> 显示无编辑权限
404 -> 显示项目不存在处理异常与边界
400 表示输入不合法,应把服务端字段错误映射到表单;401 表示会话失效,应回到登录页;403 表示用户已登录但没有权限;404 表示项目不存在或已删除;409 表示并发更新冲突,应提示用户重新加载;500 或网络错误则保留当前输入并允许重试。
删除操作必须二次确认,提交按钮必须防重复点击。列表请求和详情请求在组件卸载后不应继续更新状态,可使用 AbortController 取消请求;若项目规模扩大,再引入 TanStack Query 统一缓存、失效和重试策略。
验收流程
创建一个项目并确认它出现在列表中;进入详情页检查字段;编辑名称后刷新页面确认数据已持久化;删除后确认列表刷新;使用无权限账号访问编辑地址,确认前端隐藏操作入口且后端返回 403;访问不存在的 ID,确认显示明确的空状态而不是白屏。