React / 系统课时

实现项目管理功能

实现项目管理功能

本课将完成项目列表、创建、编辑、详情和删除的完整 CRUD 流程,并处理加载、空数据、权限不足、资源不存在和网络失败等状态。完成后,登录用户可以管理自己的项目,界面与服务端数据保持一致。

学习目标

  • 设计项目数据结构与统一请求层
  • 实现项目 CRUD 页面及数据刷新
  • 处理权限、并发提交和常见异常状态

定义项目模型与接口

项目最小字段包括 id、name、description、ownerId 和 updatedAt。接口采用 REST 风格:列表使用 GET /api/projects,创建使用 POST /api/projects,详情与编辑使用 /api/projects/:id,删除使用 DELETE /api/projects/:id。

ts
export type Project = {
  id: string;
  name: string;
  description: string;
  ownerId: string;
  updatedAt: string;
};

export type ProjectInput = {
  name: string;
  description: string;
};

这些类型用于约束表单输入和接口响应。验证方法是在编辑器中故意遗漏 name 字段,TypeScript 应提示类型错误;恢复字段后错误消失。

建立项目数据流

项目页面会同时涉及路由参数、表单状态、请求状态、服务端权限和列表缓存。把这些关系明确后,才能避免删除后列表不刷新、编辑页展示旧数据或无权限时仍显示操作按钮。

项目 CRUD 数据流与异常分支

统一请求层负责发送 JSON、携带会话凭据并把不同状态码转换为可识别的错误。下面是可直接复用的完整模块。

ts
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,页面可据此显示不同提示。

text
200 -> 返回 JSON 数据
204 -> 返回 undefined
403 -> 抛出 ApiError,status 为 403
404 -> 抛出 ApiError,status 为 404

实现列表与创建

列表页加载时显示骨架或“正在加载”,成功但数组为空时显示空状态,请求失败时显示重试按钮。创建成功后跳转到详情页,或返回列表并重新请求数据,不能只在本地拼接一个缺少服务端字段的临时对象。

下面的片段示例展示列表加载与删除后的刷新逻辑,依赖前面的 api 模块和项目类型。

tsx
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 时保留列表并显示无权限信息。

text
GET /api/projects -> 渲染项目列表
DELETE /api/projects/<ID> -> 204
再次 GET /api/projects -> 被删除项目不再出现

实现详情与编辑

详情页从路由参数读取项目 ID,请求 /api/projects/:id。编辑表单初始化时使用服务端返回值,提交前执行 trim() 并校验名称非空。提交期间禁用保存按钮,成功后用服务端最新数据替换页面状态。

权限判断不能只依赖前端按钮隐藏。前端可以根据 ownerId 决定是否显示编辑和删除入口,但后端仍必须校验当前用户是否有权修改目标项目。资源已被其他人删除时,编辑请求可能返回 404;使用版本号或更新时间做并发控制时,还可能返回 409。

tsx
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 显示对应提示。

text
合法输入 -> PUT /api/projects/<ID> -> 返回更新后的项目
空名称 -> 不发送请求 -> 显示“项目名称不能为空”
403 -> 显示无编辑权限
404 -> 显示项目不存在

处理异常与边界

400 表示输入不合法,应把服务端字段错误映射到表单;401 表示会话失效,应回到登录页;403 表示用户已登录但没有权限;404 表示项目不存在或已删除;409 表示并发更新冲突,应提示用户重新加载;500 或网络错误则保留当前输入并允许重试。

删除操作必须二次确认,提交按钮必须防重复点击。列表请求和详情请求在组件卸载后不应继续更新状态,可使用 AbortController 取消请求;若项目规模扩大,再引入 TanStack Query 统一缓存、失效和重试策略。

验收流程

创建一个项目并确认它出现在列表中;进入详情页检查字段;编辑名称后刷新页面确认数据已持久化;删除后确认列表刷新;使用无权限账号访问编辑地址,确认前端隐藏操作入口且后端返回 403;访问不存在的 ID,确认显示明确的空状态而不是白屏。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现项目管理功能

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

登录哪都通