How dotnet/mqttnet works
MQTTnet is a .NET MQTT client and broker library supporting MQTT through version 5. Its main workflow configures a client, connects over a supported channel, and exchanges publish/subscribe messages through the broker, which manages client sessions, subscriptions, delivery, and retained messages. The graph also shows protocol handling, packet inspection, RPC, SOCKS5, and ASP.NET Core hosting. Relationships are limited to README statements and the supplied source index or excerpts; unsampled implementation details are not assumed.
Main entry points: MqttClient.cs Client API · MqttClientSessionsManager.cs Session manager · MqttChannelAdapter.cs Channels and adapters · MqttClientOptionsBuilder.cs Client options
Components 20
MQTT client
- Client API
Source/MQTTnet/MqttClient.cs - Client options
Source/MQTTnet/Options/MqttClientOptionsBuilder.cs - Message model
Source/MQTTnet/MqttApplicationMessage.cs
Protocol runtime
- Channels and adapters
Source/MQTTnet/Adapter/MqttChannelAdapter.cs - TCP channel
Source/MQTTnet/Implementations/MqttTcpChannel.cs - WebSocket channel
Source/MQTTnet/Implementations/MqttWebSocketChannel.cs - Packet dispatcher
Source/MQTTnet/PacketDispatcher/MqttPacketDispatcher.cs - Packet formatting
Source/MQTTnet/Formatter/MqttPacketFormatterAdapter.cs - Packet inspection
Source/MQTTnet/Adapter/MqttPacketInspector.cs
Broker
- Server API
Source/MQTTnet.Server/MqttServer.cs - Session manager
Source/MQTTnet.Server/Internal/MqttClientSessionsManager.cs - Client session
Source/MQTTnet.Server/Internal/MqttSession.cs - Session storage
Source/MQTTnet.Server/Internal/MqttSessionsStorage.cs - Retained messages
Source/MQTTnet.Server/Internal/MqttRetainedMessagesManager.cs - Broker events
Source/MQTTnet.Server/Internal/MqttServerEventContainer.cs
Hosting and extensions
- ASP.NET hosting
Source/MQTTnet.AspnetCore/MqttHostedServer.cs - RPC client
Source/MQTTnet.Extensions.Rpc/MqttRpcClient.cs - SOCKS5 transport
Source/MQTTnet.Extensions.Socks5/Socks5StreamProvider.cs
Other components
- Application
- MQTT broker
Connections 22
- Application → Client options: configures
Source/MQTTnet/Options/MqttClientOptionsBuilder.cs - Client options → Client API: configures
Source/MQTTnet/Options/MqttClientOptionsBuilder.cs - Application → Client API: uses
- Client API → Channels and adapters: creates adapters
Source/MQTTnet/MqttClient.cs - Channels and adapters → TCP channel: uses
- Channels and adapters → WebSocket channel: uses
- Client API → Packet dispatcher: dispatches packets
Source/MQTTnet/MqttClient.cs - Channels and adapters → Packet inspection: inspects packets
- Client API → Message model: exchanges messages
Source/MQTTnet/MqttClient.cs - Client API → MQTT broker: communicates with
- Application → Server API: hosts broker
- Server API → Session manager: manages clients
- Session manager → Client session: manages sessions
Source/MQTTnet.Server/Internal/MqttClientSessionsManager.cs - Session manager → Session storage: updates storage
Source/MQTTnet.Server/Internal/MqttClientSessionsManager.cs - Session manager → Retained messages: uses retained state
Source/MQTTnet.Server/Internal/MqttClientSessionsManager.cs - Session manager → Broker events: raises events
Source/MQTTnet.Server/Internal/MqttClientSessionsManager.cs - Retained messages → Broker events: loads and signals
Source/MQTTnet.Server/Internal/MqttRetainedMessagesManager.cs - Application → ASP.NET hosting: hosts via
- Application → RPC client: uses RPC
- RPC client → Client API: uses client
Source/MQTTnet.Extensions.Rpc/MqttRpcClient.cs - Application → SOCKS5 transport: configures proxy
- SOCKS5 transport → Client options: extends options
Source/MQTTnet.Extensions.Socks5/MqttClientOptionsBuilderExtensions.cs