介绍

Light.Data 是一个基于dotnet standard 2.0的轻量级ORM框架，通过实体模型类 Attribute 或配置文件关联数据表。使用核心类 DataContext 在表上进行 CURD 操作。

PM> Install-Package Light.Data

支持的数据库

数据库	介绍
SqlServer的	需要安装 nuget 安装 Light.Data.Mssql 库，支持SqlServer 2008或以上版本
Mysql的	需要安装 nuget 安装 Light.Data.Mysql 库，支持Mysql5.5或以上版本
Postgre	需要安装 nuget 安装 Light.Data.Postgre 库，支持PostgreSQL9.3或以上版本

文件：:

Github：:

如何使用

数据库配置

{  "lightData": {      "connections": [          {             "name": "mssql_db",             "connectionString": "...",             "providerName": "Light.Data.Mssql.MssqlProvider, Light.Data.Mssql"          },          {             "name": "mysql_db",             "connectionString": "...",             "providerName": "Light.Data.Mysql.MysqlProvider, Light.Data.Mysql"           }       ]    }}

使用方法

// direct useDataContext context = new DataContext("mssql");// create subclasspublic class MyDataContext : DataContext{    public MyDataContext() : base("mssql")    {    }}// create subclass with optionspublic class MyDataContext : DataContext{    public MyDataContext(DataContextOptions
   
     options) : base(options)    {    }}// direct config connect string and params （IServiceCollection）service.AddDataContext
    
     (builder => {    builder.UseMssql(connectionString);    builder.SetTimeout(2000);    builder.SetVersion("11.0");}, ServiceLifetime.Transient);// use default configuration file to config （IServiceCollection）service.AddDataContext
     
      (DataContextConfiguration.Global, config => {       config.ConfigName = "mssql";}, ServiceLifetime.Transient);

对象映射

[DataTable("Te_User", IsEntityTable = true)]public class TeUser{    ///     /// Id    /// 
    /// 
       [DataField("Id", IsIdentity = true, IsPrimaryKey = true)]    public int Id    {        get;        set;    }    ///     /// Account    /// 
    /// 
       [DataField("Account")]    public string Account    {        get;        set;    }    ///     /// Telephone    /// 
    /// 
       [DataField("Telephone", IsNullable = true)]    public string Telephone    {        get;        set;    }    ....}

子表映射

在派生类TeUserAndExtend中添加类型为TeUserExtend的公共属性Extend，并添加特性RelationFieldAttribute。在查询TeUserAndExtend中，还将检测关联的TeUserExtend 数据。并且还支持一对多。

[DataTable("Te_UserExtend", IsEntityTable = true)]public class TeUserExtend{    [DataField("Id", IsIdentity = true, IsPrimaryKey = true)]    public int Id    {        get;        set;    }    [DataField("MainId")]    public int MainId    {        get;        set;    }        [DataField("Data", IsNullable = true)]    public string Data    {        get;        set;    }}public class TeUserAndExtend : TeUser{    [RelationField("Id", "MainId")]    public TeUserExtend Extend    {        get;        set;    }}

基本操作

基本CURD

批量CUD

支持事务处理

支持数据字段默认值和自动时间戳

支持数据字段读写控制

查询结果指定类或匿名类输出

查询结果直接插入数据表

var context = new DataContext();// query single datavar item = context.Query
   
    ().Where(x => x.Id == 10).First();// query collection datasvar list = context.Query
    
     ().Where(x => x.Id > 10).ToList();// create datevar user = new TeUser() {  Account = "foo",  Password = "bar"};context.Insert(user);// update datauser.Password = "bar1";context.Update(user);// delete datacontext.Delete(user);

数据聚合

单列数据直接聚合

多列数据分组聚合

格式化分组字段

聚合数据直接插入数据表

// basicvar list = context.Query
   
     ()         .Where (x => x.Id >= 5)         .GroupBy (x => new LevelIdAgg () {           LevelId = x.LevelId,           Data = Function.Count ()          })         .ToList ();// date formatvar list = context.Query
    
      ()         .GroupBy (x => new RegDateFormatAgg () {           RegDateFormat = x.RegTime.ToString("yyyy-MM-dd"),           Data = Function.Count ()          })         .ToList ();

Join表查询

多表连接，支持内连接，左连接和右连接

支持查询结果和聚合数据连接在一起

连接查询结果指定类或匿名类输出

连接查询结果直接插入数据表

// inner joinvar join = context.Query
   
     ()                  .Join
    
     ((x,y) => x.Id == y.Id);// aggregate data join entity table             var join = context.Query
     
      ()                  .GroupBy(x => new {                      MId = x.MId,                      Count = Function.Count(),                   })                  .Join
      
       ((x, y) => x.MId == y.Id);

执行SQL

直接使用SQL和存储过程

支持对象参数

查询结果指定类或匿名类输出

存储过程支持使用输出参数

// basic parametervar sql = "update Te_User set NickName=@P2 where Id=@P1";var ps = new DataParameter[2];ps[0] = new DataParameter("P1", 5);ps[1] = new DataParameter("P2", "abc");var executor = context.CreateSqlStringExecutor(sql, ps);var ret = executor.ExecuteNonQuery();// object parametervar sql = "update Te_User set NickName={nickname} where Id={id}";var executor = context.CreateSqlStringExecutor(sql, new { nickname = "abc", id = 5 });var ret = executor.ExecuteNonQuery();