How confluentinc/schema-registry works
Schema Registry serves versioned Avro, JSON Schema, and Protobuf metadata through REST, while Kafka serializers and deserializers register or retrieve schemas for message encoding. The principal path is client schema submission, format-specific parsing and compatibility validation, registry storage, then ID-based lookup by serializers. The tree also shows client libraries, DEK/KMS encryption, and rule execution as meaningful capabilities. Source excerpts are limited, so links beyond documented README behavior are omitted; README-supported relationships are cited explicitly.
Main entry points: SchemaRegistry.java Registry Operations · SchemaProvider.java Schema Providers · Main.java REST Server · CachedSchemaRegistryClient.java Registry Client
Components 21
REST and Clients
- REST Server
core/src/main/java/io/confluent/kafka/schemaregistry/rest/Main.java - REST Client
client/src/main/java/io/confluent/kafka/schemaregistry/client/rest/RestService.java - Registry Client
client/src/main/java/io/confluent/kafka/schemaregistry/client/CachedSchemaRegistryClient.java - Schema API
client/src/main/java/io/confluent/kafka/schemaregistry/client/rest/entities/Schema.java
Schema Management
- Registry Operations
core/src/main/java/io/confluent/kafka/schemaregistry/storage/SchemaRegistry.java - Versioned Schema Store
core/src/main/java/io/confluent/kafka/schemaregistry/storage/SchemaValue.java - Compatibility Checks
client/src/main/java/io/confluent/kafka/schemaregistry/CompatibilityChecker.java - Schema Providers
client/src/main/java/io/confluent/kafka/schemaregistry/SchemaProvider.java - Avro Support
client/src/main/java/io/confluent/kafka/schemaregistry/avro/AvroSchemaProvider.java - JSON Schema Support
json-schema-provider/src/main/java/io/confluent/kafka/schemaregistry/json - Protobuf Support
protobuf-provider/src/main/java/io/confluent/kafka/schemaregistry/protobuf
Kafka Integration
- Avro Serdes
avro-serializer/src/main/java/io/confluent/kafka/serializers/KafkaAvroSerializer.java - JSON Serializer
json-serializer/src/main/java/io/confluent/kafka/serializers/KafkaJsonDeserializer.java - Protobuf Serdes
protobuf-serializer/src/main/java/io/confluent/kafka/serializers/protobuf/AbstractKafkaProtobufSerializer.java
Encryption and Rules
- DEK Client
dek-registry-client/src/main/java/io/confluent/dekregistry/client/CachedDekRegistryClient.java - DEK REST Service
dek-registry-client/src/main/java/io/confluent/dekregistry/client/rest/DekRegistryRestService.java - KMS Drivers
client-encryption-tink/src/main/java/io/confluent/kafka/schemaregistry/encryption/tink/KmsDriverManager.java - Field Encryption
client-encryption/src/main/java/io/confluent/kafka/schemaregistry/encryption/FieldEncryptionExecutor.java - Schema Rules
client/src/main/java/io/confluent/kafka/schemaregistry/rules/RuleExecutor.java
Other components
- API User
- Kafka Application
Connections 22
- API User → REST Server: register or query
- REST Server → Registry Operations: handles requests
- Registry Operations → Schema Providers: parses schemas
core/src/main/java/io/confluent/kafka/schemaregistry/storage/SchemaRegistry.java - Schema Providers → Avro Support: supports format
- Schema Providers → JSON Schema Support: supports format
- Schema Providers → Protobuf Support: supports format
- Registry Operations → Compatibility Checks: checks evolution
- Registry Operations → Versioned Schema Store: stores versions
core/src/main/java/io/confluent/kafka/schemaregistry/storage/SchemaRegistry.java - REST Server → Schema API: accepts schema data
- Registry Client → REST Client: sends registry requests
- REST Client → REST Server: calls REST API
- Kafka Application → Avro Serdes: serializes messages
- Kafka Application → JSON Serializer: uses schema serializer
- Kafka Application → Protobuf Serdes: serializes messages
- Avro Serdes → Registry Client: registers or fetches
- JSON Serializer → Registry Client: registers or fetches
- Protobuf Serdes → Registry Client: registers or fetches
- DEK Client → DEK REST Service: calls DEK endpoints
dek-registry-client/src/main/java/io/confluent/dekregistry/client/CachedDekRegistryClient.java - DEK REST Service → REST Client: reuses REST transport
dek-registry-client/src/main/java/io/confluent/dekregistry/client/rest/DekRegistryRestService.java - Field Encryption → DEK Client: uses key material
- KMS Drivers → Field Encryption: provides cryptography
- Schema Rules → Field Encryption: applies field rules