How moquette-io/moquette works
Moquette is an embeddable MQTT 3/5 broker. MQTT clients connect to the broker’s Netty-based protocol handling; sessions and routing support delivery, subscriptions, retained messages, and QoS flows, with configurable persistence and optional metrics/interception. The README lists MQTT 5 capabilities including shared subscriptions, expiry, request/response, aliases, and flow control. Several core implementations were not excerpted, so their internal call relationships are not asserted; links to those features reflect documented product behavior rather than inspected method calls.
Main entry points: Server.java Broker server · PostOffice.java Message routing · MetricsProvider.java Metrics provider · SessionRegistry.java Session registry
Components 16
Broker runtime
- Broker server
broker/src/main/java/io/moquette/broker/Server.java - Netty handlers
broker/src/main/java/io/moquette/broker - MQTT connection
broker/src/main/java/io/moquette/broker/MQTTConnection.java
Messaging state
- Session registry
broker/src/main/java/io/moquette/broker/SessionRegistry.java - Client session
broker/src/main/java/io/moquette/broker/Session.java - Message routing
broker/src/main/java/io/moquette/broker/PostOffice.java - Topic subscriptions
broker/src/main/java/io/moquette/broker/subscriptions/CTrieSubscriptionDirectory.java - Topic matching
broker/src/main/java/io/moquette/broker/subscriptions/Topic.java - Retained messages
broker/src/main/java/io/moquette/broker/IRetainedRepository.java - Persistent storage
broker/src/main/java/io/moquette/persistence
Configuration and security
- Broker configuration
broker/src/main/java/io/moquette/broker/config/IConfig.java - Authentication and ACL
broker/src/main/java/io/moquette/broker/security
Broker extensions
- Event interception
broker/src/main/java/io/moquette/interception/InterceptHandler.java - Metrics provider
broker/src/main/java/io/moquette/metrics/MetricsProvider.java - Prometheus exporter
metrics_prometheus/src/main/java/io/moquette/metrics/prometheus/MetricsProviderPrometheus.java
Other components
- MQTT clients
Connections 12
- MQTT clients → Netty handlers: send MQTT
- Broker server → Broker configuration: uses config
broker/src/main/java/io/moquette/broker/Server.java - Broker server → Persistent storage: configures stores
broker/src/main/java/io/moquette/broker/Server.java - Broker server → Event interception: registers handlers
broker/src/main/java/io/moquette/broker/Server.java - MQTT connection → Session registry
- Session registry → Client session
broker/src/main/java/io/moquette/broker/Session.java - Client session → Message routing
- Message routing → Topic subscriptions
- Topic subscriptions → Topic matching
- Message routing → Retained messages
- Metrics provider → Broker configuration: initialized with
broker/src/main/java/io/moquette/metrics/MetricsManager.java - Metrics provider → Prometheus exporter: loads provider
metrics_prometheus/src/main/java/io/moquette/metrics/prometheus/MetricsProviderPrometheus.java