【开源项目】C#.NET 扩展库 -- Com.Gitusme.Net.Extensiones.Core
目录
1、项目介绍
2、集成方式
方法一：项目中通过Nuget包管理器安装导入
方法二：手动从Nuget官网下载，下载地址：
3、代码中导入命名空间
4、版本变更说明
1.0.7 版本
1.0.6 版本
1.0.5 版本
1.0.4 版本
5、演示示例
示例 1：使用string, object扩展进行类型转换
示例 2：使用this指针在任意类中打印日志
示例 3：创建Socket服务端与客户端通信
1、项目介绍
Com.Gitusme.Net.Extensiones.Core 是一个 C#.Net 扩展库。当前最新 1.0.7 版本，使用方便快捷，能够减少代码量，提高编程效率。基于 .Net Standard 2.0 开发，支持 windows、linux、IOS 等多平台。
2、集成方式
方法一：项目中通过Nuget包管理器安装导入
选择项目，右键菜单，打开 NuGet 程序包 管理，搜索 ”Com.Gitusme.Net.Extensiones.Core“ 关键字，安装最新版本。
方法二：手动从Nuget官网下载，下载地址：
https://www.nuget.org/packages/Com.Gitusme.Net.Extensiones.Core
3、代码中导入命名空间
using Com.Gitusme.Net.Extensions.Core;
4、版本变更说明
-
1.0.7 版本
- 修复Sokcet套接字重大BUG，增强可靠性；
-
1.0.6 版本
-
新增Sokcet套接字扩展。简化Socket操作，支持自定义命令封装，使用方便快捷，让您聚焦业务实现，而不必关心底层逻辑，提高开发效率。详情请参考演示示例章节。
-
日志功能增强。新版本支持日志的相关参数配置，默认文件路径为程序集所在目录，文件名： Com.Gitusme.Net.Extensiones.Core.Settings.xml
-
-
1.0.5 版本
- 新增日志记录功能，支持 DEBUG，INFO，WARN，ERROR 级别，默认日志输出路径为程序集所在同级Log文件夹。使用方法简单，在任意class中，通过 this 打印日志。详情请参考演示示例章节。
-
1.0.4 版本
- 新增 String，Object 类扩展，提供方便快捷的类型转换。详情请参考演示示例章节。
5、演示示例
示例 1：使用string, object扩展进行类型转换
// Example 1: 判断string是否为null
string str = null;
if (str.IsNullOrEmpty())
{
System.Console.WriteLine("Example 1 输出结果:" + "null");
}
// Example 2: 判断string是否匹配正则
string hello = "Hello, gitusme";
var isMatch = hello.IsMatch(@"Hello, \w+");
System.Console.WriteLine("Example 2 输出结果:" + isMatch);
// Example 3: 将string转换为Json实体对象
string json = "{\"Id\":0,\"Name\":\"Json Object\"}";
var jsonObj = json.ToJsonObject<MyJsonObject>();
System.Console.WriteLine("Example 3 输出结果:" + jsonObj.Name);
// Example 4: 将string转换为Xml实体对象
string xml = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
"<root xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" id=\"0\">" +
"<name>Xml Object</name>" +
"</root>";
var xmlObj = xml.ToXmlObject<MyXmlObject>();
System.Console.WriteLine("Example 4 输出结果:" + xmlObj.Name);
// Example 5: 将string转换为DateTime
string date = "2023/10/22 21:32:00";
var dateTime = date.ToDateTime();
System.Console.WriteLine("Example 5 输出结果:" + dateTime.ToString());
// Example 6: 将string转换为字符数组
string gitusme = "gitusme";
var array = gitusme.ToCharArray();
System.Console.WriteLine("Example 6 输出结果:" + array);
// Example 7: 将string转换为int32
string intStr = "100";
var intValue = intStr.ToInt32() + 10;
System.Console.WriteLine("Example 7 输出结果:" + intValue);
// Example 8: 将string转换为decimal
string decimalStr = "3.141592653589793238462643383279502884197";
var decimalValue = decimalStr.ToDecimal();
System.Console.WriteLine("Example 8 输出结果:" + decimalValue);
// Example 9: 将string转换为uri
string uriStr = "https://github.com/gitusme/Com.Gitusme.Net.Extensiones";
var uriValue = uriStr.ToUri();
System.Console.WriteLine("Example 9 输出结果:" + uriValue.Host);
// Example 10: 将string转换为color
string colorStr = "#aabbcc";
var colorValue = colorStr.ToColor();
System.Console.WriteLine("Example 10 输出结果:" + colorValue);
运行结果：
// Example 1: 判断对象是否为null
MyObject obj = null;
if (obj.IsNull())
{
System.Console.WriteLine("Example 1 输出结果:" + "null");
}
// Example 2: 对象为null的时候，返回传入的默认值
var def = obj.OrDefault(new MyObject());
System.Console.WriteLine("Example 2 输出结果:" + def);
// Example 3: 如果对象不为null，则执行传入的Action行为
def.IfPresent((it) =>
{
System.Console.WriteLine("Example 3 输出结果:" + it.Name);
});
// Example 4: 将Xml对象转换为Xml文本
var xmlObj = new MyXmlObject();
string xml = xmlObj.ToXml();
System.Console.WriteLine("Example 4 输出结果:" + xml);
// Example 5: 将Json对象转换为Json文本
var jsonObj = new MyJsonObject();
string json = jsonObj.ToJson();
System.Console.WriteLine("Example 5 输出结果:" + json);
运行结果：
示例 2：使用this指针在任意类中打印日志
class MyServer
{
public void Start(string arg1, string arg2)
{
this.Logi("MyServer", "Start:args={0},{1}", arg1, arg2);
}
public void Stop()
{
this.Logi("Stop.....");
}
}
日志输出：
2023-11-04 18:25:16.158 [INFO] [00001] MyServer: Start:args=arg1,arg2
2023-11-04 18:25:16.261 [INFO] [00001] MyServer: Stop.....
示例 3：创建Socket服务端与客户端通信
服务端代码：
客户端代码：
运行结果：
如上示例，演示服务器和客户端的创建和请求应答交互，如需新增命令，可以从 AbstractCommand 派生实现自己的命令，通过CommandFactory来管理命令集。提供ServerSocketListener 和 ClientSocketListener 接口，分别监听服务器和客户端的生命周期。服务器使用 ServerSocketListener.OnAccepted(commandFilter, ISocketHander acceptHandler) 监听新的客户端连接，通过 acceptHandler 来操作客户端的消息交互。
可靠性验证：完美执行10000次Socket创建和收发数据，未出现异常。
最后，感谢您能抽出宝贵的时间认真学习完本篇，实属不易。如果您有好的想法或建议，欢迎点赞加关注，收藏交流和探讨。