“CodeArts”是什么？

CodeArts 是一套简单、高效的轻量级框架（涵盖了类型转换、实体复制、实体映射、动态代理类，以及基于Linq分析实现的、支持分表和读写分离的ORM框架）。

如何安装？

First, install NuGet. Then, install CodeArts from the package manager console:

PM> Install-Package CodeArts

NuGet 包

Package	NuGet	Downloads	Jane Says Markdown
CodeArts			Core universal design.
CodeArts.Middleware			IOC middleware.
CodeArts.Caching			Caching rules.
CodeArts.Casting			Type conversion, cloning, mapping.
CodeArts.Configuration			Read configuration file.
CodeArts.Json			JSON read and write processing.
CodeArts.Net			Request component of HTTP/HTTPS.
CodeArts.Emit			Abstract Syntax Tree(AST).
CodeArts.Mvc			Model View Controller(MVC).
CodeArts.Db			Database operation base library.
CodeArts.Db.Lts			Independent research and development and long term maintenance of ORM.
CodeArts.Db.EntityFramework			EF/EFCore simple package.
CodeArts.Db.Linq2Sql			Linq to SQL.

引包即用？

• 引包即用是指，安装 NuGet 包后，自动注入配置信息。
• 在启动方法中添加如下代码即可：

using (var startup = new XStartup())
{
    startup.DoStartup();
}

单例。

• 作为单例基类。

  public class ASingleton : Singleton<ASingleton> {
      private ASingleton(){ }
  }
  
  ASingleton singleton = ASingleton.Instance;

• 作为单例使用。

  public class BSingleton {   
  }
  
  BSingleton singleton = Singleton<BSingleton>.Instance

• 绝对单例。

  public class CSingleton : Singleton<CSingleton> {
      private CSingleton(){ }
  }
  
  CSingleton singleton1 = CSingleton.Instance;
  CSingleton singleton2 = Singleton<CSingleton>.Instance; // 与“singleton1”是同一实例。

服务池。

• TryAddSingleton：添加单例实现。

• Singleton：获取单例。

• 单例实现：

  • 单例实现（一）。

    • 添加默认支持的单例实现。

    RuntimeServPools.TryAddSingleton<A,B>(); //=> true.

    • 在未使用A的实现前，可以刷新单例实现支持。

    RuntimeServPools.TryAddSingleton<A,C>(); //=> true;
    RuntimeServPools.TryAddSingleton<A>(new C()); //=> true;

  • 单例实现（二）。

    • 添加实例或工厂支持的单例实现。

    RuntimeServPools.TryAddSingleton<A>(new B()); //=> true.

    • 在未使用A的实现前，可以被实例或工厂刷新单例实现支持，默认支持方式不被生效。

    RuntimeServPools.TryAddSingleton<A,C>(); //=> false;
    RuntimeServPools.TryAddSingleton<A>(new C()); //=> true;

• 单例使用：

  • 单例使用（一）。

    A a = RuntimeServPools.Singleton<A>();

    未提前注入单例实现，会直接抛出NotImplementedException异常。

  • 单例使用（二）。

    A a = RuntimeServPools.Singleton<A,B>();

    未提前注入单例实现，会尝试创建B实例。

• 说明：

  • TryAddSingleton<T>：使用实例时，使用【公共/非公共】无参构造函数创建实例。

  • TryAddSingleton<T1,T2>：使用实例时，尽量使用参数更多且被支持的公共构造函数创建实例。

    public class A {
    }
    public class B {
        private readonly A a;
        public B() : this(new A()){ }
        Public B(A a){ this.a = a ?? throw new ArgumentNullException(nameof(a)); }
    }

    使用单例时，未注入A的单例实现，使用无参构造函数生成实例。

    使用单例时，已注入A的单例实现，使用参数A的造函数生成实例。

命名规范。

• 命名方式。

  /// <summary> 命名规范。 </summary>
  public enum NamingType
  {
      /// <summary> 默认命名(原样/业务自定义)。 </summary>
      Normal = 0,
  
      /// <summary> 驼峰命名,如：userName。 </summary>
      CamelCase = 1,
  
      /// <summary> url命名,如：user_name，注：反序列化时也需要指明。 </summary>
      UrlCase = 2,
  
      /// <summary> 帕斯卡命名,如：UserName。 </summary>
      PascalCase = 3
  }

• 命名标记。

  /// <summary>
  /// 命名特性。
  /// </summary>
  [AttributeUsage(AttributeTargets.All, AllowMultiple = false, Inherited = false)]
  public sealed class NamingAttribute : Attribute
  {
      /// <summary>
      /// 名称。
      /// </summary>
      public string Name { get; set; }
  
      /// <summary>
      /// 命名规范。
      /// </summary>
      public NamingType NamingType { get; set; }
  
      /// <summary>
      /// 构造函数。
      /// </summary>
      /// <param name="name">名称。</param>
      public NamingAttribute(string name)
      {
          Name = name;
      }
  
      /// <summary>
      /// 构造函数。
      /// </summary>
      /// <param name="namingType">名称风格。</param>
      public NamingAttribute(NamingType namingType)
      {
          NamingType = namingType;
      }
      /// <summary>
      /// 构造函数。
      /// </summary>
      /// <param name="name">名称。</param>
      /// <param name="namingType">名称风格。</param>
      public NamingAttribute(string name, NamingType namingType) : this(name)
      {
          NamingType = namingType;
      }
  }

命名转换。

• 指定命名方式。

  string named = "name".ToNamingCase(NamingType.CamelCase);

• 特定命名方式。

  • 帕斯卡命名（又称大驼峰）。

    string named = "name".ToPascalCase();

  • 驼峰命名。

    string named = "name".ToCamelCase();

  • Url命名。

    string named = "name".ToUrlCase();

读取配置文件。

• 普通方式。

  T value = "key".Config<T>(); // 未找到时，返回指定类型的默认值。

  T value = "key".Config(defaultValue); // 未找到时，返回defaultValue。

• 配置变更自动同步方式。

  • 实现以下接口。

    /// <summary>
    /// 配置变更监听能力。
    /// </summary>
    public interface IConfigable<TSelf> where TSelf : class, IConfigable<TSelf>
    {
    	/// <summary>
    	/// 监听到变更后的新数据。
    	/// </summary>
    	/// <param name="changedValue">变更后的数据。</param>
    	void SaveChanges(TSelf changedValue);
    }

  • 使用方式。

    T value = "key".Config<T>(); // 未找到时，返回:null。

字符串语法糖。

string value = "{a + b}".PropSugar(new { A = 1, B = 2 }, NamingType.CamelCase); //=> value = "3"。

• 语法说明：

  • 空运算符：A?B、A ?? B

    当A为null时，返回B，否则返回A。

  • 合并运算符：A+B

    当A和B可以参与运算时，返回运算结果。否则转成字符串拼接。

  • 试空合并运算符：A?+B

    当A为null时，返回B，否则按照【合并运算符】计算A+B的结果。

  • 可支持任意组合，从左到右依次计算（不支持小括号）。

可空能力（非null空实例）。

• Nullable<T>：T的默认值。

• 值类型：默认值。

• 字符串类型：string.Empty。

• 自定义空实例实现：Emptyable.Register。

  • 普通类型。

    Emptyable.Register<Version>(new Version());

  • 继承或实现关系。

    public class A{}
    public class B : A {}
    
    Emptyable.Register<A,B>();

  • 泛型声明类型。

    public class A<T>{}
    public class B<T> : A<T> {}
    
    Emptyable.Register(typeof(A<>),typeof(B<>));

• 其它：调用参数最多的构造函数生成默认值，确保构造函数参数相关内容不会为null。

  • 可选参数不为null时，直接使用可选参数默认值。
  • 生成可空实例。

• 不能生成非null空实例时，抛出异常。

标星历程图。