Deno GRAPHQL Backend

Deno GraphQL 后端开发

三层架构

src/{module}/{feature}/
├── {feature}.graphql.ts   # Schema 定义
├── {feature}.resolver.ts  # 参数处理、事务/认证设置
└── {feature}.service.ts   # 业务逻辑、调用 DAO

快速模板

1. GraphQL Schema

import { defineGraphql } from "/lib/context.ts";
import * as resolver from "./{feature}.resolver.ts";

defineGraphql(resolver, /* GraphQL */ `
  type {Feature}Model { id: {Feature}Id!, lbl: String! }
  input {Feature}Input { lbl: String! }
  input {Feature}Search { lbl: String }
  
  type Query {
    "查询" get{Feature}(id: {Feature}Id!): {Feature}Model
    "列表" findAll{Feature}(search: {Feature}Search): [{Feature}Model!]!
  }
  
  type Mutation {
    "创建" create{Feature}(input: {Feature}Input!): {Feature}Id!
    "更新" update{Feature}(id: {Feature}Id!, input: {Feature}Input!): Boolean!
    "删除" delete{Feature}(ids: [{Feature}Id!]!): Int!
  }
`);

2. Resolver

import { useContext } from "/lib/context.ts";
import type { {Feature}Id, {Feature}Input, {Feature}Search } from "/gen/types.ts";

// 查询 - 不需要事务
export async function get{Feature}(id: {Feature}Id) {
  const { get{Feature} } = await import("./{feature}.service.ts");
  return await get{Feature}(id);
}

// 修改 - 需要事务
export async function create{Feature}(input: {Feature}Input) {
  const { create{Feature} } = await import("./{feature}.service.ts");
  const context = useContext();
  context.is_tran = true;  // 增删改必须设置
  return await create{Feature}(input);
}

3. Service

import { isEmpty } from "/lib/util/string_util.ts";
import { findById{Feature}, create{Feature} as createDao } from "/gen/{module}/{feature}/{feature}.dao.ts";
import type { {Feature}Id, {Feature}Input } from "/gen/types.ts";

export async function create{Feature}(input: {Feature}Input) {
  if (isEmpty(input.lbl)) throw "名称不能为空";  // 业务错误用中文
  return await createDao(input);
}

4. 注册模块

在 src/{module}/graphql.ts 添加：

import "./{feature}/{feature}.graphql.ts";

核心规则

详细参考

• DAO 函数 - 查询/创建/更新/删除函数
• 认证权限 - 用户获取、权限检查、数据隔离
• 架构约定 - 目录结构、命名规范