Dapper.Common基于Dapper的开源LINQ超轻量扩展

Dapper.Common

　　Dapper.Common是基于Dapper的LINQ实现,支持.net core,遵循Linq语法规则、链式调用、配置简单、上手快,支持Mysql,Sqlserver(目前只实现了这两个数据库，实现其他数据库也很轻松)，支持单表，多表，自定义函数等功能。源码及其简单，直白，解析Lambda只有300行左右代码。严格区分C#函数和数据库函数，你可以在表达式中调用C#函数（不推荐，推荐将计算结果保存到变量，在写入lambda表达式），性能损失在表达式编译：常量>变量>函数。损失多少可以通过ExpressionUtil.BuildExpression()来测试，几万次耗时百毫秒及别。

　　开源地址：https://github.com/1448376744/Dapper.Common

　　Nuget：Install-Package Dapper.Common -Version 1.5.0

0.Test

640?wx_fmt=png

1.Mapper

2.Config

//在App启动时执行一次即可
SessionFactory.AddDataSource(new DataSource()
{
    Name = "mysql",
    Source = () => new SqlConnection("connectionString"),
    SourceType = DataSourceType.SQLSERVER,
    UseProxy = true//使用Session的静态代理实现，记录日志，执行耗时,线上环境建议关闭代理
});

//获取数据库上下文
using (var session = SessionFactory.GetSession("msql"))
{
//linq to sql
}

3.Insert

var entity = new User()
{
    CreateTime=DateTime.Now,
    NickName="dapper",
};
//绝大部分接口可以设置condition已决定是否执行，支持批量更新
session.From<User>().Insert(entity,condition:1>2);
//查看日志，如果出现异常，应该在catch里，查看session.Loggers
var loggers = session.Loggers;

2.Update

var entity = new User()
{
　　Id=2,
　　NickName="李四"
};
//更新所有字段（where id=2），支持批量，显然除NickName之外将被更新成null
session.From<User>().Update(entity);

//更新部分字段
session.From<User>()
   .Set(a => a.NickName, "李四", condition: true)//condition为true时更新该字段
   .Set(a => a.Balance, a => a.Balance + 100)//余额在原来基础增加100
   .Where(a => a.Id.In(1,2,3))//将id为1，2，3的记录进行更新
   .Update();

3.Delete

//删除id>5||nick_name like '%da%'
 session.From<User>()
    .Where(a=>a.Id>5||a.NickName.Like("da"))
    .Delete();

4.Single

  //查询全部字段
var user1 = session.From<User>()
      .Where(a=>a.Id==2)
      .Single();

//查询部分字段
var user2 = session.From<User>()
     .Where(a => a.Id == 2)
     .Single(s=>new
     {
         s.Id,
         s.NickName
     });

5.Select

 //查询:where id in(1,2,3)
var list = session.From<User>()
        .Where(a => a.Id.In("1,2,3".Split(',')))
        .Select();

6.Where

 //构建动态查询，condition: true执行，通过condition选择分支，多个where之间用 and 连接
var list = session.From<User>()
        .Where(a => a.Id.In(1, 2, 3), condition: true)
        .Where(a => a.NickName.Like("da"), condition: false)
        .Where(a => a.Id > 2 || (a.NickName.Like("da") && a.Balance > 50))
        .Where("select * from user_bill where user_bill.user_id=user.id")//同样可以当作字符串拼接工具
        .Select();

7.Function

 /// <summary>
/// 自定义函数
/// </summary>
public static class MySqlFun
 {
//这里使用泛型并不是必须的，只用函数名在数据库存在即可，泛型为了指定返回数据类型
     [Function]//Dapper.Common严格区分C#函数和数据库函数，一定要用该特性标识数据库函数
public static T COUNT<T>(T column)
     {
return default(T);
     }
     [Function]
public static T MAX<T>(T column)
     {
return default(T);
     }
     [Function]
public static T DISTINCT<T>(T column)
     {
return default(T);
     }
　　　[Function]
　　　public static T DATE<T>(T column)
     {
　　　　　return default(T);
　　　}
  }

8.GroupBy

 var list = session.From<Order>()
     .GroupBy(a => a.UserId)//多个条件可以new一个匿名对象，也可以并联多个group
     .Having(a => MySqlFun.COUNT(MySqlFun.DISTINCT(a.UserId)) > 10)//count(distinct(user_id))>10
     .Select(s => new
     {
         s.UserId,
         OrderCount = MySqlFun.COUNT(1L),//这里应该返回long int，
         MaxFee = MySqlFun.MAX(s.TotalFee)
     });

9.Join

 var list = session.From<Order, User>()
     .Join((a, b) => a.UserId == b.Id, JoinType.Inner)
     .GroupBy((a, b) => a.UserId)
     .Having((a, b) => MySqlFun.COUNT(MySqlFun.DISTINCT(a.UserId)) > 10)//count(distinct(user_id))>10
     .Select((a, b) => new
     {
         a.UserId,
         b.NickName,
         OrderCount = MySqlFun.COUNT(1L),//这里应该返回long int，
         MaxFee = MySqlFun.MAX(a.TotalFee)
     });

10.SubQuery

var list = session.From<Order>()
    .GroupBy(a  => a.UserId)
    .Having(a => MySqlFun.COUNT(MySqlFun.DISTINCT(a.UserId)) > 10)
    .Select(a => new
    {
        a.UserId,
        UserName=Convert.ToString("select nick_name from user where user.id=order.user_id"),//如果这个子查询返回的是int：Convert.ToInt32(sql)
        OrderCount = MySqlFun.COUNT(1L),//这里应该返回long int【这就是为什么定义成泛型函数】，
        MaxFee = MySqlFun.MAX(a.TotalFee)
    });

11.Page

//分页应该写在Where,Having,Group之后（如果有）
var list = session.From<User>()
        .Where(a=>a.NickName != null)
        .Page(1,10,out long total)
        .Select();

12.Take

var list = session.From<User>()
        .Take(5)
        .Select();

13.Skip

//从数据库索引为1的位置（跳过1之前的记录），获取10
var list = session.From<User>()
    .Skip(1,10)
    .Select();

14.Sum

var list= session.From<User>()
     .Sum(s=>s.Balance*s.Id);

15.Exists

//内部采用exist子查询判断满足where条件的记录是否存在
var flag = seesion.From<User>()
    .Where(a=>a.Id > 10)
    .Exists();

16.OrderBy

var list1 = session.From<User>()
    .Order(a=>a.Id)
    .Select();

var list2 = session.From<User>()
    .GroupBy(a => MysqlFun.DATE(a.CreateTime))
    .OrderByDescending(a => MysqlFun.DATE(a.CreateTime))
    .Select(s=>new 
    {
         Date=MysqlFun.DATE(s.CreateTime),
         Count = MysqlFun.Count(1L)
    });

17.Filter

var user =new User ()
{
　　Id = 12
　　Balance = 50,
　　NickName = "张三",
　　CreateTime = Datetime.Now
};
//Filter会在Insert,Update,Select，过滤掉不想要的字段
//这将不会更新余额及创建时间
var row = session.From<User>()
    .Filter(f=>new 
    {
          f.CreateTime,
          f.Balance,
    })
    .Update(user);

18.Transaction

//获取数据库上下文
  ISession session = null;
try
  {
　　　　session=SessionFactory.GetSession();
//开启事务
      session.Open(true);
//sql
//提交事务
      session.Commit();
  }
catch (Exception)
  {
      session?.Rollback();
throw;
  }
finally
  {
      session?.Close();
  }