# confluentinc/kafka-streams-examples architecture

> Architecture diagram of the GitHub repository confluentinc/kafka-streams-examples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/confluentinc/kafka-streams-examples
- Repository: https://github.com/confluentinc/kafka-streams-examples

## Overview

This repository is a catalog of Kafka Streams example applications, not one integrated product. The common workflow is to consume Kafka events, apply a Streams topology, and emit results; examples illustrate distinct transformations, joins, windows, formats, and stateful processing. Separate examples demonstrate interactive REST queries, a microservice ecosystem, security, and application reset. The README documents these capabilities, but the source excerpts contain no Java or Scala runtime code, so internal call relationships cannot be verified.

Main entry points: [`src/main/java/io/confluent/examples/streams`](https://github.com/confluentinc/kafka-streams-examples/tree/master/src/main/java/io/confluent/examples/streams) (Runnable Examples), [`src/main/java/io/confluent/examples/streams/interactivequeries/WordCountInteractiveQueriesExample.java`](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/interactivequeries/WordCountInteractiveQueriesExample.java) (Word Count Queries), [`src/main/java/io/confluent/examples/streams/interactivequeries/kafkamusic/KafkaMusicExample.java`](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/interactivequeries/kafkamusic/KafkaMusicExample.java) (Kafka Music), [`src/main/java/io/confluent/examples/streams/WordCountLambdaExample.java`](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/WordCountLambdaExample.java) (Word Count)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_streaming["Stream Processing"]
  node_event_apps["Runnable Examples"]
  node_word_count["Word Count"]
  node_map_function["Map Function"]
  node_sum["Sum"]
  node_session_windows["Session Windows"]
  node_page_view["Page View Joins"]
  node_global_tables["Global Tables"]
  node_global_stores["Global Stores"]
  node_avro["Avro Processing"]
  node_scala_examples["Scala Examples"]
end

subgraph group_queries["Interactive Queries"]
  node_interactive["Word Count Queries"]
  node_word_rest["Word Count REST"]
  node_music["Kafka Music"]
  node_music_rest["Music REST"]
end

subgraph group_services["Microservices"]
  node_microservices["Microservice Ecosystem"]
end

subgraph group_operations["Operations"]
  node_secure["Secure Streams"]
  node_reset["Application Reset"]
end

node_kafka(("Kafka Cluster"))
node_results(("Kafka Results"))

node_kafka -->|"provides events"| node_event_apps
node_event_apps -->|"includes"| node_word_count
node_event_apps -->|"includes"| node_map_function
node_event_apps -->|"includes"| node_sum
node_event_apps -->|"includes"| node_session_windows
node_event_apps -->|"includes"| node_page_view
node_event_apps -->|"includes"| node_global_tables
node_event_apps -->|"includes"| node_global_stores
node_event_apps -->|"includes"| node_avro
node_event_apps -->|"includes"| node_scala_examples
node_event_apps -.->|"emits results"| node_results
node_kafka -->|"provides events"| node_interactive
node_kafka -->|"provides events"| node_music
node_interactive -->|"serves queries"| node_word_rest
node_music -->|"serves queries"| node_music_rest
node_kafka -->|"supports streaming"| node_microservices
node_kafka -->|"connects securely"| node_secure

click node_event_apps "https://github.com/confluentinc/kafka-streams-examples/tree/master/src/main/java/io/confluent/examples/streams"
click node_word_count "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/WordCountLambdaExample.java"
click node_map_function "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/MapFunctionLambdaExample.java"
click node_sum "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/SumLambdaExample.java"
click node_session_windows "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/SessionWindowsExample.java"
click node_page_view "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/PageViewRegionLambdaExample.java"
click node_global_tables "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/GlobalKTablesExample.java"
click node_global_stores "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/GlobalStoresExample.java"
click node_avro "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/WikipediaFeedAvroLambdaExample.java"
click node_scala_examples "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/scala/io/confluent/examples/streams/WordCountScalaExample.scala"
click node_interactive "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/interactivequeries/WordCountInteractiveQueriesExample.java"
click node_word_rest "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/interactivequeries/WordCountInteractiveQueriesRestService.java"
click node_music "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/interactivequeries/kafkamusic/KafkaMusicExample.java"
click node_music_rest "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/interactivequeries/kafkamusic/MusicPlaysRestService.java"
click node_microservices "https://github.com/confluentinc/kafka-streams-examples/tree/master/src/main/java/io/confluent/examples/streams/microservices"
click node_secure "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/SecureKafkaStreamsExample.java"
click node_reset "https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/ApplicationResetExample.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_event_apps,node_word_count,node_map_function,node_sum,node_session_windows,node_page_view,node_global_tables,node_global_stores,node_avro,node_scala_examples toneBlue
class node_interactive,node_word_rest,node_music,node_music_rest toneAmber
class node_microservices toneMint
class node_secure,node_reset toneRose
class node_kafka,node_results toneIndigo
```

## Components

### Stream Processing

- [Runnable Examples](https://github.com/confluentinc/kafka-streams-examples/tree/master/src/main/java/io/confluent/examples/streams): `src/main/java/io/confluent/examples/streams`
- [Word Count](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/WordCountLambdaExample.java): `src/main/java/io/confluent/examples/streams/WordCountLambdaExample.java`
- [Map Function](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/MapFunctionLambdaExample.java): `src/main/java/io/confluent/examples/streams/MapFunctionLambdaExample.java`
- [Sum](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/SumLambdaExample.java): `src/main/java/io/confluent/examples/streams/SumLambdaExample.java`
- [Session Windows](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/SessionWindowsExample.java): `src/main/java/io/confluent/examples/streams/SessionWindowsExample.java`
- [Page View Joins](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/PageViewRegionLambdaExample.java): `src/main/java/io/confluent/examples/streams/PageViewRegionLambdaExample.java`
- [Global Tables](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/GlobalKTablesExample.java): `src/main/java/io/confluent/examples/streams/GlobalKTablesExample.java`
- [Global Stores](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/GlobalStoresExample.java): `src/main/java/io/confluent/examples/streams/GlobalStoresExample.java`
- [Avro Processing](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/WikipediaFeedAvroLambdaExample.java): `src/main/java/io/confluent/examples/streams/WikipediaFeedAvroLambdaExample.java`
- [Scala Examples](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/scala/io/confluent/examples/streams/WordCountScalaExample.scala): `src/main/scala/io/confluent/examples/streams/WordCountScalaExample.scala`

### Interactive Queries

- [Word Count Queries](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/interactivequeries/WordCountInteractiveQueriesExample.java): `src/main/java/io/confluent/examples/streams/interactivequeries/WordCountInteractiveQueriesExample.java`
- [Word Count REST](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/interactivequeries/WordCountInteractiveQueriesRestService.java): `src/main/java/io/confluent/examples/streams/interactivequeries/WordCountInteractiveQueriesRestService.java`
- [Kafka Music](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/interactivequeries/kafkamusic/KafkaMusicExample.java): `src/main/java/io/confluent/examples/streams/interactivequeries/kafkamusic/KafkaMusicExample.java`
- [Music REST](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/interactivequeries/kafkamusic/MusicPlaysRestService.java): `src/main/java/io/confluent/examples/streams/interactivequeries/kafkamusic/MusicPlaysRestService.java`

### Microservices

- [Microservice Ecosystem](https://github.com/confluentinc/kafka-streams-examples/tree/master/src/main/java/io/confluent/examples/streams/microservices): `src/main/java/io/confluent/examples/streams/microservices`

### Operations

- [Secure Streams](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/SecureKafkaStreamsExample.java): `src/main/java/io/confluent/examples/streams/SecureKafkaStreamsExample.java`
- [Application Reset](https://github.com/confluentinc/kafka-streams-examples/blob/master/src/main/java/io/confluent/examples/streams/ApplicationResetExample.java): `src/main/java/io/confluent/examples/streams/ApplicationResetExample.java`

### Other components

- **Kafka Cluster**
- **Kafka Results**

## Connections

- Kafka Cluster → Runnable Examples: provides events (evidence: `README.md`)
- Runnable Examples → Word Count: includes (evidence: `README.md`)
- Runnable Examples → Map Function: includes (evidence: `README.md`)
- Runnable Examples → Sum: includes (evidence: `README.md`)
- Runnable Examples → Session Windows: includes (evidence: `README.md`)
- Runnable Examples → Page View Joins: includes (evidence: `README.md`)
- Runnable Examples → Global Tables: includes (evidence: `README.md`)
- Runnable Examples → Global Stores: includes (evidence: `README.md`)
- Runnable Examples → Avro Processing: includes (evidence: `README.md`)
- Runnable Examples → Scala Examples: includes (evidence: `README.md`)
- Runnable Examples → Kafka Results: emits results
- Kafka Cluster → Word Count Queries: provides events (evidence: `README.md`)
- Kafka Cluster → Kafka Music: provides events (evidence: `README.md`)
- Word Count Queries → Word Count REST: serves queries (evidence: `README.md`)
- Kafka Music → Music REST: serves queries (evidence: `README.md`)
- Kafka Cluster → Microservice Ecosystem: supports streaming (evidence: `README.md`)
- Kafka Cluster → Secure Streams: connects securely (evidence: `README.md`)
