项目介绍
TouchSocket是一个功能强大且易于使用的.NET 网络通信框架,适用于C#、VB.Net 和 F#等语言。它提供了多种通信模块,包括TCP、UDP、SSL、WebSocket、Modbus等。支持解决TCP黏包分包问题和UDP大数据包分片组合问题。框架支持多种协议模板,快速实现固定包头、固定长度和区间字符等数据报文解析。
TouchSocket能够满足多种网络通信需求,并提供了丰富的使用文档,是.NET开发者进行网络通信开发的优秀选择。
主要特性
一键式解决TCP黏分包问题:通过协议模板,快速实现固定包头、固定长度、区间字符等数据报文解析。 高性能IOCP模式:与传统IOCP模式不同,TouchSocket避免了数据复制操作,显著提升了数据传输性能。 数据处理适配器:支持提前解析数据包和数据对象,可以随时替换并立即生效,灵活且易用。
TouchSocket提供多种框架模型,能够完全兼容基于TCP、UDP协议的所有协议。例如:TcpService与TcpClient,其基础功能和Socket一模一样,只是增强了框架的坚固性和并发性,将连接和接收数据通过事件的形式抛出,让使用者能够更加友好的使用。
支持环境
.NET Framework4.5及以上。 .NET 6.0及以上。 .NET Standard2.0及以上。
支持框架
Console、WPF、Winform、Blazor、Xamarin、MAUI、Avalonia、Mono、Unity 3D(除WebGL)、其他(即所有C#系)。
功能导图
简单示例
TcpService
TcpService service = new TcpService();
service.Connecting = (client, e) => {return EasyTask.CompletedTask; };//有客户端正在连接
service.Connected = (client, e) => {return EasyTask.CompletedTask; };//有客户端连接
service.Disconnected = (client, e) => {return EasyTask.CompletedTask; };//有客户端断开连接
service.Received = (client, e) =>
{
//从客户端收到信息
string mes = e.ByteBlock.Span.ToString(Encoding.UTF8);
Console.WriteLine($"已从{client.Id}接收到信息:{mes}");
return EasyTask.CompletedTask;
};
await service.StartAsync(7789);//启动
TcpClient
TcpClient tcpClient = new TcpClient();
tcpClient.Connected = (client, e) => {return EasyTask.CompletedTask; };//成功连接到服务器
tcpClient.Disconnected = (client, e) => {return EasyTask.CompletedTask; };//从服务器断开连接,当连接不成功时不会触发。
tcpClient.Received = (client, e) =>
{
//从服务器收到信息
string mes = e.ByteBlock.Span.ToString(Encoding.UTF8);
Console.WriteLine($"接收到信息:{mes}");
return EasyTask.CompletedTask;
};
await tcpClient.ConnectAsync("127.0.0.1:7789");
await tcpClient.SendAsync("Hello");
创建组播服务器
//创建udpService
UdpSession udpService = new UdpSession();
udpService.Received = (remote, e) =>
{
Console.WriteLine(e.ByteBlock.ToString());
return EasyTask.CompletedTask;
};
udpService.Setup(new TouchSocketConfig()
.SetBindIPHost(new IPHost(7789))
.UseBroadcast()
.SetUdpDataHandlingAdapter(() => new NormalUdpDataHandlingAdapter()));
udpService.Start();
//加入组播组
udpService.JoinMulticastGroup(IPAddress.Parse("224.5.6.7"));
发送组播数据
UdpSession udpClient = new UdpSession();
udpClient.Setup(new TouchSocketConfig()
.SetBindIPHost(new IPHost(7788))
.SetUdpDataHandlingAdapter(() => new NormalUdpDataHandlingAdapter()));
udpClient.Start();
udpClient.SendAsync(new IPEndPoint(IPAddress.Parse("224.5.6.7"), 7789), Encoding.UTF8.GetBytes("我是组播"));
开源地址
https://gitee.com/rrqm_home/touchsocket