JSON-LD 1.1 框架化

4.1.1 概述

有效的 JSON-LD 框架是有效 JSON-LD 文档的超集， 允许附加内容，并且这些内容会在展开过程中保留。 JSON-LD 1.1 语法规范 [JSON-LD11] 中定义的语法 扩展如下：

• 框架化添加框架化 关键字，这些关键字可以用作条目，位于节点对象中，并且在展开时必须保留。
• 框架对象中不是 关键字的 条目值也可以包含默认对象。 @default 的值可以包括值 @null， 或者除了键展开为 IRI 的 条目值在语法中允许的其他值以外， 包含仅有 @null 的数组。 处理器必须在展开时保留此值。 默认 对象的所有其他条目必须被忽略。
• @id 和 @type 的值也可以是空映射、 IRI 引用、 仅包含空映射的 数组、 或 IRI 引用数组。 @type 的值也可以 是带有 @default 条目的映射， 其值被限制为 IRI。 处理器必须在展开时保留此值。
• 框架化要么作用于输入文档中包含的合并节点定义， 要么作用于默认图， 这取决于 输入框架是否在顶层包含 @graph 条目。 对于主体同时也是命名 图的节点， 如果框架对象 包含 @graph，则会将框架化 扩展到关联命名图中的节点 对象。

4.1.2 算法

框架化算法接受 五个必需输入变量和一个可选输入变量。 必需输入包括 框架化状态 （state）、 要框架化的 subjects 列表、 输入框架 （expanded frame）、 用于收集部分框架结果的 parent， 以及 active property。 可选输入变量是 ordered 标志。

该算法向 parent 添加元素：如果它是数组，则将元素追加到 parent；如果它是映射， 则将元素追加到 parent 中与 active property 关联的数组。 请注意，如果 parent 是数组，则 active property必须为 null， 而如果它是映射， 则它不得为 null。

1. 如果 frame 是数组，则将 frame 设置为该 数组的值，该值必须是有效框架。 如果确定 frame 无效， 则检测到invalid frame 错误并中止处理。
   1. Frame必须是映射。
   2. 如果 frame 具有 @id 条目，其值必须为以下之一： 包含单个空映射作为值的 数组、 有效IRI， 或者所有值均为有效IRI的数组。
   3. 如果 frame 具有 @type 条目，其值必须为以下之一： 包含单个空映射作为值的 数组、 包含一个映射的 数组，该映射具有键为 @default 的条目、 有效IRI， 或者所有值均为有效IRI的数组。
2. 从 state 中的 对象嵌入标志、 显式 包含标志和 要求全部标志 初始化标志 embed、explicit 和 requireAll， 并用 frame 中 @embed、@explicit 和 @requireAll 的任何属性值覆盖。
3. 通过使用框架匹配算法 以 state、subjects、frame 和 requireAll 对 subjects 按 frame 进行过滤， 创建匹配主体列表。
4. 对于匹配主体集合中的每个 id 和关联的节点对象 node， 如果可选 ordered 标志为 true，则按 id 的字典序排序：
   1. 将 output 初始化为一个新的映射，带有 @id 和 id。
   2. 如果 state 中的嵌入标志为 false， 并且在 state 中存在与 graph name 和 id 关联的已嵌入节点， 则不再对此 node 执行额外处理。
   3. 否则，如果 state 中的嵌入标志为 true， 且 embed 为 @never，或者嵌入会创建循环引用， 则将 output 添加到 parent， 并不再对此 node 执行额外处理。
   4. 否则，如果 state 中的嵌入标志为 true， embed 为 @once， 并且在 state 中存在与 graph name 和 id 关联的已嵌入节点， 则将 output 添加到 parent， 并不再对此 node 执行额外处理。
   5. 如果 state 中的 graph map 具有 id 的条目：
      1. 如果 frame 没有 @graph 条目， 则将 recurse 设置为 true，除非 state 中的 graph name 是 @merged， 并将 subframe 设置为新的空映射。
      2. 否则，将 subframe 设置为 frame 中 @graph 的第一个条目， 或者在其不存在时设置为新的空映射，并 将 recurse 设置为 true，除非 id 是 @merged 或 @default。
      3. 如果 recurse 为 true：
         1. 将 state 中 graph name 的值设置为 id。
         2. 将 state 中嵌入标志的值设置为 false。
         3. 调用该算法， 使用 state 的副本， 其中 graph name 的值设置为 id， 嵌入标志的值设置为 false； 将 state 中与 id 关联的 graph map 的键作为 subjects， subframe 作为 frame， output 作为 parent，并将 @graph 作为 active property。
   6. 如果 frame 具有 @included 条目， 则调用该算法， 使用 state 的副本，其中嵌入标志的值设置为 false， subjects、frame、 output 作为 parent，并将 @included 作为 active property。
   7. 对于 node 中的每个 property 和 objects， 如果可选 ordered 标志为 true，则按 property 的字典序排序：
      1. 如果 property 是关键字，则将 property 和 objects 添加到 output。
      2. 否则，如果 property 不在 frame 中，并且 explicit 为 true， 处理器 不得向 output 添加 property 的任何值，并跳过以下 步骤。
      3. 对于 objects 中的每个 item：
         1. 如果 item 是具有 @list 属性的映射，则按顺序处理列表中的每个 listitem，并添加到输出中的新列表映射：
            1. 如果 listitem 是节点 引用， 则调用该算法， 使用 state 的副本，其中 嵌入标志的值设置为 true， 将 listitem 中 @id 的值 作为新 subjects 数组中的唯一项， 将 frame 中 @list 的第一个值作为 frame， list 作为 parent，并将 @list 作为 active property。 如果 frame 不存在，则使用新的映射 创建新的 frame，其中 @embed、@explicit 和 @requireAll 的属性 取自 embed、explicit 和 requireAll。
            2. 否则，将 listitem 的副本追加到 list 中的 @list。
         2. 如果 item 是节点 引用， 则调用该算法， 使用 state 的副本，其中 嵌入标志的值设置为 true， 将 item 中 @id 的值 作为新 subjects 数组中的唯一项， 将 frame 中 property 的第一个值作为 frame， output 作为 parent，并将 property 作为 active property。 如果 frame 不存在，则使用 新的映射 创建新的 frame， 其中 @embed、@explicit 和 @requireAll 的属性 取自 embed、explicit 和 requireAll。
         3. 否则，将 item 的副本追加到 output 中的活动 属性。
      4. 对于 frame 中每个非关键字 的 property 和 objects （除 `@type 外） 且该 property 不在 output 中：
         1. 令 item 为 objects 中的第一个值，该值必须是框架对象。
         2. 将 property frame 设置为 objects 中的第一个值， 或者如果值为 objects，则设置为新创建的框架对象。 property frame必须 是映射。
         3. 如果 property frame 包含 值为 true 的 @omitDefault， 或者不包含 @omitDefault 且 state 中 省略默认值标志的值为 true， 则跳过 property 和 property frame。
         4. 向 output 添加 property，其值为 一个新的映射， 该映射具有 @preserve 属性，其值是 frame 中 @default 的值的副本（如果存在）， 否则为字符串 @null。
      5. 如果 frame 具有属性 @reverse，则 对于 frame 中 @reverse 值中的每个 reverse property 和 sub frame：
         1. 在 output 中创建一个 @reverse 属性，其值为新的 映射 reverse dict。
         2. 对于扁平化主体映射中的每个 reverse id 和 node，若其具有 属性 reverse property，且该属性包含一个 @id 为 id 的节点 引用：
            1. 向 reverse dict 添加 reverse property， 其值为一个新的空数组。
            2. 调用该算法， 使用 state 的副本，其中 嵌入标志的值设置为 true， 将 reverse id 作为新 subjects 数组中的唯一项， sub frame 作为 frame， null 作为 active property， 并将 reverse dict 中 reverse property 的 数组值作为 parent。
      6. 一旦在前面步骤中按要求设置了 output， 则将 output 添加到 parent。