如果想用C#来创建mqtt的服务器进行数据交互的话,有一个常见的选择,那就是 MQTTNET
地址如下:https://github.com/chkr1011/MQTTnet
那个库在最近几个版本升级的过程中,更改了一些api接口,造成了大家的困惑,所以我在hsl中也提供了mqtt的实现类,用法很简单。现在来介绍一下
联系作者及加群方式:http://www.hslcommunication.cn/Cooperation
在Visual Studio 中的NuGet管理器中可以下载安装,也可以直接在NuGet控制台输入下面的指令安装:
1
|
Install-Package HslCommunication |
如果需要教程:Nuget安装教程:http://www.cnblogs.com/dathlin/p/7705014.html
组件的完整信息和API介绍参照:http://www.cnblogs.com/dathlin/p/7703805.html 组件的使用限制,更新日志,都在该页面里面。
本库的demo源代码地址:https://github.com/dathlin/HslCommunication
如果想要联系作者,请访问官网: http://www.hslcommunication.cn/
MQTT的客户端的教程:https://www.cnblogs.com/dathlin/p/11631894.html
测试的MQTT界面如下:
如果需要客户端,hsl的demo也提供了可供直接快速测试的客户端。
各位方便的话,可以从git上下载代码下来,自己测试一下。基本看代码的话,就可以看懂相关的操作了。此处还是稍微讲解下如何创建服务器信息
首先从nuget安装 hslcommunication 组件,这个应该很简单的,如果不会的话,可以参照下面的地址的文章
https://www.cnblogs.com/dathlin/p/7705014.html
好的,我们来看下最简单的代码
private MqttServer mqttServer = new MqttServer( );
然后启动系统
mqttServer.ServerStart(1883);
好了,这就启动了一个系统了。那么其他的客户端可以发布订阅操作信息了。
现在我们往前进一步,我希望在服务器端把所有的客户端发过来的数据都打印出来,那么如下的操作即可
mqttServer.OnClientApplicationMessageReceive += MqttServer_OnClientApplicationMessageReceive;
这个绑定的方法参考下面,直接简单的打印出来
private void MqttServer_OnClientApplicationMessageReceive( MqttSession session, MqttClientApplicationMessage message ) { Invoke( new Action( ( ) => { textBox8.AppendText( $"Cliend Id[{message.ClientId}] Topic:[{message.Topic}] Payload:[{Encoding.UTF8.GetString( message.Payload )}]" + Environment.NewLine ); } ) ); }
上述的代码是在textbox8里面将所有的客户端信息显示出来。当然,你可以进行额外的处理。例如,这个客户端的发布的数据是无效的危险数据,禁止推送给其他的客户端,那么可以如下操作
private void MqttServer_OnClientApplicationMessageReceive( MqttSession session, MqttClientApplicationMessage message ) { message.IsCancelPublish = true; }
这样的话,这条消息就到服务器为止,不管客户端有没有订阅,都不会推送出去了。
如果我们想验证客户端的连接,比如,必须如果用户名和密码,或是限定客户端的ID信息。那么可以如下的操作。
mqttServer.ClientVerification += MqttServer_ClientVerification;
绑定的方法如下
private int MqttServer_ClientVerification( string clientId, string userName, string passwrod ) { if(userName == "admin" && passwrod == "123456") { return 0; // 成功 } else { return 5; // 账号密码验证失败 } }
此处举了个例子,限定了账户名 admin 密码 123456 的信息。
如果在客户端刚连接上服务器后,需要返回客户端的信息的话,可以绑定一个事件
mqttServer.OnClientConnected += MqttServer_OnClientConnected;
绑定的方法内容如下:
private void MqttServer_OnClientConnected( MqttSession session ) { // 当客户端连接上来时,可以立即返回一些数据内容信息 mqttServer.PublishTopicPayload( session, "HslMqtt", Encoding.UTF8.GetBytes( "This is a test message" ) ); }
这样的话,所有的客户端在连接服务器的时候,可以返回一串数据信息。
接下来介绍下如何发送数据给客户端,从服务器端进行发布数据
mqttServer.PublishTopicPayload( "A", Encoding.UTF8.GetBytes( "iaishdasd" ) );
这里举例了,从服务器进行发布数据信息,默认消息不驻留,如果要消息驻留(意思就是客户端订阅的一瞬间,如果服务器就消息驻留,立即返回给客户端,而不是等到发布)
mqttServer.PublishTopicPayload( "A", Encoding.UTF8.GetBytes( "iaishdasd" ), true );
好了,如果我们想要针对clientId为 1000 的客户端发布数据呢?
mqttServer.PublishTopicPayload( "1000", "A", Encoding.UTF8.GetBytes( "asd" ) );
记下来看看,我们强制给所有的客户端发布数据的情况,而不管客户端有没有订阅
mqttServer.PublishAllClientTopicPayload( "A", Encoding.UTF8.GetBytes( "asd" ) );
如果需要查看日志信息有个 LogNet属性,可以参照demo实例化。更多的信息请参照demo的操作示例。