1.2. Apicurio Registry 中的 schema 和 API 工件

工件版本

每个工件都由零个或多个 _artifact version_s 组成。只有工件版本具有实际内容（以及元数据）。这些版本代表工件内容的演进，并且是不可变的。您可以将 Artifact 视为一系列版本，通常使用代表"current"模式或 API 设计内容的最新版本。

工件版本具有元数据，它们都生成且可编辑。工件版本的标准元数据包括（但不仅限于）：

模式和 API 组

工件组是 schema 或 API 工件的可选命名集合。每个组都包含一组逻辑相关的模式或 API 设计，通常由单个实体管理，这些实体属于特定的应用程序或组织。

在添加 schema 和 API 设计时，您可以创建可选工件组，以便在 Apicurio Registry 中组织它们。例如，您可以创建组来匹配 development 和 production 的应用程序环境，或 sales 和 engineering 机构。

schema 和 API 组可以包含多个工件类型。例如，您可能具有 Protobuf、Avro、JSON Schema、OpenAPI 或 AsyncAPI 工件。

组具有元数据，包括生成和可编辑的元数据。组的标准元数据包括（但不仅限于）：

您可以使用 Apicurio Registry web 控制台、REST API、命令行、Maven 插件或 Java 客户端应用程序创建 schema 和 API 工件和组。

对其他模式和 API 的引用

一些 Apicurio Registry 工件类型可以包含从一个 工件文件到另一个工件的工件引用。您可以通过定义可重复使用的模式或 API 组件来创建效率，然后从多个位置引用它们。例如，您可以使用 $ref 语句在 JSON Schema 或 OpenAPI 中指定引用，或使用 导入 声明在 Google Protobuf 中指定引用，或使用嵌套命名空间在 Apache Avro 中指定引用。

以下示例显示了一个名为 TradeKey 的简单 Avro 模式，其中包含使用嵌套命名空间对另一个名为 Exchange 的 schema 的引用：

{
 "namespace": "com.kubetrade.schema.trade",
 "type": "record",
 "name": "TradeKey",
 "fields": [
   {
     "name": "exchange",
     "type": "com.kubetrade.schema.common.Exchange"
   },
   {
     "name": "key",
     "type": "string"
   }
 ]
}

{
 "namespace": "com.kubetrade.schema.trade",
 "type": "record",
 "name": "TradeKey",
 "fields": [
   {
     "name": "exchange",
     "type": "com.kubetrade.schema.common.Exchange"
   },
   {
     "name": "key",
     "type": "string"
   }
 ]
}

{
 "namespace": "com.kubetrade.schema.common",
 "type": "enum",
 "name": "Exchange",
 "symbols" : ["GEMINI"]
}

{
 "namespace": "com.kubetrade.schema.common",
 "type": "enum",
 "name": "Exchange",
 "symbols" : ["GEMINI"]
}

工件引用存储在 Apicurio Registry 中，作为工件元数据的集合，这些元数据从特定于工件类型的引用映射到内部 Apicurio Registry 引用。Apicurio Registry 中的每个工件引用都包含以下内容：

您可以使用 Apicurio Registry core REST API、Maven 插件和 Java serializers/deserializers (SerDes)管理工件引用。Apicurio Registry 存储工件引用以及工件内容。Apicurio Registry 还维护所有工件引用的集合，以便您可以搜索或列出特定工件的所有引用。

支持的工件类型

Apicurio Registry 目前仅支持以下工件类型引用：