KeystoneJS 关系型数据建模完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00035/article/details/148418311

KeystoneJS 关系型数据建模完全指南

keystone The most powerful headless CMS for Node.js — built with GraphQL and React 项目地址: https://gitcode.com/gh_mirrors/key/keystone

前言

在构建现代应用时，数据之间的关系建模是核心挑战之一。KeystoneJS 作为一款强大的 Headless CMS 系统，提供了灵活的关系型数据建模能力。本文将深入解析 KeystoneJS 中的关系类型、配置方式以及最佳实践，帮助开发者构建高效的数据模型。

关系型数据基础概念

在 KeystoneJS 中，关系指的是不同内容列表之间的连接。理解关系模型需要考虑两个关键问题：

数据访问方向：需要从关系的哪一侧访问数据？
连接数量：关系的每一侧需要多少个连接？

这两个问题分别决定了关系的方向性和基数性。

关系方向性配置

单向关系

单向关系是最简单的配置方式，只需在一侧定义关系字段。例如，在博客系统中，我们可以定义文章(Post)与作者(User)的单向关系：

Post: list({
  fields: {
    title: text(),
    authors: relationship({ ref: 'User', many: true }),
  },
}),

这种配置允许我们查询文章的作者，但无法直接查询某位作者写了哪些文章。

双向关系

双向关系需要在两侧都定义关系字段，并通过ref配置相互引用：

User: list({
  fields: {
    name: text(),
    posts: relationship({ ref: 'Post.authors', many: true }),
  },
}),
Post: list({
  fields: {
    title: text(),
    authors: relationship({ ref: 'User.posts', many: true }),
  },
}),

双向关系的关键点：

两侧的ref必须使用<列表名>.<字段名>格式
虽然定义在两侧，但实际存储的是同一份关系数据
修改一侧的关系会自动反映在另一侧

自引用关系

KeystoneJS 支持列表与自身建立关系，这在社交网络等场景非常有用：

User: list({
  fields: {
    name: text(),
    follows: relationship({ ref: 'User.followers', many: true }),
    followers: relationship({ ref: 'User.follows', many: true }),
  },
}),

注意：KeystoneJS 目前不支持字段直接引用自身（如friends: relationship({ ref: 'User.friends' })）。

关系基数性详解

基数性描述的是关系两侧可以存在的项目数量。KeystoneJS 通过many配置项来控制基数性：

many: false：表示"一对一"关系
many: true：表示"一对多"或"多对多"关系

单向关系基数类型

一对多关系：
- 每篇文章有单个作者
- 每位作者可以有多篇文章

Post: list({
  fields: {
    author: relationship({ ref: 'User', many: false }),
  },
}),

多对多关系：
- 每篇文章可以有多个作者
- 每位作者可以有多篇文章

Post: list({
  fields: {
    authors: relationship({ ref: 'User', many: true }),
  },
}),

双向关系基数类型

一对一关系：
- 每篇文章有单个作者
- 每位作者只能写一篇文章

User: list({
  fields: {
    post: relationship({ ref: 'Post.author', many: false }),
  },
}),
Post: list({
  fields: {
    author: relationship({ ref: 'User.post', many: false }),
  },
}),

一对多关系：
- 每篇文章有单个作者
- 每位作者可以有多篇文章

User: list({
  fields: {
    posts: relationship({ ref: 'Post.author', many: true }),
  },
}),
Post: list({
  fields: {
    author: relationship({ ref: 'User.posts', many: false }),
  },
}),

多对多关系：
- 每篇文章可以有多个作者
- 每位作者可以有多篇文章

User: list({
  fields: {
    posts: relationship({ ref: 'Post.authors', many: true }),
  },
}),
Post: list({
  fields: {
    authors: relationship({ ref: 'User.posts', many: true }),
  },
}),