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。

字符串

None

AUTH_SERVICE_URL

apicurio.auth.service.url

由 serializers 和 deserializers 使用。身份验证服务的 URL。使用 OAuth 客户端凭证流访问安全 registry 时需要此项。

字符串

None

AUTH_TOKEN_ENDPOINT

apicurio.auth.service.token.endpoint

由 serializers 和 deserializers 使用。令牌端点的 URL。没有指定安全 registry 和 AUTH_SERVICE_URL 时需要此项。

字符串

None

AUTH_REALM

apicurio.auth.realm

由 serializers 和 deserializers 使用。realm 以访问身份验证服务。使用 OAuth 客户端凭证流访问安全 registry 时需要此项。

字符串

None

AUTH_CLIENT_ID

apicurio.auth.client.id

由 serializers 和 deserializers 使用。用于访问身份验证服务的客户端 ID。使用 OAuth 客户端凭证流访问安全 registry 时需要此项。

字符串

None

AUTH_CLIENT_SECRET

apicurio.auth.client.secret

由 serializers 和 deserializers 使用。用于访问身份验证服务的客户端机密。使用 OAuth 客户端凭证流访问安全 registry 时需要此项。

字符串

None

AUTH_USERNAME

apicurio.auth.username

由 serializers 和 deserializers 使用。访问 registry 的用户名。使用 HTTP 基本身份验证访问安全 registry 时需要此项。

字符串

None

AUTH_PASSWORD

apicurio.auth.password

由 serializers 和 deserializers 使用。访问 registry 的密码。使用 HTTP 基本身份验证访问安全 registry 时需要此项。

字符串

None

ARTIFACT_RESOLVER_STRATEGY

apicurio.registry.artifact-resolver-strategy

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

字符串

io.apicurio.registry.serde.strategy.TopicIdStrategy

EXPLICIT_ARTIFACT_GROUP_ID

apicurio.registry.artifact.group-id

仅供 serializers 使用。设置用于查询或创建工件的 groupId。覆盖 ArtifactResolverStrategy 返回的 groupId。

字符串

None

EXPLICIT_ARTIFACT_ID

apicurio.registry.artifact.artifact-id

仅供 serializers 使用。设置用于查询或创建工件的 artifactId。覆盖 ArtifactResolverStrategy 返回的 artifactId。

字符串

None

EXPLICIT_ARTIFACT_VERSION

apicurio.registry.artifact.version

仅供 serializers 使用。设置用于查询或创建工件的工件版本。覆盖 ArtifactResolverStrategy 返回的版本。

字符串

None

FIND_LATEST_ARTIFACT

apicurio.registry.find-latest

仅供 serializers 使用。指定 serializer 是否尝试在 registry 中查找对应组 ID 和工件 ID 的最新工件。

布尔值

false

AUTO_REGISTER_ARTIFACT

apicurio.registry.auto-register

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

布尔值，布尔值字符串

false

AUTO_REGISTER_ARTIFACT_IF_EXISTS

apicurio.registry.auto-register.if-exists

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

字符串

RETURN_OR_UPDATE

CHECK_PERIOD_MS

apicurio.registry.check-period-ms

由 serializers 和 deserializers 使用。指定在自动驱除前缓存工件的时长（毫秒）。如果设置为零，则每次获取工件。

java.time.Duration、非负号或整数字符串

30000

RETRY_BACKOFF_MS

apicurio.registry.retry-backoff-ms

由 serializers 和 deserializers 使用。如果无法从 Registry 检索模式，它可以重试多次。此配置选项控制重试尝试之间的延迟（毫秒）。

java.time.Duration、非负号或整数字符串

300

RETRY_COUNT

apicurio.registry.retry-count

由 serializers 和 deserializers 使用。如果无法从 Registry 检索模式，它可以重试多次。这个配置选项控制重试尝试的数量。

非负数或整数字符串

3

USE_ID

apicurio.registry.use-id

由 serializers 和 deserializers 使用。配置以使用指定的 IdOption 作为工件的标识符。选项为 globalId 和 contentId。指示序列化器将指定的 ID 写入 Kafka，并指示反序列化器使用此 ID 来查找 schema。

字符串

globalId

ENABLE_HEADERS

apicurio.registry.headers.enabled

由 serializers 和 deserializers 使用。将工件标识符配置为 Kafka 消息标头，而不是在消息有效负载中。

布尔值

true

HEADERS_HANDLER

apicurio.registry.headers.handler

由 serializers 和 deserializers 使用。实现 HeadersHandler 以及到/从 Kafka 消息标头写入/读取工件标识的完全限定的 Java 类名称，。

字符串

io.apicurio.registry.serde.headers.DefaultHeadersHandler

ID_HANDLER

apicurio.registry.id-handler

由 serializers 和 deserializers 使用。实现 IdHandler 的类的完全限定域名，并将工件标识符写入/从消息有效负载写入/读取。仅在 apicurio.registry.headers.enabled 设为 false 时使用。

字符串

io.apicurio.registry.serde.DefaultIdHandler

ENABLE_CONFLUENT_ID_HANDLER

apicurio.registry.as-confluent

由 serializers 和 deserializers 使用。启用旧的、与 Confluent 兼容的 IdHandler 实施的快捷方式。仅在 apicurio.registry.headers.enabled 设为 false 时使用。

布尔值

true

FALLBACK_ARTIFACT_PROVIDER

apicurio.registry.fallback.provider

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

字符串

io.apicurio.registry.serde.fallback.DefaultFallbackArtifactProvider

FALLBACK_ARTIFACT_ID

apicurio.registry.fallback.artifact-id

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

字符串

None

FALLBACK_ARTIFACT_GROUP_ID

apicurio.registry.fallback.group-id

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

字符串

None

FALLBACK_ARTIFACT_VERSION

apicurio.registry.fallback.version

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

字符串

None