8.2. Service Registry serializer/deserializer 配置属性

SCHEMA_RESOLVER

apicurio.registry.schema-resolver

被序列化和反序列化器使用。实施 SchemaResolver 的完全限定 Java 类名称。

字符串

io.apicurio.registry.resolver.DefaultSchemaResolver

REGISTRY_URL

apicurio.registry.url

被序列化和反序列化器使用。用于访问 registry API 的 URL。

字符串

无

AUTH_SERVICE_URL

apicurio.auth.service.url

被序列化和反序列化器使用。身份验证服务的 URL。在使用 OAuth 客户端凭证流访问安全 registry 时，需要此项。

字符串

无

AUTH_REALM

apicurio.auth.realm

被序列化和反序列化器使用。访问身份验证服务的域。在使用 OAuth 客户端凭证流访问安全 registry 时，需要此项。

字符串

无

AUTH_CLIENT_ID

apicurio.auth.client.id

被序列化和反序列化器使用。用于访问身份验证服务的客户端 ID。在使用 OAuth 客户端凭证流访问安全 registry 时，需要此项。

字符串

无

AUTH_CLIENT_SECRET

apicurio.auth.client.secret

被序列化和反序列化器使用。用于访问身份验证服务的客户端机密。在使用 OAuth 客户端凭证流访问安全 registry 时，需要此项。

字符串

无

AUTH_USERNAME

apicurio.auth.username

被序列化和反序列化器使用。用于访问 registry 的用户名。在使用 HTTP 基本身份验证访问安全 registry 时，需要此项。

字符串

无

AUTH_PASSWORD

apicurio.auth.password

被序列化和反序列化器使用。用于访问 registry 的密码。在使用 HTTP 基本身份验证访问安全 registry 时，需要此项。

字符串

无

ARTIFACT_RESOLVER_STRATEGY

apicurio.registry.artifact-resolver-strategy

仅被序列化器使用。实现 ArtifactReferenceResolverStrategy 的完全限定 Java 类名称并将每个 Kafka 消息映射到 ArtifactReference (groupId、artifactId 和 version)。例如，默认策略使用主题名称作为 schema artifactId。

字符串

io.apicurio.registry.serde.strategy.TopicIdStrategy

EXPLICIT_ARTIFACT_GROUP_ID

apicurio.registry.artifact.group-id

仅被序列化器使用。设置用于查询或创建工件的 groupId。覆盖 ArtifactResolverStrategy 返回的 groupId。

字符串

无

EXPLICIT_ARTIFACT_ID

apicurio.registry.artifact.artifact-id

仅被序列化器使用。设置用于查询或创建工件的 artifactId。覆盖 ArtifactResolverStrategy 返回的 artifactId。

字符串

无

EXPLICIT_ARTIFACT_VERSION

apicurio.registry.artifact.version

仅被序列化器使用。设置用于查询或创建工件的工件版本。覆盖 ArtifactResolverStrategy 返回的版本。

字符串

无

FIND_LATEST_ARTIFACT

apicurio.registry.find-latest

仅被序列化器使用。指定序列化器是否尝试在 registry 中查找对应的组 ID 和工件 ID 的最新工件。

布尔值

false

AUTO_REGISTER_ARTIFACT

apicurio.registry.auto-register

仅被序列化器使用。指定序列化器是否在 registry 中创建工件。JSON 架构序列化器不支持此功能。

布尔值

false

AUTO_REGISTER_ARTIFACT_IF_EXISTS

apicurio.registry.auto-register.if-exists

仅被序列化器使用。配置在创建工件冲突时客户端的行为，因为工件已存在。可用值有 FAIL、UPDATE、RETURN _OR_UPDATE。

字符串

RETURN_OR_UPDATE

CHECK_PERIOD_MS

apicurio.registry.check-period-ms

被序列化和反序列化器使用。指定在自动驱除前缓存工件的时长。如果没有设置，则每次都会获取工件。

字符串

无

USE_ID

apicurio.registry.use-id

被序列化和反序列化器使用。配置，以使用指定的 IdOption 作为工件标识符。选项为 globalId 和 contentId。指示 serializer 将指定的 ID 写入 Kafka，并指示 deserializer 使用这个 ID 查找 schema。

字符串

globalId

ENABLE_HEADERS

apicurio.registry.headers.enabled

被序列化和反序列化器使用。配置 将工件标识符改为 Kafka 消息标头，而不是在消息有效负载中。

布尔值

true

HEADERS_HANDLER

apicurio.registry.headers.handler

被序列化和反序列化器使用。实现 HeadersHandler 并将工件标识符写入/从 Kafka 消息标头的全限定 Java 类名称。

字符串

io.apicurio.registry.serde.headers.DefaultHeadersHandler

ID_HANDLER

apicurio.registry.id-handler

被序列化和反序列化器使用。实现 IdHandler 并将工件标识符写入/从消息有效负载到/读取的类的完全限定 Java 类名称。只有在将 apicurio.registry.headers.enabled 设置为 false 时才使用。

字符串

io.apicurio.registry.serde.DefaultIdHandler

ENABLE_CONFLUENT_ID_HANDLER

apicurio.registry.as-confluent

被序列化和反序列化器使用。启用 IdHandler 的传统 Confluent 兼容实施的快捷方式。只有在将 apicurio.registry.headers.enabled 设置为 false 时才使用。

布尔值

true

FALLBACK_ARTIFACT_PROVIDER

apicurio.registry.fallback.provider

仅对反序列化器使用。设置 FallbackArtifactProvider 的自定义实施，以解析用于反序列化的工件。FallbackArtifactProvider 配置一个回退工件，以便在查找失败时从 registry 获取。

字符串

io.apicurio.registry.serde.fallback.DefaultFallbackArtifactProvider

FALLBACK_ARTIFACT_ID

apicurio.registry.fallback.artifact-id

仅供反序列化器使用。设置 artifactId，用作解析用于反序列化的工件。

字符串

无

FALLBACK_ARTIFACT_GROUP_ID

apicurio.registry.fallback.group-id

仅供反序列化器使用。设置 groupId 用作回退，以解析用于反序列化的组。

字符串

无

FALLBACK_ARTIFACT_VERSION

apicurio.registry.fallback.version

仅供反序列化器使用。将版本设置为回退，用于解析用于反序列化的工件。

字符串

无