React / 系统课时

实现管理功能

实现管理功能

管理端需要把表单输入可靠地写入数据库,并支持创建、编辑、删除、发布和下线。本课使用 Server Action 与参数化 SQL,完成文章状态管理的核心闭环。

学习目标

  • 使用 Server Action 接收管理表单并执行数据库写入
  • 通过参数化 SQL 实现创建、更新、删除和状态切换
  • 在写入成功后刷新页面缓存并返回明确结果

准备数据库访问模块

下面示例使用 PostgreSQL 的 pg 驱动。安装依赖后,通过 DATABASE_URL 创建连接池;生产环境应限制连接池大小,并由部署平台安全注入连接串。

bash
npm install pg
npm install --save-dev @types/pg

预期结果

text
added <N> packages

实际包数量可能不同,命令退出码为 0 即表示安装成功。

ts
// src/lib/db.ts
import 'server-only'
import { Pool } from 'pg'

const globalForDb = globalThis as unknown as {
  pool?: Pool
}

export const db =
  globalForDb.pool ??
  new Pool({
    connectionString: process.env.DATABASE_URL,
    max: 10,
  })

if (process.env.NODE_ENV !== 'production') {
  globalForDb.pool = db
}

开发模式下复用全局连接池,可以避免热更新反复创建连接。该模块只能被服务端代码导入。

建立文章表

本课使用字符串主键,便于示例直接生成 UUID。若项目已有迁移工具,应把 SQL 放入迁移文件,而不是每次启动时重复执行。

sql
CREATE TABLE articles (
  id UUID PRIMARY KEY,
  slug VARCHAR(160) NOT NULL UNIQUE,
  title VARCHAR(200) NOT NULL,
  summary VARCHAR(500) NOT NULL DEFAULT '',
  content TEXT NOT NULL,
  status VARCHAR(20) NOT NULL CHECK (status IN ('DRAFT', 'PUBLISHED')),
  author_id UUID NOT NULL,
  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

预期结果

text
CREATE TABLE

如果表已存在,数据库会返回重复对象错误。真实项目应由迁移版本控制处理,而不是忽略错误继续运行。

实现创建与编辑

以下为片段示例,依赖项目已经建立登录会话,并能从 getCurrentUser() 返回包含 id 与 role 的当前用户。这里先限制为管理员,下一课再补充资源归属和统一校验。

ts
// src/lib/articles/actions.ts
'use server'

import { randomUUID } from 'node:crypto'
import { revalidatePath } from 'next/cache'
import { db } from '@/lib/db'
import { getCurrentUser } from '@/lib/auth/session'

type ActionResult = {
  ok: boolean
  message: string
}

function readRequired(formData: FormData, name: string): string {
  const value = formData.get(name)

  if (typeof value !== 'string' || !value.trim()) {
    throw new Error(`${name} is required`)
  }

  return value.trim()
}

export async function saveArticle(
  formData: FormData,
): Promise<ActionResult> {
  const user = await getCurrentUser()

  if (!user || user.role !== 'ADMIN') {
    return { ok: false, message: '无权操作' }
  }

  const id = formData.get('id')
  const slug = readRequired(formData, 'slug')
  const title = readRequired(formData, 'title')
  const summary = String(formData.get('summary') ?? '').trim()
  const content = readRequired(formData, 'content')

  if (typeof id === 'string' && id) {
    const result = await db.query(
      `UPDATE articles
       SET slug = $1, title = $2, summary = $3, content = $4,
           updated_at = NOW()
       WHERE id = $5
       RETURNING id`,
      [slug, title, summary, content, id],
    )

    if (result.rowCount === 0) {
      return { ok: false, message: '文章不存在' }
    }
  } else {
    await db.query(
      `INSERT INTO articles
       (id, slug, title, summary, content, status, author_id)
       VALUES ($1, $2, $3, $4, $5, 'DRAFT', $6)`,
      [randomUUID(), slug, title, summary, content, user.id],
    )
  }

  revalidatePath('/admin/articles')
  revalidatePath('/articles')
  return { ok: true, message: '保存成功' }
}

使用参数占位符 $1 到 $6 可以避免把表单内容直接拼进 SQL。当前代码只做最小必填校验,重复 slug 等数据库错误还应转换为用户可理解的信息。

实现状态切换与删除

发布和下线只改变状态;删除会永久移除数据,应在界面上二次确认。服务端不能相信客户端传来的目标状态,必须限制在允许集合内。

ts
// 继续写入 src/lib/articles/actions.ts
export async function changeArticleStatus(
  id: string,
  status: 'DRAFT' | 'PUBLISHED',
): Promise<ActionResult> {
  const user = await getCurrentUser()

  if (!user || user.role !== 'ADMIN') {
    return { ok: false, message: '无权操作' }
  }

  const result = await db.query(
    `UPDATE articles
     SET status = $1, updated_at = NOW()
     WHERE id = $2
     RETURNING slug`,
    [status, id],
  )

  if (result.rowCount === 0) {
    return { ok: false, message: '文章不存在' }
  }

  revalidatePath('/admin/articles')
  revalidatePath('/articles')
  revalidatePath(`/articles/${result.rows[0].slug}`)
  return { ok: true, message: status === 'PUBLISHED' ? '已发布' : '已下线' }
}

export async function deleteArticle(id: string): Promise<ActionResult> {
  const user = await getCurrentUser()

  if (!user || user.role !== 'ADMIN') {
    return { ok: false, message: '无权操作' }
  }

  const result = await db.query(
    'DELETE FROM articles WHERE id = $1',
    [id],
  )

  if (result.rowCount === 0) {
    return { ok: false, message: '文章不存在' }
  }

  revalidatePath('/admin/articles')
  revalidatePath('/articles')
  return { ok: true, message: '删除成功' }
}

预期结果

text
创建:新增一条 DRAFT 记录,并返回“保存成功”
编辑:更新指定文章,不改变当前状态
发布:状态变为 PUBLISHED,公开列表可以访问
下线:状态变为 DRAFT,公开列表不再显示
删除:记录被移除,再次操作返回“文章不存在”

连接管理表单

表单字段名必须与 Server Action 读取的名称一致。创建页面可直接把 saveArticle 作为表单动作;编辑页面额外提交隐藏的 id。

tsx
// src/app/admin/articles/new/page.tsx
import { redirect } from 'next/navigation'
import { saveArticle } from '@/lib/articles/actions'

export default function NewArticlePage() {
  async function submit(formData: FormData) {
    'use server'

    const result = await saveArticle(formData)

    if (!result.ok) {
      throw new Error(result.message)
    }

    redirect('/admin/articles')
  }

  return (
    <main>
      <h1>新建文章</h1>
      <form action={submit}>
        <label>
          Slug
          <input name="slug" required maxLength={160} />
        </label>
        <label>
          标题
          <input name="title" required maxLength={200} />
        </label>
        <label>
          摘要
          <textarea name="summary" maxLength={500} />
        </label>
        <label>
          正文
          <textarea name="content" required rows={12} />
        </label>
        <button type="submit">保存草稿</button>
      </form>
    </main>
  )
}

预期结果

text
管理员提交合法表单后,数据库新增一条 DRAFT 文章记录并跳转到管理列表。
提交空标题或空正文时,浏览器原生 required 校验会阻止提交。

浏览器校验只能改善交互,不能替代服务端校验。用户可以绕过页面直接调用操作,因此下一课会把角色、资源归属和字段规则统一放到服务端。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现管理功能

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

登录哪都通