# zamirosmenaj/jms-cookbook architecture

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

- Interactive diagram: https://gitdiagram.com/zamirosmenaj/jms-cookbook
- Repository: https://github.com/zamirosmenaj/jms-cookbook

## Overview

This repository is a set of runnable Java/JMS learning examples, not one integrated application. The main workflows demonstrate producers sending messages through ActiveMQ to topic subscribers or queue consumers. The README also documents advanced topic and queue capabilities, which are represented as feature nodes; source excerpts were not provided, so implementation-level calls and configuration links cannot be verified.

Main entry points: [`02-topic-advanced/jms-publisher/src/main/java/com/example/jms/publisher/NewsPublisher.java`](https://github.com/zamirosmenaj/jms-cookbook/blob/main/02-topic-advanced/jms-publisher/src/main/java/com/example/jms/publisher/NewsPublisher.java) (News Publisher), [`04-queue-advanced/producer/src/main/java/com/example/jms/producer/OrderProducer.java`](https://github.com/zamirosmenaj/jms-cookbook/blob/main/04-queue-advanced/producer/src/main/java/com/example/jms/producer/OrderProducer.java) (Order Producer), [`02-topic-advanced/jms-subscriber/src/main/java/com/example/jms/subscriber/NewsSubscriber.java`](https://github.com/zamirosmenaj/jms-cookbook/blob/main/02-topic-advanced/jms-subscriber/src/main/java/com/example/jms/subscriber/NewsSubscriber.java) (News Subscriber), [`04-queue-advanced/consumer/src/main/java/com/example/jms/consumer/OrderConsumer.java`](https://github.com/zamirosmenaj/jms-cookbook/blob/main/04-queue-advanced/consumer/src/main/java/com/example/jms/consumer/OrderConsumer.java) (Order Consumer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_topic_basic["Basic Topics"]
  node_topic_producer["Topic Producer<br/>[Producer.java]"]
  node_topic_broker[("Topic Broker")]
  node_topic_consumer_a["Consumer A<br/>[ConsumerA.java]"]
  node_topic_consumer_b["Consumer B<br/>[ConsumerB.java]"]
end

subgraph group_topic_advanced["Advanced Topics"]
  node_advanced_publisher["News Publisher<br/>[NewsPublisher.java]"]
  node_advanced_subscriber["News Subscriber"]
  node_topic_features["Topic Features"]
end

subgraph group_queue_basic["Basic Queues"]
  node_queue_producer["Queue Producer<br/>[Producer.java]"]
  node_queue_broker[("Queue Broker")]
  node_queue_consumer_a["Consumer A<br/>[ConsumerA.java]"]
  node_queue_consumer_b["Consumer B<br/>[ConsumerB.java]"]
end

subgraph group_queue_advanced["Advanced Queues"]
  node_advanced_order_producer["Order Producer<br/>[OrderProducer.java]"]
  node_advanced_order_consumer["Order Consumer<br/>[OrderConsumer.java]"]
  node_advanced_queue_broker[("Queue Broker")]
  node_queue_features["Queue Features"]
end

node_topic_producer -->|"publishes to"| node_topic_broker
node_topic_broker -->|"fans out to"| node_topic_consumer_a
node_topic_broker -->|"fans out to"| node_topic_consumer_b
node_advanced_publisher -->|"demonstrates"| node_topic_features
node_advanced_subscriber -->|"demonstrates"| node_topic_features
node_advanced_publisher -->|"publishes to"| node_advanced_subscriber
node_queue_producer -->|"sends to"| node_queue_broker
node_queue_broker -->|"delivers to"| node_queue_consumer_a
node_queue_broker -->|"delivers to"| node_queue_consumer_b
node_advanced_order_producer -->|"sends to"| node_advanced_queue_broker
node_advanced_queue_broker -->|"delivers to"| node_advanced_order_consumer
node_advanced_order_producer -->|"demonstrates"| node_queue_features
node_advanced_order_consumer -->|"demonstrates"| node_queue_features

click node_topic_producer "https://github.com/zamirosmenaj/jms-cookbook/blob/main/01-topic-basic/producer/src/main/java/com/example/Producer.java"
click node_topic_consumer_a "https://github.com/zamirosmenaj/jms-cookbook/blob/main/01-topic-basic/consumer-a/src/main/java/com/example/ConsumerA.java"
click node_topic_consumer_b "https://github.com/zamirosmenaj/jms-cookbook/blob/main/01-topic-basic/consumer-b/src/main/java/com/example/ConsumerB.java"
click node_advanced_publisher "https://github.com/zamirosmenaj/jms-cookbook/blob/main/02-topic-advanced/jms-publisher/src/main/java/com/example/jms/publisher/NewsPublisher.java"
click node_advanced_subscriber "https://github.com/zamirosmenaj/jms-cookbook/blob/main/02-topic-advanced/jms-subscriber/src/main/java/com/example/jms/subscriber/NewsSubscriber.java"
click node_topic_features "https://github.com/zamirosmenaj/jms-cookbook/tree/main/02-topic-advanced"
click node_queue_producer "https://github.com/zamirosmenaj/jms-cookbook/blob/main/03-queue-basic/producer/src/main/java/com/example/Producer.java"
click node_queue_consumer_a "https://github.com/zamirosmenaj/jms-cookbook/blob/main/03-queue-basic/consumer-a/src/main/java/com/example/ConsumerA.java"
click node_queue_consumer_b "https://github.com/zamirosmenaj/jms-cookbook/blob/main/03-queue-basic/consumer-b/src/main/java/com/example/ConsumerB.java"
click node_advanced_order_producer "https://github.com/zamirosmenaj/jms-cookbook/blob/main/04-queue-advanced/producer/src/main/java/com/example/jms/producer/OrderProducer.java"
click node_advanced_order_consumer "https://github.com/zamirosmenaj/jms-cookbook/blob/main/04-queue-advanced/consumer/src/main/java/com/example/jms/consumer/OrderConsumer.java"
click node_queue_features "https://github.com/zamirosmenaj/jms-cookbook/tree/main/04-queue-advanced"

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_topic_producer,node_topic_broker,node_topic_consumer_a,node_topic_consumer_b toneBlue
class node_advanced_publisher,node_advanced_subscriber,node_topic_features toneAmber
class node_queue_producer,node_queue_broker,node_queue_consumer_a,node_queue_consumer_b toneMint
class node_advanced_order_producer,node_advanced_order_consumer,node_advanced_queue_broker,node_queue_features toneRose
```

## Components

### Basic Topics

- [Topic Producer](https://github.com/zamirosmenaj/jms-cookbook/blob/main/01-topic-basic/producer/src/main/java/com/example/Producer.java): `01-topic-basic/producer/src/main/java/com/example/Producer.java`
- **Topic Broker**
- [Consumer A](https://github.com/zamirosmenaj/jms-cookbook/blob/main/01-topic-basic/consumer-a/src/main/java/com/example/ConsumerA.java): `01-topic-basic/consumer-a/src/main/java/com/example/ConsumerA.java`
- [Consumer B](https://github.com/zamirosmenaj/jms-cookbook/blob/main/01-topic-basic/consumer-b/src/main/java/com/example/ConsumerB.java): `01-topic-basic/consumer-b/src/main/java/com/example/ConsumerB.java`

### Advanced Topics

- [News Publisher](https://github.com/zamirosmenaj/jms-cookbook/blob/main/02-topic-advanced/jms-publisher/src/main/java/com/example/jms/publisher/NewsPublisher.java): `02-topic-advanced/jms-publisher/src/main/java/com/example/jms/publisher/NewsPublisher.java`
- [News Subscriber](https://github.com/zamirosmenaj/jms-cookbook/blob/main/02-topic-advanced/jms-subscriber/src/main/java/com/example/jms/subscriber/NewsSubscriber.java): `02-topic-advanced/jms-subscriber/src/main/java/com/example/jms/subscriber/NewsSubscriber.java`
- [Topic Features](https://github.com/zamirosmenaj/jms-cookbook/tree/main/02-topic-advanced): `02-topic-advanced`

### Basic Queues

- [Queue Producer](https://github.com/zamirosmenaj/jms-cookbook/blob/main/03-queue-basic/producer/src/main/java/com/example/Producer.java): `03-queue-basic/producer/src/main/java/com/example/Producer.java`
- **Queue Broker**
- [Consumer A](https://github.com/zamirosmenaj/jms-cookbook/blob/main/03-queue-basic/consumer-a/src/main/java/com/example/ConsumerA.java): `03-queue-basic/consumer-a/src/main/java/com/example/ConsumerA.java`
- [Consumer B](https://github.com/zamirosmenaj/jms-cookbook/blob/main/03-queue-basic/consumer-b/src/main/java/com/example/ConsumerB.java): `03-queue-basic/consumer-b/src/main/java/com/example/ConsumerB.java`

### Advanced Queues

- [Order Producer](https://github.com/zamirosmenaj/jms-cookbook/blob/main/04-queue-advanced/producer/src/main/java/com/example/jms/producer/OrderProducer.java): `04-queue-advanced/producer/src/main/java/com/example/jms/producer/OrderProducer.java`
- [Order Consumer](https://github.com/zamirosmenaj/jms-cookbook/blob/main/04-queue-advanced/consumer/src/main/java/com/example/jms/consumer/OrderConsumer.java): `04-queue-advanced/consumer/src/main/java/com/example/jms/consumer/OrderConsumer.java`
- **Queue Broker**
- [Queue Features](https://github.com/zamirosmenaj/jms-cookbook/tree/main/04-queue-advanced): `04-queue-advanced`

## Connections

- Topic Producer → Topic Broker: publishes to (evidence: `README.md`)
- Topic Broker → Consumer A: fans out to (evidence: `README.md`)
- Topic Broker → Consumer B: fans out to (evidence: `README.md`)
- News Publisher → Topic Features: demonstrates (evidence: `README.md`)
- News Subscriber → Topic Features: demonstrates (evidence: `README.md`)
- News Publisher → News Subscriber: publishes to (evidence: `README.md`)
- Queue Producer → Queue Broker: sends to (evidence: `README.md`)
- Queue Broker → Consumer A: delivers to (evidence: `README.md`)
- Queue Broker → Consumer B: delivers to (evidence: `README.md`)
- Order Producer → Queue Broker: sends to (evidence: `README.md`)
- Queue Broker → Order Consumer: delivers to (evidence: `README.md`)
- Order Producer → Queue Features: demonstrates (evidence: `README.md`)
- Order Consumer → Queue Features: demonstrates (evidence: `README.md`)
