雄关漫道真如铁，而今迈步从头越。从头越，苍山如海，残阳如血。
中文 | English
🎀 描述
【开源版】
| 名称 | 地址 | 描述 |
|---|---|---|
|
Gitee Github |
TouchSocket这是一个轻量级的、支持插件的综合网络通信库。 基础通信功能包含Tcp、Udp、Ssl、Rpc、Http等。其中http 服务器支持WebSocket、静态网页、XmlRpc、WebApi、JsonRpc 等扩展插件。和自定义协议的TouchRpc，支持Ssl加密、异步调用、 权限管理、错误状态返回、服务回调、分布式调用等。在空载函数 执行时，10万次调用仅3.8秒，在不返回状态时，仅0.9秒。 |
 |
Gitee Github |
TouchSocket.AspNetCore是适用于AspNetCore的专属版本。 |
【企业版】
| 名称 | 地址 | 描述 |
|---|---|---|
 |
Gitee Github |
TouchSocketPro是TouchSocket的企业版，这在原有基础之上， 还有一些企业版功能，详情请看企业版相关 |
 |
Gitee Github |
TouchSocketPro.AspNetCore是适用于AspNetCore的专属版本。 |
特别声明
TouchSocket项目已加入dotNET China 组织。
🖥 支持环境
- .NET Framework4.5及以上。
- .NET Core3.1及以上。
- .NET Standard2.0及以上。
🥪支持框架
- Console
- WPF
- Winform
- Blazor Server
- Xamarin
- MAUI
- Avalonia
- Mono
- Unity 3D（除WebGL）
- 其他（即所有C#系）
🌴 TouchSocket特点速览
传统IOCP和TouchSocket的IOCP模式
TouchSocket的IOCP和传统也不一样，就以微软官方示例为例，他是使用MemoryBuffer开辟一块内存，均分，然后给每个会话分配一个区接收，等收到数据后，再复制接收的数据，然后把复制的数据进行处理。而TouchSocket是每次接收之前，从内存池拿一个可用内存块，然后直接用于接收，等收到数据以后，直接就把这个内存块抛出处理，这样就避免了复制操作，虽然只是细小的设计，但是在传输10w次64kb的数据时，性能相差了10倍。
数据处理适配器
相信大家都使用过其他的Socket产品，那么TouchSocket在设计时也是借鉴了其他产品的优秀设计理念，数据处理适配器就是其中之一，但和其他产品的设计不同的是，TouchSocket的适配器功能更加强大，易用，且灵活。它不仅可以提前解析数据包，还可以解析数据对象，可以随时替换，然后立即生效。例如：可以使用固定包头对数据进行预处理，从而解决数据分包、粘包的问题。也可以直接解析HTTP数据协议、WebSocket数据协议等。
兼容性与适配
TouchSocket提供多种框架模型，能够完全兼容基于TCP、UDP协议的所有协议。例如：TcpService与TcpClient，其基础功能和Socket一模一样，只是增强了框架的坚固性和并发性，将连接和接收数据通过事件的形式抛出，让使用者能够更加友好的使用。
🔗 联系作者
🌟 说明文档
👑 功能导图
✨ 简单示例
以下仅以最简方式创建示例，更多详情请查看说明文档。
【TcpService】
TcpService service = new TcpService();
service.Connecting = (client, e) => { };//有客户端正在连接
service.Connected = (client, e) => { };//有客户端连接
service.Disconnected = (client, e) => { };//有客户端断开连接
service.Received = (client, byteBlock, requestInfo) =>
{
//从客户端收到信息
string mes = byteBlock.ToString();
Console.WriteLine($"已从{client.ID}接收到信息：{mes}");
client.Send(mes);//将收到的信息直接返回给发送方
//client.Send("id",mes);//将收到的信息返回给特定ID的客户端
var clients = service.GetClients();
foreach (var targetClient in clients)//将收到的信息返回给在线的所有客户端。
{
if (targetClient.ID != client.ID)
{
targetClient.Send(mes);
}
}
};
service.Setup(new TouchSocketConfig()//载入配置
.SetListenIPHosts(new IPHost[] { new IPHost("127.0.0.1:7789"), new IPHost(7790) }))//同时监听两个地址
.Start();//启动【TcpClient】
TcpClient tcpClient = new TcpClient();
tcpClient.Connected = (client, e) => { };//成功连接到服务器
tcpClient.Disconnected = (client, e) => { };//从服务器断开连接，当连接不成功时不会触发。
tcpClient.Received = (client, byteBlock, requestInfo) =>
{
//从服务器收到信息
string mes = Encoding.UTF8.GetString(byteBlock.Buffer, 0, byteBlock.Len);
Console.WriteLine($"接收到信息：{mes}");
};
//声明配置
TouchSocketConfig config = new TouchSocketConfig();
config.SetRemoteIPHost(new IPHost("127.0.0.1:7789"))
.UsePlugin()
.SetBufferLength(1024 * 10);
//载入配置
tcpClient.Setup(config);
tcpClient.Connect();
tcpClient.Send("RRQM");【TcpClient 断线重连】 在Config的插件配置中，首先得启用插件，然后使用重连插件即可。
.UsePlugin()
.ConfigurePlugins(a=>
{
a.UseReconnection(5, true, 1000);
});【FixedHeaderPackageAdapter包模式】
该适配器主要解决TCP粘分包问题，数据格式采用简单而高效的“包头+数据体”的模式，其中包头支持：
- Byte模式（1+n），一次性最大接收255字节的数据。
- Ushort模式（2+n），一次最大接收65535字节。
- Int模式（4+n），一次最大接收2G数据。
以上数据头均采用TouchSocketBitConverter的默认端模式（小端模式），使用者可以根据需求切换默认端模式。
TouchSocketBitConverter.DefaultEndianType = EndianType.Little;【CustomFixedHeaderDataHandlingAdapter】
用户自定义固定包头适配器，主要帮助用户解决具有固定包头的数据帧信息。例如：下列数据格式，仅需要实现几个接口，就能完成解析，详细操作请参照API。
|1|1|1|**********|
【CustomUnfixedHeaderDataHandlingAdapter】
用户自定义不固定包头适配器，主要帮助用户解决具有包头不固定的数据帧信息。例如：最典型的HTTP数据包，其数据头和数据体由“\r\n”隔开，而数据头又因为请求者的请求信息的不同，头部数据也不固定，而数据体的长度，也是由数据头的ContentLength的值显式指定的，所以可以考虑使用CustomUnfixedHeaderDataHandlingAdapter解析，也是仅通过简单的开发，就能实现。
致谢
谢谢大家对TouchSocket的支持，如果还有其他问题，请提交Issue，或者加群QQ：234762506讨论。
感谢下列工具软件的支持