LambdaToSql(轻量级ORM) 入门篇开源项目

时间 2019-11-12

标签 lambdatosql 轻量级 orm 入门开源项目栏目 Java 繁體版

原文原文链接

为何开发(背景)

最开始使用的是 sqlDbHelper,有微软的,有本身写的。
后来开始使用比较成熟的框架开发,使用过一段时间的Hibernate,后期主要使用 Entity FrameWork。
发现表越多业务越复杂后,越很差控制项目,因此慢慢的本身根据业务写了一个小工具,也就是本文说的 LambdaToSql。
最开始的功能主要是准备替代DbHelper的,慢慢的把映射关系加上了,再后来重构了几回,就慢慢的代替了EF的功能。
如今有几个成熟的项目在使用,软件也会一直维护下去,如今基本都是核心功能,暂时没往大而全去作。

ORM介绍

链式查询、链式更新、链式删除、链式插入、复杂模型的查询、ADO.NET。
支持数据库:如今只支持 MS Sql Server,其余数据库暂时未作支持处理,里面预留了对其它数据库支持的接口,但未实现代码逻辑。
数据库预留接口:Oracle、Mysql、Access。
功能: 基本CURD(添加,修改,读取,删除)功能,批量修改,DbFirst,表缓存。
所有使用Lambda语法,开发简洁,代码干净,后期好维护。
有点2:性能高,基本接近于原生ADO,语法简单,功能强大,持续更新维护。
其实LambdaToSql不能算是一个ORM，主要功能其实还应该算是Dapper替代产品，主要是把映射对象经过Lambda形式转换成sql语句，经过Ado作 CURD操做。
缺点1:不支持多表查询,Join性能仍是比较低,但后期仍是会支持join查询。
缺点2:暂时不支持外部自定义函数和继承覆盖重写,后期慢慢也会开放出来。
若是有想自定义的,能够直接使用源码改动哦。

性能测试

测试环境: 硬盘:三星 SSD 850 EVO; CPU:i7-7700K
添加100w条数据耗时大概250s内
查询100w条数据并生成实体.Tolist(),大概3s
100w数据,每页50条,取中间数据,大概100ms内
插入/更新/查询单条数据大概20ms内
删除单条大概 20ms内

开源地址

码云gitee: https://gitee.com/wangshuyu/LambdaToSql
Demo示例:https://gitee.com/wangshuyu/LambdaToSql_Demo

如何安装

源码方式:能够直接在gitee下载源代码,在项目中直接使用
经过Nuget下载引用: 打开Nuget 搜索:LambdaToSql 就能够了
Nuget命令方式: Install-Package LambdaToSql

Config配置,连接数据库

  <connectionStrings>
    <add name="ConnectionString" connectionString="Server=.;Database=LambdaToSql;User ID=sa;Password=abc@123;" providerName="System.Data.SqlClient" />
  </connectionStrings>

初始化LambdaToSql 对象

//默认方式
LambdaToSql.SqlClient DB = new LambdaToSql.SqlClient();

//自定义连接字符串名称
var DB = new LambdaToSql.SqlClient(new LambdaToSql.EntityModel.DbContext()
            {
               ConnectionStringName = "ConnectionString1",
               SqlType = LambdaToSql.EntityModel.SqlType.MsSqlServer
            });

初次使用,如何生成实体类:DbFirst

//生成实体保存路径
var saveFolder = "d:\\class\\";

//生成所有实体
DB.DbFirst.Create(saveFolder);

//生成指定表实体对象
DB.DbFirst.CreateByTable(saveFolder, new List<string>() { "Table_ID", "Table_Guid" });

查询

/// <summary>
/// 查询
/// </summary>
public void Query()
{
    //查询所有
    var list = DB.QueryTable<EntityModel.Table_ID>().ToList();

    //Find主键查找,支持Guid 和int 自增主键
    var entity = DB.QueryTable<EntityModel.Table_ID>().Find(200);

    //In查询
    var arr = new int?[] { 100, 101, 102, 103 }.ToList();
    var list1 = DB.QueryTable<EntityModel.Table_ID>(ex => arr.Contains(ex.ID)).ToList();

    //Not In 查询 
    var list2 = DB.QueryTable<EntityModel.Table_ID>(ex => ex.ID.ExNotIn(arr)).ToList();//有问题
    var list2_1 = DB.QueryTable<EntityModel.Table_ID>(ex => arr.NotContains(ex.ID)).ToList();//有问题

    // Like  查询
    var list3 = DB.QueryTable<EntityModel.Table_ID>().Where(ex => ex.LoginName.Contains("15")).ToList();//(LoginName like '%15%')
    var list4 = DB.QueryTable<EntityModel.Table_ID>().Where(ex => ex.LoginName.NotContains("15")).ToList();//(LoginName not like '%15%') //有问题
    var list5 = DB.QueryTable<EntityModel.Table_ID>().Where(ex => ex.LoginName.StartsWith("15")).ToList();//(LoginName like '15%')
    var list6 = DB.QueryTable<EntityModel.Table_ID>().Where(ex => ex.LoginName.EndsWith("15")).ToList();//(LoginName like '%15')

    //排序
    var list7 = DB.QueryTable<EntityModel.Table_ID>().OrderBy(ex => ex.CreateTime).OrderByDescending(ex => ex.LoginName).ToList();

    //分组
    var list8 = DB.QueryTable<EntityModel.Table_ID>().GroupBy(ex => new { ex.LoginName, ex.UserName }).ToList();

    //只取特定字段
    var list9 = DB.QueryTable<EntityModel.Table_ID>().Select(ex => new { ex.LoginName, ex.UserName }).ToList();

    //top N
    var list10 = DB.QueryTable<EntityModel.Table_ID>().Take(10).ToList();
    //第几页
    var list11 = DB.QueryTable<EntityModel.Table_ID>().Skip(2).Take(10).ToList();

    //取第一条数据
    var list12 = DB.QueryTable<EntityModel.Table_ID>().First();
    var list13 = DB.QueryTable<EntityModel.Table_ID>().FirstOrDefault();

    //分页  2005,2008使用row_number分页,2012以上使用offset分页形式
    int total = 0;
    var list14 = DB.QueryTable<EntityModel.Table_ID>().Skip(15).Take(30).ToPageList(ref total);

    //分组 select 比原始去重性能要高一些
    DB.QueryTable<EntityModel.Table_ID>().GroupBy(ex => new { ex.UserName, ex.LoginName })
                                            .Select(ex => new { ex.UserName, ex.LoginName })
                                            .ToList();

    //判断知足条件的数据是否存在
    var flag = DB.QueryTable<EntityModel.Table_ID>().Any();
    //判断知足条件的数据是否存在
    var flag1 = DB.QueryTable<EntityModel.Table_ID>(ex => ex.ID == 2000).Any();
}

函数处理

/// <summary>
/// 函数处理
/// </summary>
private void Fun()
{
    //求和
    var num1 = DB.QueryTable<EntityModel.Table_ID>().Sum(ex => ex.IsDelete);

    //最小值
    var num2 = DB.QueryTable<EntityModel.Table_ID>().Min(ex => ex.IsDelete);

    //最大值
    var num3 = DB.QueryTable<EntityModel.Table_ID>().Max(ex => ex.IsDelete);

    //平均值
    var num4 = DB.QueryTable<EntityModel.Table_ID>().Avg(ex => ex.IsDelete);

    //总数
    var num5 = DB.QueryTable<EntityModel.Table_ID>().Count();
}

添加

/// <summary>
/// 添加数据
/// </summary>
public void Inser()
{
    //添加单个实体对象
    var entity = new EntityModel.Table_ID()
    {
        LoginName = "登陆用户:",
        UserName = "用户名:",
        PassWord = "密码-",
        Gender = "男",
        IsDelete = 0,
        Mobile = "15804066511",
        Remark = "备注",
        Address = "地址:",
        CreateTime = DateTime.Now
    };
    var ret = DB.InsertTble(entity).ExecuteNonQuery();//返回主键值

    //只添加某几列
    var i = DB.InsertTble(entity).InsertColumns(ex => new { ex.LoginName, ex.UserName, ex.Remark }).ExecuteNonQuery();

    //忽略某些列
    var i1 = DB.InsertTble(entity).IgnoreColumns(ex => new { ex.Mobile, ex.PassWord }).ExecuteNonQuery();
}

修改

NULL列不作更新处理
暂时只支持uniqueidentifier和int自增类型单主键

/// <summary>
/// 更新数据
/// </summary>
public void Update()
{
    //更新单个实体对象
    var entity = DB.QueryTable<EntityModel.Table_ID>(ex => ex.ID == 200).FirstOrDefault();
    entity.PassWord = "12345";
    entity.LoginName = "LambdaToSql";
    entity.UserName = "LambdaToSql1";
    var i = DB.UpdateTble(entity).ExecuteNonQuery();

    //更新特定字段,不指定不更新
    var i1 = DB.UpdateTble(entity).UpdateColumns(ex => new { ex.PassWord }).ExecuteNonQuery();

    //忽略特定字段,其余字段都更新
    var i2 = DB.UpdateTble(entity).IgnoreColumns(ex => new { ex.UserName, ex.PassWord }).ExecuteNonQuery();

    //条件更新 不须要取出实体对象 直接数据库更新             
    var i3 = DB.UpdateTble(new EntityModel.Table_ID() { PassWord = "123456", LoginName = "12" }).Where(ex => ex.ID == 101).ExecuteNonQuery(true);
}

删除

/// <summary>
/// 删除
/// </summary>
public void Delete()
{
    //删除单个实体,经过主键删除 
    var entity = DB.QueryTable<EntityModel.Table_ID>(ex => ex.ID == 200).FirstOrDefault();
    var i = DB.DeleteTble<EntityModel.Table_ID>(entity).ExecuteNonQuery();

    //条件删除 支持查询里面的全部条件写法
    var i1 = DB.DeleteTble<EntityModel.Table_ID>(ex => ex.ID == 201).ExecuteNonQuery();
}

事务

事务使用注意：

事务只能在同一个SqlClient对象有效；事务只能在同一个SqlClient对象有效；事务只能在同一个SqlClient对象有效；重要的事说三遍
跨SqlClient对象请用分布式事务(暂时内置不支持,后续版本会支持分布式事务)

/// <summary>
/// 事务
/// </summary>
public void Tran()
{
    var sqlClient = new LambdaToSql.SqlClient();
    try
    {
        sqlClient.BeginTran();//开启事务

        //添加单个实体对象
        var entity = new EntityModel.Table_ID()
        {
            LoginName = "登陆用户:",
            UserName = "用户名:",
            PassWord = "密码-",
            IsDelete = 0,
            CreateTime = DateTime.Now
        };
        var entity1 = new EntityModel.Table_ID()
        {
            LoginName = "登陆用户:",
            UserName = "在破败中崛起，在寂灭中复苏。沧海成尘，雷电枯竭，那一缕幽雾又一次临近大地，世间的枷锁被打开了，一个全新的世界就此揭开神秘的一角:",
            PassWord = "密码-",
            IsDelete = 0,
            CreateTime = DateTime.Now
        };
        var entity2 = new EntityModel.Table_ID()
        {
            LoginName = "登陆用户:",
            UserName = "用户名:",
            PassWord = "密码-",
            IsDelete = 0,
            CreateTime = DateTime.Now
        };


        sqlClient.InsertTble(entity).ExecuteNonQuery();
        sqlClient.InsertTble(entity1).ExecuteNonQuery();//错误 UserName太长=>回滚
        sqlClient.InsertTble(entity2).ExecuteNonQuery();

        sqlClient.CommitTran();//提交事务
    }
    catch (Exception ex)
    {
        sqlClient.RollbackTran();//回滚事务
    }
}

ADO

/// <summary>
/// Ado
/// </summary>
public void Ado()
{
    var sql = "select top(10) * from table_id";
    var sdr = DB.Ado.ExecuteReader(sql);
    var list = new List<string>();
    while (sdr.Read())
    {
        list.Add(sdr[0].ToString());
    }
    sdr.Close();

    var Dt = DB.Ado.ExecuteTable(sql);

    var ls1 = DB.Ado.ExecuteScalar(sql);
    var ls = DB.Ado.ExecuteScalars(sql);

    var i = DB.Ado.ExecuteNonQuery("update top (10) table_id set imgurl = 'img1'");
}

后续计划

继续维护代码和升级新功能
把类库UML图发布出来
把类接口和实现文档整理好发布出来
会在开源一个关于WebApi的总体框架结构
最近另外一个开源项目: https://gitee.com/wangshuyu/CommonLib 这是个通用类库项目,把平时经常使用的整理了下,本身也一直在使用此类库

结尾

但愿你们多多提bug
但愿你们多多提意见
最后,感谢SqlSugar项目做者开源

LambdaToSql(轻量级ORM) 入门篇 开源项目

为何开发(背景)

ORM介绍

性能测试

开源地址

如何安装

Config配置,连接数据库

初始化LambdaToSql 对象

初次使用,如何生成实体类:DbFirst

查询

函数处理

添加

修改

删除

事务

事务使用注意：

ADO

后续计划

结尾

LambdaToSql(轻量级ORM) 入门篇开源项目