跳到主要内容

自定义模型

随着你的应用程序增长，你可能会发现需要将相关逻辑组合在一起。我们建议以下方法：

  • 使用 Prisma Client 扩展创建静态方法
  • 将模型封装在类中
  • 扩展 Prisma Client 模型对象

使用 Prisma Client 扩展的静态方法​

以下示例演示如何创建一个 Prisma Client 扩展，它会向 User 模型添加 signUp 和 findManyByDomain 方法。

import bcrypt from 'bcryptjs'
import { PrismaClient } from '@prisma/client'

const prisma = new PrismaClient().$extends({
  model: {
    user: {
      async signUp(email: string, password: string) {
        const hash = await bcrypt.hash(password, 10)
        return prisma.user.create({
          data: {
            email,
            password: {
              create: {
                hash,
              },
            },
          },
        })
      },

      async findManyByDomain(domain: string) {
        return prisma.user.findMany({
          where: { email: { endsWith: `@${domain}` } },
        })
      },
    },
  },
})

async function main() {
  // Example usage
  await prisma.user.signUp('user2@example2.com', 's3cret')

  await prisma.user.findManyByDomain('example2.com')
}

将模型封装在类中​

在下面的示例中，你将看到如何将 Prisma Client 中的 user 模型封装在一个 Users 类中。

import { PrismaClient, User } from '@prisma/client'

type Signup = {
  email: string
  firstName: string
  lastName: string
}

class Users {
  constructor(private readonly prismaUser: PrismaClient['user']) {}

  // Signup a new user
  async signup(data: Signup): Promise<User> {
    // do some custom validation...
    return this.prismaUser.create({ data })
  }
}

async function main() {
  const prisma = new PrismaClient()
  const users = new Users(prisma.user)
  const user = await users.signup({
    email: 'alice@prisma.io',
    firstName: 'Alice',
    lastName: 'Prisma',
  })
}

使用这个新的 Users 类，你可以定义自定义函数，例如 signup

请注意，在上面的示例中，你只从 Prisma Client 公开了 signup 方法。Prisma Client 被隐藏在 Users 类中，因此你将无法再调用 findMany 和 upsert 等方法。

当你有一个大型应用程序并且希望有意限制模型的功能时，这种方法非常有效。

扩展 Prisma Client 模型对象​

但是，如果你不想隐藏现有功能，但仍然想将自定义功能组合在一起怎么办？在这种情况下，你可以使用 Object.assign 来扩展 Prisma Client 而不限制其功能

import { PrismaClient, User } from '@prisma/client'

type Signup = {
  email: string
  firstName: string
  lastName: string
}

function Users(prismaUser: PrismaClient['user']) {
  return Object.assign(prismaUser, {
    /**
     * Signup the first user and create a new team of one. Return the User with
     * a full name and without a password
     */
    async signup(data: Signup): Promise<User> {
      return prismaUser.create({ data })
    },
  })
}

async function main() {
  const prisma = new PrismaClient()
  const users = Users(prisma.user)
  const user = await users.signup({
    email: 'alice@prisma.io',
    firstName: 'Alice',
    lastName: 'Prisma',
  })
  const numUsers = await users.count()
  console.log(user, numUsers)
}

现在你可以使用自定义的 signup 方法以及 count、updateMany、groupBy() 以及 Prisma Client 提供的所有其他出色方法。最重要的是，它们都是类型安全的！

更进一步​

我们建议使用 Prisma Client 扩展来扩展你的模型，增加自定义模型方法。