解析引用

如果在工具中已完成以下操作，则引用被认为已解析

• 已识别其目标
• 已对目标进行了 OAS 所需的任何修改（例如，由于"$ref" 旁边的字段）
• 已将最终的目标值与引用源以工具在需要时可以轻松使用的方式关联起来

如果引用已被其（可能已修改的）目标替换，则该引用被认为已移除。

引用解析通常会保留引用信息，例如用于识别目标的 URI，而引用移除通常会将其丢弃。在许多情况下，这并不重要，除非不知道解析的 OAD 与 JSON 或 YAML 文档中的引用之间的关系，这可能会使调试变得更加困难。

虽然纯 JSON 文档形成一个 树 结构，但具有解析引用的 OpenAPI 描述不一定是树，而是一个 图。

在内存中解析引用并处理图结构的工具可以处理所有 OAD。依赖于引用移除的工具（无论是作为工具的一部分还是由单独的预处理工具完成），只能支持形成树的 OAD。