06 — Model 层:数据模型与操作


6.1 Model 层是什么

Model 层是数据操作层,负责和数据存储(内存、数据库、文件等)打交道。

它只关心:

  • 数据怎么存
  • 怎么查出来
  • 怎么修改
  • 怎么删除

它不关心:

  • 业务规则(比如"名称不能重复"是 Service 层的事)
  • HTTP 请求(Model 层根本不知道有 HTTP 这回事)

6.2 为什么用内存存储做示例

本教程用内存数组来演示 Model 层,而不是直接上数据库。原因是:

  1. 聚焦架构思想,不用纠结数据库语法
  2. 没有数据库也能跑完整项目
  3. 换成真实数据库时,只改 Model 层,其他层不动

第 14 篇会讲怎么换成真实数据库。


6.3 类型定义

先定义数据长什么样。

src/models/project/project.ts:

typescript 复制代码
export interface Project {
  id: number;
  name: string;
  description: string;
  status: 'active' | 'inactive';
  created_at: number;  // Unix 时间戳(秒)
  updated_at: number;
}

用时间戳还是 Date 对象?

两种都常见,各有优劣:

方式 优点 缺点
Unix 时间戳(秒) 传输方便、数据库存数字就行 可读性差,前端要格式化
Date 对象 可读性好 序列化后是字符串,前后端要约定格式
ISO 字符串 人类可读 字符串比较大小不如数字方便

本教程用秒级时间戳,和大多数管理后台项目一致。


6.4 Model 类的实现

src/models/project/project-model.ts:

typescript 复制代码
import type { Project } from './project.js';

export class ProjectModel {
  // 用私有字段存数据,外部不能直接访问
  #projects: Project[];

  constructor(initialData: readonly Project[] = []) {
    // 深拷贝一份,防止外部修改影响内部数据
    this.#projects = initialData.map((item) => structuredClone(item));
  }

  // ===== 查询 =====

  // 获取全部列表
  list(): Project[] {
    return structuredClone(this.#projects);
  }

  // 按 ID 查找
  findById(id: number): Project | undefined {
    const project = this.#projects.find((p) => p.id === id);
    return project ? structuredClone(project) : undefined;
  }

  // 按名称查找(用于查重)
  findByName(name: string): Project | undefined {
    const project = this.#projects.find((p) => p.name === name);
    return project ? structuredClone(project) : undefined;
  }

  // ===== 新增 =====

  create(input: Pick<Project, 'name' | 'description' | 'status'>): Project {
    const now = Math.floor(Date.now() / 1000);
    const project: Project = {
      ...input,
      id: this.#nextId(),
      created_at: now,
      updated_at: now,
    };
    this.#projects.push(structuredClone(project));
    return structuredClone(project);
  }

  // ===== 更新 =====

  update(
    id: number,
    input: Partial<Pick<Project, 'name' | 'description' | 'status'>>,
  ): Project | undefined {
    const project = this.#projects.find((p) => p.id === id);
    if (!project) return undefined;

    if (input.name !== undefined) project.name = input.name;
    if (input.description !== undefined) project.description = input.description;
    if (input.status !== undefined) project.status = input.status;
    project.updated_at = Math.floor(Date.now() / 1000);

    return structuredClone(project);
  }

  // ===== 删除 =====

  delete(id: number): boolean {
    const index = this.#projects.findIndex((p) => p.id === id);
    if (index < 0) return false;
    this.#projects.splice(index, 1);
    return true;
  }

  // ===== 内部方法 =====

  // 生成自增 ID
  #nextId(): number {
    if (this.#projects.length === 0) return 1;
    return Math.max(...this.#projects.map((p) => p.id)) + 1;
  }
}

6.5 几个关键设计

1. 私有字段(#projects)

用 # 而不是 private 关键字。

  • private 是 TypeScript 的,编译后就没了,运行时还是能访问
  • # 是 JavaScript 原生私有字段,运行时也访问不了

真正想保护数据,用 #。

2. 每次返回都深拷贝

typescript 复制代码
list(): Project[] {
  return structuredClone(this.#projects);
}

为什么要深拷贝?因为如果直接返回内部数组的引用,外部修改了返回值,内部数据也会被改,绕过了 Model 的控制。

typescript 复制代码
// 如果不拷贝,外部可以直接改内部数据
const list = projectModel.list();
list[0].name = '被篡改了';  // 内部数据也变了!

深拷贝保证了外部只能通过 Model 的方法修改数据,数据一致性有保障。

3. 新增和更新时自动维护时间戳

created_at 和 updated_at 由 Model 层自动维护,调用方不用管。

4. 用 Pick / Partial 定义入参

typescript 复制代码
create(input: Pick<Project, 'name' | 'description' | 'status'>): Project
update(id: number, input: Partial<Pick<Project, 'name' | 'description' | 'status'>>)
  • Pick 表示从接口里挑出哪些字段
  • Partial 表示这些字段都是可选的(更新时不需要传全部)

这样定义入参,类型安全又不重复。


6.6 初始数据

src/data/project/index.ts:

typescript 复制代码
import type { Project } from '@/models/project/project.js';

const CREATED_AT = 1_700_000_000;

export const projectData: readonly Project[] = [
  {
    id: 1,
    name: '示例项目A',
    description: '这是一个示例项目',
    status: 'active',
    created_at: CREATED_AT,
    updated_at: CREATED_AT,
  },
  {
    id: 2,
    name: '示例项目B',
    description: '这是另一个示例项目',
    status: 'inactive',
    created_at: CREATED_AT,
    updated_at: CREATED_AT,
  },
];

在 bootstrap 里把初始数据传给 Model:

typescript 复制代码
import { projectData } from './data/project/index.js';
import { ProjectModel } from './models/project/project-model.js';

const projectModel = new ProjectModel(projectData);

6.7 Model 层能有查询方法吗

可以。Model 层除了基础的 CRUD,还可以有各种查询方法,比如:

typescript 复制代码
// 按状态筛选
listByStatus(status: Project['status']): Project[] {
  return this.#projects
    .filter((p) => p.status === status)
    .map((p) => structuredClone(p));
}

// 模糊搜索名称
searchByName(keyword: string): Project[] {
  const lower = keyword.toLowerCase();
  return this.#projects
    .filter((p) => p.name.toLowerCase().includes(lower))
    .map((p) => structuredClone(p));
}

原则:Model 层只管「怎么查数据」,不管「为什么要查这些数据」。

比如"管理员能看到所有项目,普通用户只能看到自己的项目"------这是业务规则,应该在 Service 层做判断,然后调用 Model 的不同方法。


6.8 小结

  • Model 层只做数据 CRUD,不包含业务逻辑
  • 用私有字段保护数据,外部只能通过方法操作
  • 返回数据时深拷贝,防止外部直接修改内部状态
  • 时间戳、ID 自增等由 Model 层自动维护
  • 初始数据放在 data/ 目录,启动时注入 Model
相关推荐
澹锦汐2 小时前
纯前端秋日银杏与枫叶落叶色板智能聚类器:基于 K-Means 色彩量化与直方图自动配方提取
前端·人工智能·ai·语言模型·vue·react·k-means
码事漫谈9 小时前
当公司不久后变成冒险者公会,我担心什么
后端
Flynt9 小时前
AI 写的 Three.js 大屏,为什么越跑越卡?我在 Node 里复现了它的内存曲线
前端·ai编程·three.js
Csvn10 小时前
Nginx 负载均衡进阶与健康检查:哈希、keepalive 池与 DNS 自愈
后端·nginx
皮皮林55111 小时前
京东又开源一款新框架,用起来真优雅!
后端
学长毕设11 小时前
基于SpringBoot智慧养老服务平台设计与实现-附源码
java·spring boot·后端
一个游离的指针11 小时前
Vue2:vue-router
前端·javascript·vue.js
行百里er14 小时前
【Spring Insight 技术分享】跨服务调用链路是怎么串起来的?
后端·spring·开源
火山引擎和TA的超级拍档们14 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端
JavaGuide14 小时前
Gemini 真的变强了,写代码做视频的能力接近 Claude Opus5.5 了!
前端·ai编程