JiuLing.CommonLibs 1.0.1

一个基于.NET 5的通用类库

一个.NET 5下整理的通用类库。

1️⃣ 项目初衷

新建项目后，经常发现连个string.IsEmpty()都没有、想要个Json的通用返回值吧，也没有:disappointed_relieved::disappointed_relieved:，当然，还有等等等等等等等等。。。所以我决定整理并集成一下自己平时用的比较多的一些工具类，然后发布到NuGet，以后走哪用哪啊有木有~~

2️⃣ 使用说明

• 类库中以Utils结尾的类，都提供了静态方法，可以直接调用
• 类库中的命名空间和类名，尽量与.NET保持一致

Collections命名空间

该命名空间下是一些集合相关的类

• DictionaryComparer类：Dictionary对象对比工具

  var x = new Dictionary<string, string>();
  x.Add("a1", "b1");
  var y = new Dictionary<string, string>();
  y.Add("a1", "b1");
  Assert.IsTrue(_myComparer.Equals(x, y));
  

ExtensionMethods命名空间

该命名空间下是一些通用的扩展方法

• EnumExtension类：枚举类型的扩展方法

  public enum MyEnum
  {
      [Description("一")]
      One,
      [Description("二")]
      Two,
      Three
  }
  
  //获取枚举的描述信息，下面的例子将返回“一”
  MyEnum.One.GetDescription();
  //如果枚举字段没有设置Description特性，将返回自身的ToString()形式，下面的例子将返回“Three”
  MyEnum.Three.GetDescription();
  

• StringExtension类：字符串类型的扩展方法

  "abc".IsEmpty();  //字符串是否为空
  "abc".IsNotEmpty();  //字符串是否不为空
  "https://jiuling.me".ToUri();  //将字符串转为Uri对象
  

Log命名空间

该命名空间下是一些通用的日志帮助类

• ILogger接口：负责简单的日志的写入

  ILogger logger = LogManager.GetLogger();
  // logger.SetLogDirectory("C:\\")      //设置日志文件的路径，默认为“程序集路径\log”
  //     .SetFileNameFormat("yyyyMMdd")  //设置日志文件名的格式，默认为“yyyy-MM-dd”
  //     .SetFileExpandedName(".txt");   //设置日志文件的扩展名，默认为“.log”
  logger.Write("test");
  

Model命名空间

该命名空间下是一些通用的数据模型

• JsonResult类：一个通用的Json返回值模型

  public class JsonResult<T>
  {
      public int Code { get; set; }
      public string Message { get; set; }
      public T Data { get; set; }
  }
  

Net命名空间

该命名空间下是网络相关的类

• CookieUtils类：Cookie相关的工具

  //将CookieContainer转换为指定格式的字符串形式，方便本地储存
  public static string CookieContainerToString(CookieContainer cookieContainer);
  
  //将指定格式的字符串转换为CookieContainer
  public static CookieContainer StringToCookieContainer(string cookies);
  

• HttpClientHelper类：网络请求类工具，使用HttpClient实现

  //异步发送一个GET请求，返回一个字符串
  public async Task<string> GetReadString(string url);
  
  //异步发送一个GET请求，返回一个字节数组
  public async Task<byte[]> GetReadByteArray(string url);
  
  //异步发送一个表单形式的Post请求，返回一个字符串
  public async Task<string> PostFormReadString(string url, IEnumerable<KeyValuePair<string, string>> data);
  
  //异步发送一个表单形式的Post请求，返回一个字节数组
  public async Task<byte[]> PostFormReadByteArray(string url, IEnumerable<KeyValuePair<string, string>> data)
  

Random命名空间

该命名空间下是一些随机数相关的类

• RandomUtils类：随机数帮助类

  RandomUtils.GetOneByLength();    //返回一个长度为10的随机数
  RandomUtils.GetOneByLength(20);  //返回一个长度为20的随机数
  
  //方法定义  T GetOneFromList<T>(IList<T> input)
  //随机返回list中的一个元素
  var list = new List<string>();
  list.Add("a");
  list.Add("b");
  RandomUtils.GetOneFromList<string>(list);
  

Text命名空间

该命名空间下是一些文本处理的类

• RegexUtils类：正则表达式相关的类

  //文本是否与正则表达式匹配
  RegexUtils.IsMatch(111,@"\d{3}");
  
  //返回正则表达式的第一个匹配项；返回test12
  RegexUtils.GetFirst("test123test456", @"test\d{2}");
  
  //返回正则表达式匹配到的所有项
  RegexUtils.GetAll(input, pattern);
  
  //按照正则表达式分组名称返回第一个匹配项；a="jiuling"
  string a=GetOneGroupInFirstMatchTest("name:jiuling;age:0;",@"name:(?<name>\w*);");
  
  //按照正则表达式分组名称返回所有匹配项；obj.name="jiuling"  obj.age="0" 
  dynamic obj=RegexUtils.GetMultiGroupInFirstMatch("name:jiuling;age:0;",@"name:(?<name>\w*);age:(?<age>\w*);");
  

• TimestampUtils类：时间戳相关的类

  //获取一个10位的时间戳
  TimestampUtils.GetLen10();
  
  //获取一个13位的时间戳
  TimestampUtils.GetLen13();
  
  //将时间转换为一个10位的时间戳   1626961721
  TimestampUtils.ConvertToLen10("2021-07-22 21:48:41");
  
  //将时间转换为一个13位的时间戳   1626961721000
  TimestampUtils.ConvertToLen13("2021-07-22 21:48:41");
  
  //将10位或13位的时间戳转换为一个DateTime对象（该方法会自动判断长度）   2021-07-22 21:48:41
  TimestampUtils.ConvertToDateTime(1626961721000)
  

Threading命名空间

该命名空间下是一些线程相关的类

• ThreadUtils类：线程帮助类

  //随机将线程挂起1-10秒
  ThreadUtils.SleepRandomSecond(1,10);
  
  //随机将线程挂起1-10毫秒
  ThreadUtils.SleepRandomMillisecond(2000, 5000);
  

3️⃣ License

本项目基于MIT License