Content Relationships 是一项用于指导在无头 CMS 架构中设计和实现内容项之间关系的技能。
【用途】 该技能适用于以下场景:为内容类型添加内容选择器(content picker)字段;设计作者与文章之间的关系;实现相关内容功能;构建内容层级(父/子页面);管理双向关系;在删除时处理引用完整性。相关技能为 content-type-modeling(定义关系字段)、dynamic-schema-design(在 JSON 中存储引用)、headless-api-design(关系 API 端点)。
【关系类型】 技能列出多种关系类型并给出 C# 示例代码:
- 一对多(父引用):例如文章有一个作者,文章持有 AuthorId 外键与 Author 导航属性,作者持有 Articles 反向导航属性。
- 多对多(中间表):例如文章有多个分类、分类有多个文章,通过 ArticleCategory 中间表实现,可包含关系元数据(如 Order、IsPrimary),并给出 EF Core 配置 HasKey。
- 自引用(层级):例如页面层级,Page 持有 ParentId、Parent 导航属性与 Children 集合,并包含用于高效查询的 Path 与 Depth 计算字段。
- 多态引用(任意内容类型):ContentReference 记录引用项与被引用项的 Id 与类型,以及 RelationshipType(如 "related"、"featured"、"see-also")与 Order。
【内容选择器字段模式】 给出通用 ContentPickerField 结构,包含 AllowedContentTypes、ContentItemIds、MinItems、MaxItems、ShowContentType 与 DisplayTemplate,示例存储于 JSON 列。另给出用于 API 的已解析引用结构 ContentPickerFieldDto 与 ContentItemSummary(含 Id、ContentType、DisplayText、Url、ThumbnailUrl)。
【关系加载策略】
- 预加载(Eager Loading):使用 Include 与 ThenInclude 在初始查询中加载关系。
- 显式加载(Explicit Loading):通过 Entry(...).Reference/Collection 按需加载。
- 面向 API 的投影(Projection):使用 Select 仅加载响应所需字段。
【双向关系】 给出 RelatedContent 结构(SourceId、TargetId、RelationType、IsBidirectional)与 ContentRelationshipService 示例,AddRelationshipAsync 在前向关系外可选添加反向关系,GetReverseType 映射关系方向(如 parent-of 对应 child-of,references 对应 referenced-by,对称关系如 related-to 保持不变)。
【引用完整性】
- 删除行为:ReferenceDeleteBehavior 枚举包括 Restrict(被引用时阻止删除)、Cascade(删除引用项)、SetNull(清空引用)、NoAction(保留孤儿,由应用处理),并给出 EF Core OnDelete 配置示例。
- 孤儿检测:OrphanDetectionService 提供 FindOrphanReferencesAsync(查找目标已不存在的引用)与 FindUnreferencedContentAsync(查找未被任何内容引用的内容)。
【关系 API 设计】
- REST 模式:支持 include 查询参数(如 GET /api/articles/{id}?include=author,categories)、嵌套资源(如 /api/articles/{id}/author、/api/authors/{id}/articles)以及关系管理端点(POST/DELETE/PUT 用于 categories 与 author)。示例响应采用 data/relationships/included 结构。
- GraphQL:示例定义了 Article 类型(含 author、categories、relatedArticles(first: Int))以及查询入口与反向查询(articlesByAuthor、articlesByCategory)。
【限制】 资料未提供该技能的收费、价格、平台支持范围或具体安装步骤,暂未提供。