CommonsUtility 8.2.0

.NET 6.0 .NET Standard 2.0 
dotnet add package CommonsUtility --version 8.2.0
NuGet\Install-Package CommonsUtility -Version 8.2.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="CommonsUtility" Version="8.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add CommonsUtility --version 8.2.0
#r "nuget: CommonsUtility, 8.2.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install CommonsUtility as a Cake Addin
#addin nuget:?package=CommonsUtility&version=8.2.0

// Install CommonsUtility as a Cake Tool
#tool nuget:?package=CommonsUtility&version=8.2.0

[TOC]

魂哥常用工具集（GSA.MOLLE.ToolKits）

功能介绍

本库提供常见和通用的各种助手类合集，支持多种版本（netstandard2.0;netstandard2.1;net6.0;net7.0;net8.0;）。

包括但不限于如下功能类：

  1. CommonHelper (常见和通用的功能应用助手类)
  2. CustomAttributeHelper (自定义属性助手类)
  3. DateTimeHelper (日期与时间帮助类)
  4. ExpressionVisitorToSQL (将条件表达式转换为字符串SQL语句)
  5. ImageHelper (图像辅助操作与处理助手类)
  6. JsonSerializerMappingHelper (JSON序列化数据映射助手类，键值分离JSON序列化)
  7. MockDataHelper (数据模拟助手类)
  8. NetworkHelper (网络与通信助手类)
  9. ReflectionHelper (反射特性应用助手类)
  10. StringHackerHelper (字符串相关操作与处理助手类)
  11. TDataModelHelper (数据模型属性字段名称与值字符串拼接助手类)
  12. UrlHackerHelper (Url相关操作与处理助手类)
  • 鄙人专注.NET技术，深入研习.NET 8系列源码。本库通过长期实践工作积累落地成库，库中提供的所有功能均广泛应用于业务生产环境，同时会不间断地进行功能的优化和完善；
  • 本库均由鄙人采用最新技术实践编码完成，部分功能借鉴于互联网，如有不适请告之，谢谢；
  • 本库可同时满足大、中、小等各式项目的自由支配使用，以提供快捷、便利的工具方法，提升工作效率和业务能力为宗旨。

<br>

开发日志

2023-12-11

  • 经验仔细考量，保留ImageHelper助手类和图像文件转Base64功能，其它图像对象层面操作，则由ToolKits.PictureUtility承载。

2023-12-10

  • 为使本库更为有效的支持跨平台，将剔除相关非跨平台功能，或存在深远影响的所有封装，同时将剔除的功能变更为独立封装库；
  • 剔除图像辅助操作与处理助手类(ImageHelper)及其所有附带功能，迁移至ToolKits.PictureUtility封装库。

2023-12-08

  • 增加将包含图像的数据流存储到指定路径下的图像文件功能。

2023-11-27

  • 修正图像辅助操作与处理助手类中将包含前缀的Base64字符串转换为图像方法的循环调用问题；
  • 调整图像辅助操作与处理助手类中Base64转图像方式，由Image变更为Bitmap对象；
  • 优化图像辅助操作与处理助手类，增加图像格式化类型枚举，修正和调整由Base64字符串保存为图像的功能实现。

2023-11-24

  • 优化图像辅助操作与处理助手类，增加Base64字符串直接落盘存储功能。

2023-11-19

  • 优化图像辅助操作与处理助手类，去掉ImageFormat参数，优化转Base64字符串等编码实现。

2023-11-16

  • 增加图像辅助操作与处理助手类，暂包含Base64与图像的相互转换处理；
  • 更新第三方包引用。

2023-11-15

  • 升级项目到.NET 8.0版本。

2023-10-11

  • 调整所有时间字符串格式化中的毫秒格式，由ffff调整为fff格式。

2023-08-25

  • 优化反射特性应用助手中的属性和字段赋值方法，增加赋值时的强类型转换和结果输出；
  • 优化反射特性应用助手，增加获取属性值和字段值的方法，同时支持强类型的自动转换。

2023-08-01

  • 增加字符串相关操作与处理助手类，用于字符串相关的操作封装；
  • 增加将字符串转换为SQL所支持的单引号包裹格式功能实现。

2023-07-06

  • 获取一个由新的GUID值转HashCode后的ulong数值。

2023-07-05

  • 获取一个由新的GUID值转HashCode后的uint数值。

2023-06-03

  • 反转开发日志时间与内容；
  • 增加使用UTF8编码格式的Base64编码字符串转换方法。

2023-05-19

  • 增加反射特性应用助手类，暂提供属性和字段的反射赋值操作。

2023-03-28

  • 变更原JsonTimestampConverter和JsonTimestampPlusConverter转换器中返回时间格式为正常DateTime格式；
  • 增加返回LocalTime格式的JsonTimestamp2LocalTimeConverter和JsonTimestampPlus2LocalTimeConverter转换器。

2023-03-16

  • 更新第三方包引用版本；
  • 增加批量生成GUID值的功能方法；
  • 增加使用正则表达式从源字符串中提取匹配成功的内容功能方法，同时支持正则表达式数组参数；
  • JSON序列化数据映射助手中增加用于从存储键名称中提取出正确名称的正则表达式；
  • 例如：exp1.@"LAST_ROW((.+?))" exp2.@"LAST((.+?))" exp3.@"FIRST((.+?))"。

2023-02-20

  • 增加GUID格式化类型枚举定义，以满足不同层面的GUID生成需求；
  • 调整常见和通用的功能应用助手中的获取GUID方法，增加格式化和大小写参数，默认为“N”和小写；
  • 优化README.md中的功能库涵盖注解，以及增加部分注释内容等。

2022-11-13

  • 优化数据模拟助手随机生成中文编码；
  • 增加获取指定偏移量与格式的日期时间字符串；
  • 更新第三方包引用。

2022-11-12

  • 全面进入.NET 7时代，将深入研习部分技术体系及源码，增加net7.0独立编译支持；
  • 去掉net5.0独立编译支持，转由netstandard标准库提供支持；
  • 增加数据模拟助手类，暂提供随机生成中文功能。

2022-11-08

  • 修正时间戳JSON自定义转换器中的严重BUG；
  • 增加TryConvertToDateTime方法，自动根据毫秒->秒的解析，如果均失败则返回最小时间；
  • 增加读取Utf8JsonReader时的Number或String判断，并相应获取数值；
  • 调整时间戳JSON自定义转换器，在转换后的时间默认为本地时间。

2022-10-20

  • 修正JSON时间戳自定义转换器的数据转换时逻辑处理及转换方式；
  • 增加增强版JSON时间戳自定义转换器，入参时为时间戳格式，出参时则为字符串格式。

2022-10-13

  • 修正对于ValueTask的使用误解，变更为Task的直接异步形态；
  • 经过查阅相关资料，ValueTask多用于缓存消费，会可能导致返回的对象或结果已释放等。

2022-10-13

  • Url相关操作与处理助手类(UrlHackerHelper)。

2022-10-09

  • 增加网络与通信助手类(NetworkHelper)；
  • 增加物理IP地址和MAC地址获取方法。

2022-09-18

  • 增加元组的JSON序列化自定义转换器，暂时支持1-6个元素的定义。

2022-09-16

  • 为TDataModelHelper类中各方法，增加特别注释内容，以明确其含义；
  • 优化JsonSerializerMappingHelper类中各方法，增加特别注释内容，以明确其含义；
  • 优化JsonSerializerMappingHelper类中主方法实现，增加ColumnAttribute的字段比对应用。

2022-09-07

  • 增加JsonSerializerEnumToStringAttribute功能属性类，用于枚举序列化为字符串；
  • 优化JSON序列化数据映射助手类，增加反序列化键与值分离形态的JSON字符串数据功能；
  • 优化TDataModelHelper类，迁移原ConverterAsync功能方法为独立助手类；
  • 增加多版本(netstandard2.0;netstandard2.1;net5.0;net6.0;)支持，并对部分编码增加条件编译；
  • 优化部分功能类的注释内容，以及本库的功能介绍和打包信息等内容；
  • 发布最新版本。

2022-09-06

  • 优化JsonSerializerMappingIgnoreAttribute类的功能实现，补全注释内容；
  • 变更CommonHelper中NewGUID方法转换大写的使用方式；
  • 为CustomAttributeExtensions类增加namespace System定义，以明确其扩展；
  • 优化DateTimeHelper类中GetTimestamp方法实现，将普通switch变更为模式匹配；
  • 优化JsonSerializerMappingHelper类的功能实现，补全相应的注释内容；
  • 优化TDataModelHelper类中的功能实现，着手为枚举增加字符串取值方式。

2022-09-05

  • 调整TaosInsertIgnoreAttribute为BuildInsertSqlStringIgnoreAttribute名称；
  • 调整TaosSelectIgnoreAttribute为BuildSelectSqlStringIgnoreAttribute名称；
  • 还原TDataModelHelper中的原枚举独立case应用；
  • 增加JsonSerializerMappingIgnoreAttribute类，用于处理映射时的忽略需求；
  • 优化部分类中的注释内容，以期更能匹配其所表示的含义。

2022-09-02

  • 优化自定义属性助手类，完善相关方法的注释内容；
  • 给自定义属性助手类增加example与code的使用示例代码；
  • 优化将条件表达式转换为字符串SQL语句的示例代码内容；
  • 将所有存在示例代码的内容迁移至remarks配置节中；
  • 增加是否存指定泛型对象的自定义属性原生的扩展支持；
  • 增加特别的可为空的类型属性，用于内部另类应用处理；
  • 优化JSON序列化数据映射助手类的功能实现；
  • 优化TDataModelHelper类的整体功能实现，去掉多余方法，以及相关注释内容等。

2022-09-01

  • 优化JSON序列化数据映射助手类的功能实现；
  • 调整JSON序列化数据映射返回值为枚举列表；
  • 更正keyIndex为零时的有效性判断；
  • 增加自定义属性助手类，用于判断是否使用某自定义属性，及获取自定义属性成员元数据；
  • 增加自定义属性扩展类，为MemberInfo和Type提供助手类中的功能扩展支持。

2022-08-31

  • 完成JSON序列化数据映射助手类的功能实现。

2022-08-30

  • 更正全局命名空间定义，并优化部分类的注释内容；
  • 增加用于JSON序列化字段与数据映射的实体类。

2022-08-18

  • 调整DateTimeHelper中的方法名称，使其更贴合功能所具备的涵义；
  • 同步修改DateTimeHelper中各方法相应的注释内容。

2022-08-16

  • 去掉DateTimeHelper类中的多余且然并卵的异步形态；
  • 在考虑异步编程时，即不能为了异步而异步，更不能觉得可以写就写；
  • 异步编程具有传染性质，而且用不好容易导致异步死锁，所以需求讲究一二。

2022-08-02

  • 修复TDataModelHelper中的GetColumnValueString功能实现；
  • 调整名称字符串的追加位置，并调整int[]获取和追加值的方式，遇到空对象时追加空字符串。

2022-07-01

  • 因之前仓促中忘记了重要的命名空间，导致未与之前库形成统一，现在纠正，为此给各位使用者带来不便，表示诚至的歉意，抱歉！！！

2022-06-16

  • 提供JSON序列化转换器、自定义属性方案、数据模型转换助手、时间戳转换助手等系列常见和通用功能。
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on CommonsUtility:

Package Downloads
DBUtility.TDengine

基于官方提供的RESTful API接口，使用.NET 7等前沿技术封装的TDengine连接器。本封装库提供友好统一的对外接口形态，让使用者更专注于自身业务的开发工作。通过通用主机和服务容器集成使用(也可以使用Provider直接创建)，同时提供了相应的NuGet包供直接引入到项目。本封装库诞生于公司自有业务应用场景，将会同步不断优化和支持。 - Based on the officially provided RESTful API interface, TDengine connectors encapsulated by cutting-edge technologies such as .NET 7. This package library provides a friendly and unified external interface form, allowing users to focus more on their own business development. It is integrated and used through the common host and service container (it can also be created directly by using Provider), and the corresponding NuGet package is provided for direct introduction into the project. This package library was born in the company's own business application scenarios, and will be continuously optimized and supported synchronously. - 应用示例(samples)：https://github.com/cockroach888/GSA.MOLLE.ToolKits/tree/main/src/samples/TaosData - 鄙人专注.NET技术，深入研习.NET 6|7+系列源码。本库通过长期实践工作积累落地成库，库中提供的所有功能均广泛应用于业务生产环境，同时会不间断地进行功能的优化和完善； - 本库均由鄙人采用最新技术实践编码完成；本库可同时满足大、中、小等各式项目的自由支配使用，以提供快捷、便利的工具方法，提升工作效率和业务能力为宗旨。
CeriumX.Messaging.Abstractions

当前封装库为消息队列服务产品中间件的抽象层，主要定义统一的、规范化的API接口，及其公共功能和扩展支持等。 1. 消息队列服务产品中间件，采用面向接口编程，由抽象层和多个实现层共同组成； 2. 其中增强的服务总线，提供了多种消息队列服务的组网支持，可实现同步收发等多层次的组网需求； 3. 抽象层定义了统一的API接口，通过集成多种第三方产品的功能实现，使得中间件具备完整的、易用的消息队列服务能力； 4. 通过接口与实现的分离，增强用户体验，提高开发效率。 - 鄙人专注.NET技术，深入研习.NET 8系列源码。本库通过长期实践工作积累落地成库，库中提供的所有功能均广泛应用于业务生产环境，同时会不间断地进行功能的优化和完善； - 本库均由鄙人采用最新技术实践编码完成，个中艰辛不作过多表述，仅希望世界和平，养家糊口力所能及； - 本库可同时满足大、中、小等各式项目的自由支配使用，以提供快捷、便利的工具方法，提升工作效率和业务能力为宗旨。
CeriumX.Messaging.LocalMQ

当前封装库为消息队列服务产品中间件的LocalMQ(本地化消息队列)实现，LocalMQ是在长期地工作实践中总结创作而成，主要作用于应用程序内部间的消息应用，以达到依赖解耦和多对多等应用场景，诸如消息投递、事件传达、命令响应、对象投递(仅LocalMQ支持)等。 1. 消息队列服务产品中间件，采用面向接口编程，由抽象层和多个实现层共同组成； 2. 其中增强的服务总线，提供了多种消息队列服务的组网支持，可实现同步收发等多层次的组网需求； 3. 抽象层定义了统一的API接口，通过集成多种第三方产品的功能实现，使得中间件具备完整的、易用的消息队列服务能力； 4. 通过接口与实现的分离，增强用户体验，提高开发效率。 - 鄙人专注.NET技术，深入研习.NET 8系列源码。本库通过长期实践工作积累落地成库，库中提供的所有功能均广泛应用于业务生产环境，同时会不间断地进行功能的优化和完善； - 本库均由鄙人采用最新技术实践编码完成，个中艰辛不作过多表述，仅希望世界和平，养家糊口力所能及； - 本库可同时满足大、中、小等各式项目的自由支配使用，以提供快捷、便利的工具方法，提升工作效率和业务能力为宗旨。

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
8.2.0 341 12/11/2023
8.1.1 309 12/8/2023
8.1.0 308 11/27/2023
8.0.1 319 11/19/2023
8.0.0 703 11/16/2023
7.6.1 321 10/11/2023
7.6.0 410 8/25/2023
7.5.0 576 8/1/2023
7.4.0 513 7/6/2023
7.3.0 484 6/3/2023
7.2.0 434 5/26/2023
7.1.1 798 3/29/2023
7.1.0 700 3/16/2023
7.0.1 904 2/20/2023
7.0.0 2,168 11/13/2022
6.6.2 625 11/8/2022
6.6.1 648 11/8/2022
6.6.0 961 10/20/2022
6.5.1 961 10/13/2022
6.5.0 2,849 10/9/2022
6.4.0 748 9/18/2022
6.3.1 1,002 9/16/2022
6.3.0 959 9/7/2022
6.0.2 946 8/18/2022
6.0.1.1 741 8/2/2022
6.0.1 889 8/2/2022
6.0.0.1 1,244 7/1/2022
6.0.0 890 6/22/2022

迁移图像辅助操作与处理助手类(ImageHelper)中图像对象操作部分至ToolKits.PictureUtility封装库。