How spring-attic/spring-cloud-stream-binder-kafka works
This repository provides two Spring Cloud Stream integrations: a message-channel Kafka binder and a Kafka Streams binder. In the principal channel-binder workflow, an application binds a destination, the binder provisions Kafka topics and configures producer or consumer clients, then transfers messages through those clients. The Streams binder supports KStream, KTable, and GlobalKTable bindings, function-based processing, state-store queries, and runtime management. Core configuration, topic provisioning, and dead-letter support are represented separately. Several Streams relationships are inferred from the documented capability and file structure; those links are marked unverified rather than asserted as inspected call paths.
Main entry points: KafkaMessageChannelBinder.java Channel Binder · KafkaTopicProvisioner.java Topic Provisioner · KStreamBinderConfiguration.java Streams Configuration · KStreamBoundElementFactory.java Binding Factories
Components 25
Kafka Channel Binder
- Channel Binder
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/KafkaMessageChannelBinder.java - Channel Configuration
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/config/KafkaBinderConfiguration.java - Header Mapping
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/BinderHeaderMapper.java - Rebalance Listener
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/KafkaBindingRebalanceListener.java - Client Customizers
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/config/ClientFactoryCustomizer.java
Shared Kafka Core
- Binder Properties
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/properties/KafkaBinderConfigurationProperties.java - Binding Properties
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/properties/KafkaBindingProperties.java - Consumer Properties
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/properties/KafkaConsumerProperties.java - Producer Properties
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/properties/KafkaProducerProperties.java - Topic Properties
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/properties/KafkaTopicProperties.java - Topic Provisioner
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/provisioning/KafkaTopicProvisioner.java - Dead Letter Support
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/utils/DlqDestinationResolver.java
Kafka Streams Runtime
- Streams Configuration
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/KStreamBinderConfiguration.java - KStream Binding
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/KStreamBinder.java - KTable Binding
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/KTableBinder.java - Global Table Binding
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/GlobalKTableBinder.java
Streams Functions And Operations
- Function Processing
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/KafkaStreamsFunctionProcessor.java - Binding Factories
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/KStreamBoundElementFactory.java - Streams Lifecycle
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/StreamsBuilderFactoryManager.java - Streams Registry
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/KafkaStreamsRegistry.java - Interactive Queries
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/InteractiveQueryService.java - Deserialization Handling
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/DeserializationExceptionHandler.java - Topology Endpoint
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/endpoint/KafkaStreamsTopologyEndpoint.java
Other components
- Stream Application
- Kafka Broker
Connections 28
- Stream Application → Channel Binder: binds destination
- Channel Binder → Topic Provisioner: provisions topics
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/KafkaMessageChannelBinder.java - Channel Binder → Binder Properties: reads settings
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/KafkaMessageChannelBinder.java - Channel Binder → Consumer Properties: reads binding options
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/KafkaMessageChannelBinder.java - Channel Binder → Producer Properties: reads binding options
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/KafkaMessageChannelBinder.java - Channel Binder → Dead Letter Support: resolves dead letters
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/KafkaMessageChannelBinder.java - Channel Binder → Header Mapping: maps headers
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/KafkaMessageChannelBinder.java - Channel Binder → Rebalance Listener: uses listener
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/KafkaMessageChannelBinder.java - Channel Binder → Client Customizers: customizes factories
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/KafkaMessageChannelBinder.java - Channel Configuration → Channel Binder: configures binder
spring-cloud-stream-binder-kafka/src/main/java/org/springframework/cloud/stream/binder/kafka/config/KafkaBinderConfiguration.java - Topic Provisioner → Binder Properties: reads settings
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/provisioning/KafkaTopicProvisioner.java - Topic Provisioner → Consumer Properties: reads topic options
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/provisioning/KafkaTopicProvisioner.java - Topic Provisioner → Producer Properties: reads topic options
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/provisioning/KafkaTopicProvisioner.java - Topic Provisioner → Topic Properties: applies topic settings
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/provisioning/KafkaTopicProvisioner.java - Topic Provisioner → Kafka Broker: creates topics
spring-cloud-stream-binder-kafka-core/src/main/java/org/springframework/cloud/stream/binder/kafka/provisioning/KafkaTopicProvisioner.java - Channel Binder → Kafka Broker: produces and consumes
- Stream Application → Streams Configuration: selects Streams binder
- Streams Configuration → KStream Binding: enables binding
- Streams Configuration → KTable Binding: enables binding
- Streams Configuration → Global Table Binding: enables binding
- KStream Binding → Binding Factories: creates bindings
- KTable Binding → Binding Factories: creates bindings
- Global Table Binding → Binding Factories: creates bindings
- Function Processing → Kafka Broker: processes streams
- Streams Lifecycle → Streams Registry: registers runtime
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/StreamsBuilderFactoryManager.java - Interactive Queries → Streams Registry: queries runtime
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/InteractiveQueryService.java - Deserialization Handling → Kafka Broker: handles decode errors
- Topology Endpoint → Streams Registry: inspects topology
spring-cloud-stream-binder-kafka-streams/src/main/java/org/springframework/cloud/stream/binder/kafka/streams/endpoint/KafkaStreamsTopologyEndpoint.java