第 2 章 Apicurio Registry 内容规则

只有在内容添加到 Apicurio Registry 时，才会应用规则。这包括以下 REST 操作：

如果违反了规则，Apicurio Registry 会返回 HTTP 错误。响应正文包括违反的规则，以及显示出错的消息。

特定于工件和全局规则的优先级顺序如下：

每个规则都有一个名称和配置信息。Apicurio Registry 维护每个工件、每个组以及全局规则列表的规则列表。列表中的每一规则均由规则实施的名称和配置组成。

执行规则时，会提供当前工件版本的内容（如果存在）以及正在添加的工件的新版本。规则实现会返回或失败，具体取决于工件是否通过规则。如果没有，Apicurio Registry 会报告 HTTP 错误响应的原因。有些规则可能无法使用之前版本的内容。例如，兼容性规则使用以前的版本，但语法或语义有效规则不会。

管理员可以配置 Apicurio Registry 全局规则、特定于组的规则和特定于工件的规则。开发人员只能配置特定于组的规则，以及特定于工件的规则。

Apicurio Registry 应用为特定工件配置的规则。如果在该级别上没有配置任何规则，则 Apicurio Registry 会应用特定于组的规则。如果在组级别没有配置任何规则，则 Apicurio Registry 会应用全局配置的规则。如果没有配置全局规则，则不应用任何规则。

配置组和工件特定规则

您可以使用 Apicurio Registry web 控制台或 REST API 配置特定于组的规则和特定于工件的规则。详情请查看以下内容：

配置全局规则

管理员可以以多种方式配置全局规则：

apicurio.rules.global.<ruleName>

apicurio.rules.global.<ruleName>

目前支持以下规则名称：

application 属性的值必须是有效的配置选项，它特定于所配置的规则。