使用Prisma构建Hapi GraphQL服务器全指南

松俭格

于 2025-06-07 09:00:09 发布

阅读量338

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00453/article/details/148486959

使用Prisma构建Hapi GraphQL服务器全指南

prisma-examples 🚀 Ready-to-run Prisma example projects 项目地址: https://gitcode.com/gh_mirrors/pr/prisma-examples

项目概述

本文将详细介绍如何使用Prisma生态系统构建一个基于Hapi框架的GraphQL服务器。该项目展示了现代Node.js后端开发的完整技术栈，包括：

Hapi：一个注重安全性和可扩展性的Node.js Web框架
Apollo Server：用于Hapi的GraphQL服务器集成
GraphQL Nexus：用于定义GraphQL模式和实现解析器
Prisma Client：类型安全的数据库访问ORM工具
Prisma Migrate：数据库迁移工具
SQLite：轻量级文件数据库（可轻松切换为其他数据库）

环境准备与项目初始化

1. 创建项目结构

首先需要创建一个新的项目目录并初始化必要的依赖。项目将使用TypeScript作为开发语言，确保开发体验的类型安全性。

2. 数据库配置

默认使用SQLite作为开发数据库，配置位于prisma/schema.prisma文件中：

datasource db {
  provider = "sqlite"
  url      = "file:./dev.db"
}

如需切换为其他数据库（如PostgreSQL、MySQL等），只需修改provider和url配置即可。

核心功能实现

1. 数据模型定义

在Prisma schema中定义了两个主要模型：

model User {
  id      Int      @default(autoincrement()) @id
  name    String?
  email   String   @unique
  posts   Post[]
}

model Post {
  id        Int      @id @default(autoincrement())
  title     String
  content   String?
  published Boolean  @default(false)
  viewCount Int      @default(0)
  author    User?    @relation(fields: [authorId], references: [id])
  authorId  Int?
}

2. GraphQL模式构建

使用GraphQL Nexus构建GraphQL模式，主要包含：

查询类型(Query)：实现数据获取接口
变更类型(Mutation)：实现数据修改接口
自定义类型：定义User、Post等数据模型

3. 解析器实现

解析器函数使用Prisma Client与数据库交互，例如获取所有已发布文章的解析器：

t.nonNull.list.nonNull.field('feed', {
  type: 'Post',
  resolve: (_parent, _args, context) => {
    return context.prisma.post.findMany({
      where: { published: true },
    })
  },
})

开发工作流程

1. 数据库迁移

当数据模型变更时，使用Prisma Migrate进行数据库迁移：

npx prisma migrate dev --name add_new_feature

2. 数据种子

项目包含种子脚本，可初始化测试数据：

// prisma/seed.ts
async function main() {
  const user1 = await prisma.user.create({
    data: {
      email: 'alice@prisma.io',
      name: 'Alice',
      posts: {
        create: {
          title: 'Hello World',
          content: 'This is my first post',
          published: true,
        },
      },
    },
  })
}

3. 开发服务器

启动开发服务器：

npm run dev

服务器将在http://localhost:4000/graphql提供GraphQL Playground界面。

API使用示例

基本查询

获取所有已发布的文章及其作者：

query {
  feed {
    id
    title
    author {
      name
    }
  }
}

数据变更

创建新用户：

mutation {
  signupUser(data: { name: "Bob", email: "bob@example.com" }) {
    id
    name
  }
}

创建草稿文章：

mutation {
  createDraft(
    data: { title: "New Post", content: "Post content" }
    authorEmail: "bob@example.com"
  ) {
    id
    title
  }
}

项目演进

添加新功能

以添加用户资料(Profile)功能为例：

更新数据模型：在schema.prisma中添加Profile模型
执行迁移：生成并应用迁移文件
更新GraphQL模式：添加Profile类型和相关解析器

示例：添加Profile功能

修改Prisma schema：

model Profile {
  id     Int     @id @default(autoincrement())
  bio    String?
  user   User    @relation(fields: [userId], references: [id])
  userId Int     @unique
}

添加GraphQL类型和解析器：

const Profile = objectType({
  name: 'Profile',
  definition(t) {
    t.nonNull.int('id')
    t.string('bio')
    t.field('user', {
      type: 'User',
      resolve: (parent, _, context) => {
        return context.prisma.profile
          .findUnique({ where: { id: parent.id } })
          .user()
      },
    })
  },
})