ORM

这一课你将能做到

1. 说清楚 ORM 解决什么问题、付出什么代价，以及「什么时候该绕过它手写 SQL」
2. 用 Prisma 完成模型定义、迁移、CRUD 和关联查询的完整流程（JPA/MyBatis 对照代码也会给）
3. 亲眼制造并修复一次 N+1 查询，掌握「发现 + 定位 + 解决」的标准动作

为什么要学

第 4 课你手写 SQL 时体验过痛点：查询结果是一行行数据，要自己映射回对象；拼接 SQL 字符串一不小心就注入漏洞；改了表结构全项目 SQL 要逐个排查。**ORM（对象关系映射）**让你用「操作对象」的方式读写数据库，由它负责翻译成 SQL 并做结果映射。

人话：SQL 是「寄快递要自己打包填单」，ORM 是「快递上门代打包」——日常小件（CRUD）省心省力；但大宗贵重物品（复杂报表、性能敏感查询），你还是想自己打包（手写 SQL），因为只有你清楚里面每一层怎么保护。

本课以 Node 生态的 Prisma 为主线（类型安全、迁移体验好），对照给出 Java 的 JPA(Hibernate) 和 MyBatis 写法——三大流派：全自动映射（Prisma/JPA）与半自动映射（MyBatis：SQL 自己写、映射它来做）。

先建立图像

ORM 在代码与数据库之间做的事：

你的代码                        ORM 翻译层                     数据库
prisma.note.findMany({    ──▶  SELECT id, title,       ──▶  notes 表
  where: { done: false },      content, author_id
  include: { author: true }    FROM notes
})                             LEFT JOIN users ...
                               WHERE done = false
                          ◀──  组装成嵌套对象  ◀──  行数据
[ { id: 1, title: '...', author: { name: 'alice' } } ]

注意方向：ORM 不是「不用学 SQL」，而是把日常 80% 的样板 SQL 自动化；剩下 20% 复杂查询它照样允许你写原生 SQL。你写的 where/include 最终长成什么 SQL，必须能预判——这是用 ORM 的及格线。

跟着做

步骤 1：初始化 Prisma 项目

前置：本机 PostgreSQL 已运行（第 4 课的 Docker 容器即可）。

mkdir bebg-orm && cd bebg-orm && npm init -y
npm install @prisma/client
npm install -D prisma
npx prisma init          # 生成 prisma/schema.prisma 和 .env

编辑 .env 里的连接串（对应第 4 课的账号密码）：

DATABASE_URL="postgresql://postgres:postgres@localhost:5432/ormdb"

步骤 2：定义模型（schema 即代码）

编辑 prisma/schema.prisma：

generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

model User {
  id        Int      @id @default(autoincrement())
  username  String   @unique
  notes     Note[]              // 一对多：反向引用
  createdAt DateTime @default(now()) @map("created_at")
}

model Note {
  id       Int     @id @default(autoincrement())
  title    String
  content  String  @default("")
  done     Boolean @default(false)
  author   User    @relation(fields: [authorId], references: [id])
  authorId Int     @map("author_id")

  @@index([authorId])     // 外键列建索引——第 5 课的原则这里落地
  @@map("notes")          // 表名映射，默认会是 "Note"
}