Koa + Prisma 快速入门

本文展示了如何使用Koa和Prisma在MySQL中实现CRUD操作,包括项目初始化、模型设计和API编写。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

10分钟掌握 Koa + Prisma 实现数据库 CRUD

前言

Prisma 是号称下一代的 ORM 工具,同样是基于 TypeScript 实现,但是带来了很强的类型安全。

本文使用 Koa.js 搭建一个简单的 Web 服务,配合 MySQL 数据库,来演示如何通过 Prisma 实现数据的增删改查。

Prisma

Prisma 是号称下一代的 ORM 工具,下面是 Prisma 中文网站,可以说是技术类网站中相当优秀的中文站了:

image-20230509200931239

Prisma 是一个开源的数据库工具链项目,不仅仅是一个简单的 ORM 工具。它支持的数据库有 PostgreSQL、MySQL、MongoDB、SQL Server和SQLite,本文以 MySQL 进行演示。

在使用方式上,对于第一次接触它的人来讲,稍微有些繁琐。我总结了以下几个流程:

  • 安装依赖
  • 初始化 Prisma 项目
  • 设计 Prisma Schema(数据库信息和模型)
  • 同步到数据库
  • 生成 Prisma Client
  • 使用 Prisma Client 完成 CRUD

下面我们先去创建一个开发环境,再回过头来继续介绍 Prisma。

初始化环境

使用 Koa 快速搭建一个 Web 服务,首先创建目录,并安装依赖:

$ mkdir koa-prisma
$ cd koa-prisma
$ pnpm init

# 安装 Koa 依赖
$ pnpm add koa @koa/router koa-bodyparser
  • @koa/router:路由中间件,方便集成路由功能
  • koa-bodyparser:解析请求体数据,并放到 ctx.request.body 对象上

然后新建一个 index.js,完成一个简单的 Web 服务:

const Koa = require('koa')
const Router = require('@koa/router')
const bodyParser = require('koa-bodyparser')

const app = new Koa()

// 实例化路由器,并设置公共路由前缀 /users
const router = new Router({
  prefix: '/users'
})

app.use(bodyParser())

// 查询用户列表
router.get('/', async ctx => {
 
})

// 查询单个用户
router.get('/:id', async ctx => {
 
})

// 创建用户
router.post('/', async ctx => {

})

// 更新用户
router.patch('/:id', async ctx => {

})

// 删除用户
router.delete('/:id', async ctx => {

})

// 注册路由中间件
app.use(router.routes()).use(router.allowedMethods())

app.listen(3000, () => {
  console.log('服务器运行在 3000 端口')
})

在上面代码中,定义了5个路由方法,分别对应了数据库的查询、插入、更新和删除操作。稍后完成 Prisma 的初始化,将 Prisma Client 引入,就能实现这几个接口了。

然后使用 nodemon 命令来启动服务,最好是在全局安装此模块,方便使用:

$ nodemon src/index.js

Prisma CLI

首先安装下 Prisma 的两个依赖模块:

$ pnpm add -D prisma 
$ pnpm add @prisma/client

安装的第一个 prisma,它是一个 CLI 命令,主要通过它来调用 Prisma 的各种功能,包括数据库迁移,创建Prisma Client 等等。

执行下面的命令,看一下 prisma 的使用说明:

$ npx prisma --help

image-20230509194858894

可以看到,prisma 提供了 7 个命令:

命令说明
init在应用中初始化 Prisma
generate主要用来生成 Prisma Client
db管理数据库的模式和生命周期
migrate迁移数据库
studio启动一个Web 端的工作台来管理数据
validate检查 Prisma 的模式文件的语法是否正确
format格式化Prisma的模式文件,默认就是 prisma/schema.prisma

并且还给出了示例,我们这里主要使用其中的三个,剩下的大家可以自己去使用看看效果:

image-20230509195654406

初始化 Prisma

执行下面的命令,完成初始化:

$ npx prisma init

image-20230509220945387

这个命令的效果是在命令所在目录,也就是现在的根目录中,创建一个 .env 文件,一个 prisma 目录,并在此目录下创建 schema.prisma 文件,如下:

image-20230509195929494

对于 .env 文件,大家都不会陌生,就是一个放置环境变量的文件,这里面的环境变量通常是一些配置信息。

prisma 目录,用来存放和 Prisma 相关的文件,目前只有一个 schema.prisma 文件,这个文件就是前面提及过的 Prisma 模式文件,我们会在此文件中定义数据库的连接信息和模型。

设计 Prisma Schema

schema.prisma 是使用 Primsa 的主要配置文件,称之为 Prisma schema 文件,它包含三个基本结构:

  • 数据源

  • 生成器

  • 数据模型定义

安装 VSC 插件

在编辑模式文件前,在 VS Code 中安装 Prisma 插件,它针对 .prisma 文件提供了代码高亮、格式化、自动补全、跳转定义和检查的功能。没有这个插件的加持,模式文件就是一个纯文本。

image-20230507161551169

设置生成器

使用 generate 定义生成器,通过 provider 属性声明为 prisma-client-js(目前也只支持这一种)。当执行 prisma generate 命令时就会生成 Prisma Client,使用它完成数据的增删改查。

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

设置数据源

使用 datasource 是定义数据源,用来设置 Prisma 连接的数据库所需要的一些信息。provider 是连接到的数据库的类型,默认是 postgresql,我们改为要用到的 mysql。 url 是数据库URL,通常为了保持配置分离,会将其单独定义到一个环境变量文件中,也就是 prisma cli 自动生成的 .env 文件。通过 env() 函数,会去读取此文件中的变量。

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

看一下 .env 文件,默认连接的是 Postgresql:

DATABASE_URL=postgresql://johndoe:mypassword@localhost:5432/mydb?schema=public

这是一个 数据库连接 URL的组成:

Structure of the MySQL connection URL

下面都是必填项:

名称占位符描述
HostHOST数据库 IP 或域名, 例如 localhost
PortPORT数据库端口, 例如 3306
UserUSER数据库用户名, 例如 root
PasswordPASSWORD数据库密码
DatabaseDATABASE数据库名称,例如 mydb

根据这个说明,定义我们自己的 MySQL URL:

DATABASE_URL="mysql://root:root123@localhost:3306/prisma"

定义 User 模型

作为 ORM 工具,肯定少不了模型了。Prisma 的模型主要有以下作用:

  • 构成了应用领域的 实体
  • 映射到数据库的 (关系型数据库,例如 PostgreSQL)或 集合 (MongoDB)
  • 构成 Prisma Client API查询 的基础
  • 在使用 TypeScript 时,Prisma Client 为模型及其 变体 提供 类型定义,保证数据库访问的类型安全

定义模型时会用到形如 @id()@default() 这些 Prisma 内置的工具函数。比如 @id() 用来声明主键,@default() 用来设置默认值,命名都非常语义化,基本就是 SQL 中的一些关键字,非常容易理解。

下面是一个 User 模型的定义:

model User {
  id          Int      @id @default(autoincrement())
  name        String   
  email       String   @unique
  password    String
  createdTime DateTime @default(now()) @map("created_time")
  updatedTime DateTime @updatedAt @map("updated_time")

  @@map("user")
}

需要说明的几点信息:

1.模型的名字默认就是创建的数据表的名字,这里是大写的 User,那么数据表名也就是大写的 User,可以使用 @@map() 来设置映射的表名,改为小写的 user。

2.每个模型的记录都是唯一可识别的,也就是要有主键,可以使用 @id 去声明。

3.字段的类型,比如 Int,String,会经过Prisma 转为数据库对应的类型,也就是 int 和 varchar。

4.@unique 是唯一值约束,所以生成的 user 表的 email 字段的值不能重复。

5.像是创建时间和更新时间,为了符合 JS、TS 中的命名规范,使用了小驼峰命名,为了符合数据库命名规范,在后面使用 @map() 重新映射为了下划线命名。

同步数据库

将Prisma 模型同步到数据库,对于我们这样一个新项目,空项目,可以使用下面的命令:

$ npx prisma db push

如果是一个已经有数据的项目,就不能使用这个命令了,转而使用 prisma migrate 迁移。本文先不涉及。

image-20230509213137705

它会创建数据库的schema,并且使用 Prisma schema 同步数据库,还会“偷偷”执行下 prisma generate 命令来生成 Prisma Client。

来到数据库,刷新一下,已经创建好了 prisma 数据库和一张 user 表:

image-20230509213437412

生成 Prisma client

前面同步数据库时,已经执行了 prisma generate。所以现在不需要再次执行了,但是一旦Prisma Schema 文件发生了变动,比如修改了模型,就需要再来执行下这个命令,重新生成 Prisma Client。

generate 命令执行的流程是:

img

CRUD 增删改查

初始化 Prisma Client

有了 Prisma Client,可以使用它来执行 CRUD 操作。初始化:

const { PrismaClient } = require('@prisma/client')

const prisma = new PrismaClient()

Prisma Client 的实例 prisma ,具备丰富的类型,使用方式是 prisma.模型.CRUD方法

image-20230509214952783

image-20230509215012306

我们先来介绍几个常用的 API:

  • findMany:查询多条记录
  • findUnique:查询单条记录
  • create:创建记录
  • update:更新记录
  • delete:删除记录

使用这几个 API 在路由方法中操作数据库,完成接口的开发。

查询用户列表

findMany 不传入参数,表示查询整张 user 表的所有记录,它返回的是一个数组,是 User 模型的实例集合:

router.get('/', async ctx => {
  const users = await prisma.user.findMany()

  ctx.body = users
})

查询单个用户

findUnique 方法中通过 where 设置查询条件,也就是根据指定的 ID 来查询一条用户记录,该方法只返回一条记录,也就是 User 模型的一个实例:

// 查询单个用户
router.get('/:id', async ctx => {
  const id = parseInt(ctx.params.id)
  const user = await prisma.user.findUnique({
    where: { id }
  })

  ctx.body = user
})

需要注意的一点,从 ctx.params.id 获取的 id 是字符串类型,要转为整数类型再去查询。

创建用户

使用 create 可以插入数据,将从请求体中解析的数据,也就是描述 User模型 的一个对象赋值给 data 属性即可:

router.post('/', async ctx => {
  const user = ctx.request.body
  const newUser = await prisma.user.create({
    data: user
  })

  ctx.body = newUser
})

更新用户

使用 update 方法,通过 where 设置查询条件,查询到一个用户,再将待更新的数据赋值给 data完成更新:

router.patch('/:id', async ctx => {
  const id = parseInt(ctx.params.id)
  const updateUser = ctx.request.body

  const user = await prisma.user.update({
    where: {
      id
    },
    data: updateUser
  })

  ctx.body = user
})

删除用户

使用 delete 方法,直接通过 where 设置删除记录的查询条件即可:

router.delete('/:id', async ctx => {
  const id = parseInt(ctx.params.id)
  const user = await prisma.user.delete({
    where: {
      id
    }
  })

  ctx.body = user
})

注意事项:使用 update 和 delete 时,一定要设置where,否则会更新或者删除数据表的所有记录,非常危险。

测试

创建用户:

image-20230509215720849

查询用户列表:

image-20230509215836753

更新用户:

image-20230509215918093

删除用户:

image-20230509215939149

总结

完整代码在这里

本文通过一个用户的增删改查的例子,在 Koa 中演示了 Prisma 的基本使用,在此总结一下:

  1. 安装依赖
  2. 初始化 Prisma
  3. 设置 Prisma Schema
  4. 同步数据库
  5. 创建Prisma Client
  6. 使用 Prisma Client 实现 CRUD

Prisma 还有很多优秀的特性,本文抛砖引玉,只介绍了最基本的使用,一个单表的增删改查。推荐大家去阅读中文文档站点了解更多关于 Prisma 的内容。

感谢阅读!

<think>嗯,用户想用Node.js写后端代码,让我推荐一个框架。首先,我得想想Node.js有哪些流行的后端框架。Express.js应该是最常用的,对吧?不过最近也有其他框架比如Koa、Nest.js、Fastify之类的。用户可能对Node.js有一定了解,但可能不太清楚各个框架的区别和适用场景。 首先,我需要确定用户的背景。可能是刚入门的开发者,或者有一定经验想换框架的人。如果是新手,推荐Express.js可能更合适,因为它的学习曲线低,社区支持好。但如果是需要构建大型企业级应用,可能需要更结构化的框架,比如Nest.js。 然后,用户的需求可能包括易用性、性能、可扩展性、社区支持等。Express.js虽然灵活,但缺乏内置的结构,容易导致代码混乱。而Nest.js基于TypeScript,使用模块化设计,适合大型项目,但学习成本较高。Koa是Express团队的新作,更轻量,中间件更现代,但可能需要自己集成更多东西。 Fastify强调性能,适合对速度要求高的场景。还有像Egg.js,基于Express,适合企业级应用,但可能在国内更流行。用户可能不知道这些框架的特点,需要逐一分析优缺点。 另外,用户可能需要考虑是否使用TypeScript,Nest.js和Fastify都支持TS,而Express需要额外配置。如果项目需要TypeScript,这可能是一个考虑因素。 可能用户没有提到的需求还有是否需要ORM集成,比如Prisma或TypeORM,某些框架可能更容易整合这些工具。例如,Nest.js有良好的集成支持。 还要考虑社区和文档,Express有最庞大的社区,遇到问题容易找到解决方案。Nest.js虽然较新,但社区增长快,文档齐全。Fastify的文档也不错,但相对较新,资源可能少一些。 用户可能也需要考虑中间件的丰富性,Express有大量现成中间件可用,而其他框架可能需要更多自定义。 总结的话,应该分几个主要框架,介绍它们的优缺点,适用场景,并给出推荐建议。比如,对于小型或快速开发的项目推荐Express,大型复杂应用推荐Nest.js,高性能需求选Fastify,中间件灵活用Koa,国内企业可能选Egg.js。 还要提醒用户根据具体项目需求选择,比如团队熟悉度、项目规模、性能要求等。可能最后给出一个对比表格会更清晰,但用户要求用中文回答,所以用文字描述即可。 需要确保信息准确,比如Nest.js是否真的使用TypeScript,以及各框架的最新版本情况。比如,Express目前的版本是4.x,Koa是2.x,Nest.js已经比较成熟了。 最后,可能需要提到一些实际案例,比如大公司在用哪些框架,增强推荐的可信度。例如,Express被很多公司广泛使用,Nest.js被Adidas用到等。 总之,结构应该是先概述,然后分点介绍每个框架,最后总结推荐,根据场景给出建议。</think>在 Node.js 后端开发中,选择合适的框架取决于项目的规模、团队经验以及具体需求。以下是几个主流框架的推荐及分析,帮助你做出决策: --- ### **1. Express.js** **特点**: - **最经典、社区最成熟**:Node.js 生态的基石,拥有海量中间件(如路由、身份验证等)。 - **轻量灵活**:无强制架构,适合快速开发和小型项目。 - **学习成本低**:适合新手快速上手。 **适用场景**: - 中小型项目、API 服务、快速原型开发。 - 需要高度自定义架构的团队。 **示例代码**: ```javascript const express = require('express'); const app = express(); app.get('/', (req, res) => res.send('Hello World!')); app.listen(3000); ``` --- ### **2. NestJS** **特点**: - **企业级框架**:基于 TypeScript,采用模块化设计(类似 Angular),内置依赖注入、微服务支持等。 - **结构化清晰**:强制分层架构(Controller/Service/Module),适合大型项目维护。 - **生态丰富**:集成 TypeORM、GraphQL、WebSocket 等工具。 **适用场景**: - 中大型复杂应用、需要长期维护的企业级项目。 - 团队熟悉 TypeScript 或 Angular 技术栈。 **示例代码**: ```typescript import { Controller, Get } from '@nestjs/common'; @Controller() export class AppController { @Get() getHello(): string { return 'Hello World!'; } } ``` --- ### **3. Koa.js** **特点**: - **由 Express 原班人马打造**:更轻量、中间件机制更现代(基于 `async/await`)。 - **错误处理更友好**:通过 `try/catch` 捕获异步错误。 - **自由度较高**:需自行选择中间件(如路由需用 `koa-router`)。 **适用场景**: - 需要更高灵活性和现代异步流程控制的项目。 - 开发者希望摆脱 Express 的历史包袱。 **示例代码**: ```javascript const Koa = require('koa'); const app = new Koa(); app.use(async ctx => ctx.body = 'Hello World!'); app.listen(3000); ``` --- ### **4. Fastify** **特点**: - **高性能**:号称比 Express 快 2 倍,底层优化出色。 - **JSON Schema 驱动**:自带请求/响应数据验证。 - **插件化设计**:通过插件扩展功能,生态活跃。 **适用场景**: - 高并发、低延迟的 API 服务。 - 需要数据验证和严格类型约束的场景。 **示例代码**: ```javascript const fastify = require('fastify')(); fastify.get('/', async (request, reply) => 'Hello World!'); fastify.listen(3000); ``` --- ### **5. Egg.js**(国内流行) **特点**: - **基于 Koa**:由阿里团队开发,约定优于配置,内置多进程管理、插件机制等。 - **企业级开箱即用**:适合快速构建标准化应用。 **适用场景**: - 国内团队的中大型项目,尤其是需要遵循统一规范的企业。 --- ### **如何选择?** - **新手入门/快速开发**:选 **Express** 或 **Koa**。 - **大型企业应用**:选 **NestJS** 或 **Egg.js**。 - **极致性能需求**:选 **Fastify**。 - **现代异步与中间件控制**:选 **Koa**。 ### **附加建议** - 如果使用 **TypeScript**,优先考虑 NestJS 或 Fastify。 - 需要微服务、GraphQL 等高级功能时,NestJS 的集成度更高。 希望这些分析能帮助你找到合适的框架! 🚀
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

昆吾kw

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值