8.2. Service Registry serializer/deserializer 配置属性

SCHEMA_RESOLVER

apicurio.registry.schema-resolver

供 serializers 和 deserializers 使用。实施 SchemaResolver 的完全限定 Java 类名称。

字符串

io.apicurio.registry.resolver.DefaultSchemaResolver

REGISTRY_URL

apicurio.registry.url

供 serializers 和 deserializers 使用。用于访问 registry API 的 URL。

字符串

无

AUTH_SERVICE_URL

apicurio.auth.service.url

供 serializers 和 deserializers 使用。身份验证服务的 URL。在使用 OAuth 客户端凭证流访问安全 registry 时是必需的。

字符串

无

AUTH_REALM

apicurio.auth.realm

供 serializers 和 deserializers 使用。用于访问身份验证服务的 realm。在使用 OAuth 客户端凭证流访问安全 registry 时是必需的。

字符串

无

AUTH_CLIENT_ID

apicurio.auth.client.id

供 serializers 和 deserializers 使用。用于访问身份验证服务的客户端 ID。在使用 OAuth 客户端凭证流访问安全 registry 时是必需的。

字符串

无

AUTH_CLIENT_SECRET

apicurio.auth.client.secret

供 serializers 和 deserializers 使用。用于访问身份验证服务的客户端机密。在使用 OAuth 客户端凭证流访问安全 registry 时是必需的。

字符串

无

AUTH_USERNAME

apicurio.auth.username

供 serializers 和 deserializers 使用。访问 registry 的用户名。使用 HTTP 基本身份验证访问安全 registry 时是必需的。

字符串

无

AUTH_PASSWORD

apicurio.auth.password

供 serializers 和 deserializers 使用。用于访问 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

仅供序列化商使用。指定 serializer 是否在 registry 中查找对应组 ID 和工件 ID 的最新工件。

布尔值

false

AUTO_REGISTER_ARTIFACT

apicurio.registry.auto-register

仅供序列化商使用。指定 serializer 试图在 registry 中创建工件。JSON Schema serializer 不支持此功能。

布尔值

false

AUTO_REGISTER_ARTIFACT_IF_EXISTS

apicurio.registry.auto-register.if-exists

仅供序列化商使用。在存在冲突创建工件时，配置客户端的行为，因为工件已存在。可用值包括 FAIL、UPDATE、RETURN 或 RETURN_OR_UPDATE。

字符串

RETURN_OR_UPDATE

CHECK_PERIOD_MS

apicurio.registry.check-period-ms

供 serializers 和 deserializers 使用。指定在 auto-eviction 前缓存工件的时长。如果没有设置，则每次都会获取工件。

字符串

无

USE_ID

apicurio.registry.use-id

供 serializers 和 deserializers 使用。配置，以使用指定的 IdOption 作为工件的标识符。选项为 globalId 和 contentId。指示 serializer 将指定的 ID 写入 Kafka，并指示 deserializer 使用这个 ID 来查找 schema。

字符串

globalId

ENABLE_HEADERS

apicurio.registry.headers.enabled

供 serializers 和 deserializers 使用。配置 以读取/写入工件标识符到 Kafka 消息标头，而不是在消息有效负载中。

布尔值

true

HEADERS_HANDLER

apicurio.registry.headers.handler

供 serializers 和 deserializers 使用。实现 HeadersHandler 的完全限定 Java 类名称，并将工件标识符写入/读取至 Kafka 消息标头。

字符串

io.apicurio.registry.serde.headers.DefaultHeadersHandler

ID_HANDLER

apicurio.registry.id-handler

供 serializers 和 deserializers 使用。实施 IdHandler 的类的完全限定 Java 类名称，并将工件标识符写入/读取消息有效负载。只有在 apicurio.registry.headers.enabled 被设置为 false 时才使用。

字符串

io.apicurio.registry.serde.DefaultIdHandler

ENABLE_CONFLUENT_ID_HANDLER

apicurio.registry.as-confluent

供 serializers 和 deserializers 使用。启用与 IdHandler 传统兼容实施的快捷方式。只有在 apicurio.registry.headers.enabled 被设置为 false 时才使用。

布尔值

true

FALLBACK_ARTIFACT_PROVIDER

apicurio.registry.fallback.provider

仅限由 deserializers 使用。设置 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

仅供反序列化商使用。设置用于解析用于反序列化的工件的版本。

字符串

无