在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
About Thrift:
本文并不是说明Thrift设计及原理的,直接拿Thrift来开发一个Demo程序,如果想要了解Thrift的细节,可以访问官方网站:https://thrift.apache.org/ 官方的网站上除了介绍说明外,当然还有白皮书,详细的说明Thrift是干嘛用的。 简单的说,Thrift可以作为一个中间数据站,我们可以将数据丢到Thrift上,等待客户端的请求,而这个客户端可能是C#程序,当然也有可能是java程序,甚至是php,ruby,python等等,就像白皮书的介绍一样,一个灵活的,可伸缩的,多语言的服务集成。
About Demo:
关于本项目的意图,基于对Thrift简单的学习后,就想要拿个Demo进行练手,模拟一些实际的操作,顺便测试测试一些东西,加强自己对Thrift的理解,才能判别这个技术是否真的适合你。 大致介绍下本项目,本项目主体功能是,服务器端程序不停的读取西门子PLC进行数据更新,并将数据刷新到Thrift,客户端调用Thrift服务来访问服务器的数据,除此之外,实现一个操作,在客户端做一个按钮,点击按钮后,将一个数据(通过服务器程序中转)写入到PLC中,并返回是否写入成功的标记。 其他的功能就是测试测试连接稳定性,网络重连机制的试验。
Getting Started说了那么多,赶紧开始吧,此处我的IDE时VS2017,先创建一个简单的winform项目吧。在这个解决方案里,共创建2个窗体程序,一个服务端,一个客户端,再创建一个库项目,用来生成客户端和服务器共用的代码服务。就像下面这样子
接下来我们既然要读取PLC的数据,使用Thrift技术。那么我们就要进行安装相关的插件支持,我们在NuGet界面上进行安装两个插件,Thrift和HslCommunication,对于Thrift而言,三个项目都需要安装,对于HslCommunication只需要安装到服务器: 安装HslCommunication OK,到这里为止,我们前期的准备工作基本完成,接下来需要设计读取的数据和实现的功能,以这个为前提去设计Thrift的实现接口。
程序架构设计如下:
有了上述的基础设计后,接下来就是设计Thrift这一层希望提供什么样子的接口操作了,此处我们就举一些简单的例子,首先呢,设备不会只有一台,我们就假设有好多台设备,每台设备有如下参数信息:
然后在Thrift中,我们希望公开的数据有获取单台设备的信息,也有针对报警中的统计信息。获取所有设备运行状态的json数据,所有设备报警状态的json数据,单独获取所有设备的温度数据,单独获取所有设备的压力值,最后再提供一个允许手动更改设备状态的接口,参考了官方的白皮书(地址为:https://thrift.apache.org/static/files/thrift-20070401.pdf),最终完成的Demo.thrift文件如下: 这个文件存放的目录在下面这个目录,和安装thrift的package目录一致: 接下来就是调用上图中的thrift-0.9.1.exe来生成代码了,具体方式如下: 打开电脑的cmd指令(也就是命令提示符): 然后cd到上面的目录里去,指令为cd /d 目录,结果如下: 输入thrift-0.9.1.exe -help ok,到这里为止,我们知道了怎么去生成C# 代码了:指令如下:thrift-0.9.1.exe --gen csharp Demo.thrift
然后我们就看到路径下多了一个文件夹 点进去后就是: 就是我们之前填写的信息生成的文件。接下来,把这两个文件添加到一开始我们创建的三个项目的Common项目中去:
重新生成Common项目,OK,到这里为止,我们前期的任务都完成了,接下来就是真正写代码的时候了。
Server Implementation在Server端要做的第一件事就是添加对Common项目生成的dll组件的引用,第二件事是创建一个类,继承Common项目中的一个接口:如下: namespace Thrift.Server { public class PublicServiceHandle : ThriftInterface.PublicService.Iface { public int GetAlarmCount() { throw new NotImplementedException(); } public List<MachineOne> GetAllMachineOnes() { throw new NotImplementedException(); } public string GetJsonMachineAlarm() { throw new NotImplementedException(); } public string GetJsonMachinePress() { throw new NotImplementedException(); } public string GetJsonMachineState() { throw new NotImplementedException(); } public string GetJsonMachineTemp() { throw new NotImplementedException(); } public MachineOne GetMachineOne(string machineId) { throw new NotImplementedException(); } public int GetRunningCount() { throw new NotImplementedException(); } public bool SetMachineRunState(string machineId, int state) { throw new NotImplementedException(); } } } 接下来就实现这些具体代码了。 namespace Thrift.Server { public class PublicServiceHandle : ThriftInterface.PublicService.Iface { #region Constructor /// <summary> /// 实例化一个对象 /// </summary> public PublicServiceHandle(Func<string,int,bool> write) { // 初始化数据 list = new List<MachineOne>() { new MachineOne() { Name = "测试设备", Id = "1#", IpAddress = "192.168.1.195", }, new MachineOne() { Name = "测试设备", Id = "2#", }, new MachineOne() { Name = "测试设备", Id = "3#", }, new MachineOne() { Name = "测试设备", Id = "4#", }, new MachineOne() { Name = "测试设备", Id = "5#", }, new MachineOne() { Name = "测试设备", Id = "6#", }, new MachineOne() { Name = "测试设备", Id = "7#", }, new MachineOne() { Name = "测试设备", Id = "8#", }, new MachineOne() { Name = "测试设备", Id = "9#", }, new MachineOne() { Name = "测试设备", Id = "10#", }, }; hybirdLock = new HslCommunication.Core.SimpleHybirdLock(); FuncWriteIntoPlc = write ?? throw new ArgumentNullException("write"); } #endregion #region Private Member private List<MachineOne> list; // 总的数据仓库 private HslCommunication.Core.SimpleHybirdLock hybirdLock; // 混合同步锁,比Lock性能要高的多 private Func<string, int, bool> FuncWriteIntoPlc; // 写入数据的委托,最终实现在外层 #endregion #region Public Method /// <summary> /// 更新一台设备的数据,这个数据最终来自PLC /// </summary> /// <param name="id"></param> /// <param name="content"></param> public void UpdateMachineOne(string id, byte[] content) { if (content == null) return; hybirdLock.Enter(); for (int i = 0; i < list.Count; i++) { if (list[i].Id == id) { byte[] buffer = new byte[4]; // 获取运行状态 Array.Copy(content, 0, buffer, 0, 4); Array.Reverse(buffer); list[i].RunState = BitConverter.ToInt32(buffer, 0); // 获取报警状态 Array.Copy(content, 4, buffer, 0, 4); Array.Reverse(buffer); list[i].AlarmState = BitConverter.ToInt32(buffer, 0); // 其实信息参照这个就行 break; } } hybirdLock.Leave(); } #endregion #region PublicService.Interface /// <summary> /// 获取当前报警的机台数 /// </summary> /// <returns></returns> public int GetAlarmCount() { int count = 0; hybirdLock.Enter(); for (int i = 0; i < list.Count; i++) { if (list[i].AlarmState != 0) count++; } hybirdLock.Leave(); return count; } /// <summary> /// 获取所有设备的所有信息,一般不建议这么做 /// </summary> /// <returns></returns> public List<MachineOne> GetAllMachineOnes() { return new List<MachineOne>(list); } /// <summary> /// 获取当前所有机台的报警信息 /// </summary> /// <returns></returns> public string GetJsonMachineAlarm() { JArray jArray = new JArray(); hybirdLock.Enter(); for (int i = 0; i < list.Count; i++) { JObject json = new JObject(); json.Add(nameof(MachineOne.Name), new JValue(list[i].Name)); json.Add(nameof(MachineOne.Id), new JValue(list[i].Id)); json.Add(nameof(MachineOne.AlarmState), new JValue(list[i].AlarmState)); jArray.Add(json); } hybirdLock.Leave(); return jArray.ToString(); } /// <summary> /// 获取当前所有机台的压力值 /// </summary> /// <returns></returns> public string GetJsonMachinePress() { JArray jArray = new JArray(); hybirdLock.Enter(); for (int i = 0; i < list.Count; i++) { JObject json = new JObject(); json.Add(nameof(MachineOne.Name), new JValue(list[i].Name)); json.Add(nameof(MachineOne.Id), new JValue(list[i].Id)); json.Add(nameof(MachineOne.Press), new JValue(list[i].Press)); jArray.Add(json); } hybirdLock.Leave(); return jArray.ToString(); } /// <summary> /// 获取当前所有机台的状态 /// </summary> /// <returns></returns> public string GetJsonMachineState() { JArray jArray = new JArray(); hybirdLock.Enter(); for (int i = 0; i < list.Count; i++) { JObject json = new JObject(); json.Add(nameof(MachineOne.Name), new JValue(list[i].Name)); json.Add(nameof(MachineOne.Id), new JValue(list[i].Id)); json.Add(nameof(MachineOne.RunState), new JValue(list[i].RunState)); jArray.Add(json); } hybirdLock.Leave(); return jArray.ToString(); } /// <summary> /// 获取当前所有机台的温度 /// </summary> /// <returns></returns> public string GetJsonMachineTemp() { JArray jArray = new JArray(); hybirdLock.Enter(); for (int i = 0; i < list.Count; i++) { JObject json = new JObject(); json.Add(nameof(MachineOne.Name), new JValue(list[i].Name)); json.Add(nameof(MachineOne.Id), new JValue(list[i].Id)); json.Add(nameof(MachineOne.Temp), new JValue(list[i].Temp)); jArray.Add(json); } hybirdLock.Leave(); return jArray.ToString(); } /// <summary> /// 获取单独的一台设备信息 /// </summary> /// <param name="machineId"></param> /// <returns></returns> public MachineOne GetMachineOne(string machineId) { // 这里需要不需要使用克隆对象?不太清楚,直接返回列表的对象会不会有影响? return list.Find(m => m.Id == machineId); } /// <summary> /// 获取当前正在运行的总的机台数 /// </summary> /// <returns></returns> public int GetRunningCount() { int count = 0; hybirdLock.Enter(); for (int i = 0; i < list.Count; i++) { if (list[i].RunState == 1) count++; } hybirdLock.Leave(); return count; } /// <summary> /// 设置设备的运行状态 /// </summary> /// <param name="machineId"></param> /// <param name="state"></param> /// <returns></returns> public bool SetMachineRunState(string machineId, int state) { // 按道理说这个方法应该向PLC进行数据写入,但是具体的实现不应该在这一层 return FuncWriteIntoPlc(machineId, state); } #endregion } }
主要功能就是实例化了一个数组,拥有十个设备,我们只有一台PLC,就模拟读取一个就行了,但数组的操作需要加同步锁,这里我们还要添加一个写入数据的功能,这个功能应该在外面实现。至此,我们可以开发真正的服务器代码了: server上项目的form1窗口上添加两个按钮,分别为启动,和停止,都触发一个事件,然后在代码里完成Thrift的初始化: private PublicServiceHandle handler; private TServer server; private void userButton1_Click(object sender, EventArgs e) { new System.Threading.Thread(() => { // 启动服务 handler = new PublicServiceHandle(WritePlc); var processor = new ThriftInterface.PublicService.Processor(handler); TServerTransport transport = new TServerSocket(9090); server = new TThreadPoolServer(processor, transport); server.Serve(); }) { IsBackground = true }.Start(); // 启动定时器去读取PLC数据 timerReadPLC.Start(); } private void userButton2_Click(object sender, EventArgs e) { // 关闭服务 server?.Stop(); }
接下来需要完成读取PLC数据,并提供一个方法WritePlc实现数据的真正写入,此处由于我只有一个PLC所以,就方便实现了读写,不再区分多个设备。 #region PLC Connection private SiemensTcpNet siemensTcp; // 和PLC的核心连接引擎 private Timer timerReadPLC; // 读取PLC的定时器 #endregion private void Form1_Load(object sender, EventArgs e) { siemensTcp = new SiemensTcpNet(SiemensPLCS.S1200) { PLCIpAddress = System.Net.IPAddress.Parse("192.168.1.195") }; // 连接到PLC siemensTcp.ConnectServer(); timerReadPLC = new Timer(); timerReadPLC.Interval = 1000; timerReadPLC.Tick += TimerReadPLC_Tick; } private void TimerReadPLC_Tick(object sender, EventArgs e) { // 每秒执行一次去读取PLC数据,此处简便操作,放在前台执行,正常逻辑应该放到后台 HslCommunication.OperateResult<byte[]> read = siemensTcp.ReadFromPLC("M100", 24); if(read.IsSuccess) { handler.UpdateMachineOne("1#", read.Content); } else { // 读取失败,应该提示并记录日志,此处省略 } } private bool WritePlc(string id, int value) { // 按道理根据不同的id写入不同的PLC,此处只有一个PLC,就直接写入到一个PLC中 return siemensTcp.WriteIntoPLC("M100", value).IsSuccess; } 到这里为止,我们已经把服务器端的程序都已经开发完成了,已经可以生成并运行了。
Client Implementation服务器端开发完成后,客户端就相对容易多了,实例化变量名,并初始化后,就可以随便使用了: private ThriftInterface.PublicService.Client client; private void Form1_Load(object sender, EventArgs e) { var transport = new TSocket("localhost", 9090); var protocol = new TBinaryProtocol(transport); client = new ThriftInterface.PublicService.Client(protocol); transport.Open(); // 启动后台线程实时更新机器状态 thread = new System.Threading.Thread(ThreadRead); thread.IsBackground = false; thread.Start(); }
增加几个按钮及显示框之后,增加一个定时读取服务器各机台状态并实时更新界面的功能:
System.Threading.Thread thread; private void ThreadRead() { while(true) { System.Threading.Thread.Sleep(1000); JArray jArray = JArray.Parse(client.GetJsonMachineState()); int[] values = new int[10]; // 解析开始 for (int i = 0; i < jArray.Count; i++) { JObject json = (JObject)jArray[i]; values[i] = json[nameof(ThriftInterface.MachineOne.RunState)].ToObject<int>(); } if(IsHandleCreated) Invoke(new Action(() => { label1.Text = values[0].ToString(); label2.Text = values[1].ToString(); label3.Text = values[2].ToString(); label4.Text = values[3].ToString(); label5.Text = values[4].ToString(); label6.Text = values[5].ToString(); label7.Text = values[6].ToString(); label8.Text = values[7].ToString(); label9.Text = values[8].ToString(); label10.Text = values[9].ToString(); })); } } private void ShowMessage(string msg) { if(textBox1.InvokeRequired) { textBox1.Invoke(new Action<string>(ShowMessage), msg); return; } textBox1.AppendText(DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss ") + msg + Environment.NewLine); } private void userButton1_Click(object sender, EventArgs e) { // 读取运行中机台总数 ShowMessage(client.GetRunningCount().ToString()); } private void userButton2_Click(object sender, EventArgs e) { // 读取报警中机台总数 ShowMessage(client.GetAlarmCount().ToString()); } private void userButton3_Click(object sender, EventArgs e) { // 读取所有的报警信息 ShowMessage(client.GetJsonMachineAlarm()); } private void userButton4_Click(object sender, EventArgs e) { // 读取所有的压力信息 ShowMessage(client.GetJsonMachinePress()); } private void userButton5_Click(object sender, EventArgs e) { // 读取所有的运行信息 ShowMessage(client.GetJsonMachineState()); } private void userButton6_Click(object sender, EventArgs e) { // 读取所有的温度信息 ShowMessage(client.GetJsonMachineTemp()); } private void userButton7_Click(object sender, EventArgs e) { // 读取指定机台信息 ThriftInterface.MachineOne machine = client.GetMachineOne("1#"); } private void userButton8_Click(object sender, EventArgs e) { // 强制机台启动 if(client.SetMachineRunState("1#",1)) { ShowMessage("写入成功!"); } else { ShowMessage("写入失败!"); } } private void userButton10_Click(object sender, EventArgs e) { // 强制机台停止 if(client.SetMachineRunState("1#",0)) { ShowMessage("写入成功!"); } else { ShowMessage("写入失败!"); } } private void userButton9_Click(object sender, EventArgs e) { // 用于高频多线程压力测试 new System.Threading.Thread(ThreadReadManyTimes) { IsBackground = true, Name = "1" }.Start(); new System.Threading.Thread(ThreadReadManyTimes) { IsBackground = true, Name = "2" }.Start(); new System.Threading.Thread(ThreadReadManyTimes) { IsBackground = true, Name = "3" }.Start(); } private void ThreadReadManyTimes() { for (int i = 0; i < 1000; i++) { client.GetRunningCount(); } ShowMessage(System.Threading.Thread.CurrentThread.Name + "完成!"); }
所有的代码都已经写完,接下来就是最终演示了:
但是在三条线程的压力测试中,会出现异常,内部同步机制可能没有做好,不知道什么原因,如果你知道,本人非常感谢!
本项目的github地址:https://github.com/dathlin/ThriftDemo |
2023-10-27
2022-08-15
2022-08-17
2022-09-23
2022-08-13
请发表评论