io.confluent.kafka.serializers

Class AbstractKafkaAvroDeserializer

java.lang.Object

io.confluent.kafka.serializers.AbstractKafkaSchemaSerDe

io.confluent.kafka.serializers.AbstractKafkaAvroDeserializer

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

KafkaAvroDecoder, KafkaAvroDeserializer

public abstract class AbstractKafkaAvroDeserializer
extends AbstractKafkaSchemaSerDe

Nested Class Summary

Nested classes/interfaces inherited from class io.confluent.kafka.serializers.AbstractKafkaSchemaSerDe

AbstractKafkaSchemaSerDe.ExtendedSchema, AbstractKafkaSchemaSerDe.Migration, AbstractKafkaSchemaSerDe.SubjectSchema

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	avroReflectionAllowNull
protected boolean	avroUseLogicalTypeConverters
protected org.apache.avro.Schema	specificAvroReaderSchema
protected boolean	useSpecificAvroReader

Fields inherited from class io.confluent.kafka.serializers.AbstractKafkaSchemaSerDe

config, configOriginals, contextNameStrategy, DEFAULT_CACHE_CAPACITY, enableRuleServiceLoader, idSize, isKey, keySubjectNameStrategy, latestVersions, latestWithMetadata, MAGIC_BYTE, metadata, ruleActions, ruleExecutors, schemaRegistry, ticker, useLatestVersion, useSchemaReflection, valueSubjectNameStrategy

Constructor Summary

Constructors

Constructor and Description
AbstractKafkaAvroDeserializer()

Method Summary

Modifier and Type	Method and Description
protected void	configure(KafkaAvroDeserializerConfig config)
protected void	configure(KafkaAvroDeserializerConfig config, Class<?> type) Sets properties for this deserializer without overriding the schema registry client itself.
protected Object	deserialize(byte[] payload) Deserializes the payload without including schema information for primitive types, maps, and arrays.
protected Object	deserialize(byte[] payload, org.apache.avro.Schema readerSchema) Just like single-parameter version but accepts an Avro schema to use for reading
protected Object	deserialize(String topic, Boolean isKey, byte[] payload, org.apache.avro.Schema readerSchema)
protected Object	deserialize(String topic, Boolean isKey, org.apache.kafka.common.header.Headers headers, byte[] payload, org.apache.avro.Schema readerSchema)
protected KafkaAvroDeserializerConfig	deserializerConfig(Map<String,?> props)
protected KafkaAvroDeserializerConfig	deserializerConfig(Properties props)
protected GenericContainerWithVersion	deserializeWithSchemaAndVersion(String topic, boolean isKey, byte[] payload) Deserializes the payload and includes schema information, with version information from the schema registry embedded in the schema.
protected GenericContainerWithVersion	deserializeWithSchemaAndVersion(String topic, boolean isKey, org.apache.kafka.common.header.Headers headers, byte[] payload)
protected org.apache.avro.io.DatumReader<?>	getDatumReader(org.apache.avro.Schema writerSchema, org.apache.avro.Schema readerSchema)

Methods inherited from class io.confluent.kafka.serializers.AbstractKafkaSchemaSerDe

clearKey, close, configureClientProperties, executeMigrations, executeRules, executeRules, getById, getBySubjectAndId, getByteBuffer, getContextName, getContextName, getLatestWithMetadata, getMigrations, getOldSubjectName, getRuleActions, getRuleExecutors, getSchemaById, getSchemaBySubjectAndId, getSchemaRegistryClient, getSubjectName, isDeprecatedSubjectNameStrategy, isKey, key, latestVersionsCache, latestWithMetadataCache, lookupLatestVersion, lookupLatestVersion, lookupSchemaBySubjectAndId, postOp, register, register, register, registerWithResponse, setKey, strategyUsesSchema, ticker, toKafkaException

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

useSpecificAvroReader

protected boolean useSpecificAvroReader

specificAvroReaderSchema

protected org.apache.avro.Schema specificAvroReaderSchema

avroReflectionAllowNull

protected boolean avroReflectionAllowNull

avroUseLogicalTypeConverters

protected boolean avroUseLogicalTypeConverters

Constructor Detail

AbstractKafkaAvroDeserializer

public AbstractKafkaAvroDeserializer()

Method Detail

configure

protected void configure(KafkaAvroDeserializerConfig config)

configure

protected void configure(KafkaAvroDeserializerConfig config,
                         Class<?> type)

Sets properties for this deserializer without overriding the schema registry client itself. Useful for testing, where a mock client is injected.

deserializerConfig

protected KafkaAvroDeserializerConfig deserializerConfig(Map<String,?> props)

deserializerConfig

protected KafkaAvroDeserializerConfig deserializerConfig(Properties props)

deserialize

protected Object deserialize(byte[] payload)
                      throws org.apache.kafka.common.errors.SerializationException

Deserializes the payload without including schema information for primitive types, maps, and arrays. Just the resulting deserialized object is returned.

This behavior is the norm for Decoders/Deserializers.

Parameters:

payload - serialized data

Returns:

the deserialized object

Throws:

org.apache.kafka.common.errors.SerializationException

deserialize

protected Object deserialize(byte[] payload,
                             org.apache.avro.Schema readerSchema)
                      throws org.apache.kafka.common.errors.SerializationException

Just like single-parameter version but accepts an Avro schema to use for reading

Parameters:

payload - serialized data

readerSchema - schema to use for Avro read (optional, enables Avro projection)

Returns:

the deserialized object

Throws:

org.apache.kafka.common.errors.SerializationException

deserialize

protected Object deserialize(String topic,
                             Boolean isKey,
                             byte[] payload,
                             org.apache.avro.Schema readerSchema)
                      throws org.apache.kafka.common.errors.SerializationException

Throws:

org.apache.kafka.common.errors.SerializationException

deserialize

protected Object deserialize(String topic,
                             Boolean isKey,
                             org.apache.kafka.common.header.Headers headers,
                             byte[] payload,
                             org.apache.avro.Schema readerSchema)
                      throws org.apache.kafka.common.errors.SerializationException

Throws:

org.apache.kafka.common.errors.SerializationException

deserializeWithSchemaAndVersion

protected GenericContainerWithVersion deserializeWithSchemaAndVersion(String topic,
                                                                      boolean isKey,
                                                                      byte[] payload)
                                                               throws org.apache.kafka.common.errors.SerializationException,
                                                                      org.apache.kafka.common.errors.InvalidConfigurationException

Deserializes the payload and includes schema information, with version information from the schema registry embedded in the schema.

Parameters:

payload - the serialized data

Returns:

a GenericContainer with the schema and data, either as a NonRecordContainer, GenericRecord, or SpecificRecord

Throws:

org.apache.kafka.common.errors.SerializationException

org.apache.kafka.common.errors.InvalidConfigurationException

deserializeWithSchemaAndVersion

protected GenericContainerWithVersion deserializeWithSchemaAndVersion(String topic,
                                                                      boolean isKey,
                                                                      org.apache.kafka.common.header.Headers headers,
                                                                      byte[] payload)
                                                               throws org.apache.kafka.common.errors.SerializationException,
                                                                      org.apache.kafka.common.errors.InvalidConfigurationException

Throws:

org.apache.kafka.common.errors.SerializationException

org.apache.kafka.common.errors.InvalidConfigurationException

getDatumReader

protected org.apache.avro.io.DatumReader<?> getDatumReader(org.apache.avro.Schema writerSchema,
                                                           org.apache.avro.Schema readerSchema)
                                                    throws ExecutionException

Throws:

ExecutionException