【Zara原创】SqlSugar4轻量级ORM框架的使用指南

前言：sqlSugar出生已经有3年之久了，从1.0到现在的4.x的版本，为了以后方便使用SqlSugar,所以特意花了2个小时来叙述它。

关于SqlSugar

性能：性能最好的ORM之一,具有超越Dapper的性能 ，走的是EMIT够构中间语言动态编译到程序集，完成高性能的实体绑定，达到原生水平。

功能：支持 DbFirst、CodeFirst、数据库维护、链式查询、链式更新、链式删除、链式插入、实体属性、复杂模型的查询、ADO.NET。特别是批量等功能都是货真价实的并非循环操作。

兼容性：支持多种数据库,具体就是SqlSugar的DbType枚举中有MySql、Oracle、SqlLite、SqlServer、PostgreSQL

入门使用

以下代码是创建连接，其中属性构造器的四个值分别为连接字符串、数据库类型、是否自动销毁连接、获取自增列主键信息。

SqlSugarClient db = new SqlSugarClient(new ConnectionConfig()
            {
                ConnectionString = "Data Source=DESKTOP-OEJGKOO;Initial Catalog=TextInfo;Integrated Security=True",
                DbType = SqlSugar.DbType.SqlServer,
                IsAutoCloseConnection = true,
                InitKeyType = InitKeyType.Attribute
            });

那我们做一个查询系列吧，数据库还是依旧的Users，实体类应和数据的结构一样，在此其中呢，你也可以指定一些特性，这样是有很大的好处的。

  public class Users
    {
        public int UserID { get; set; }
        public string UserName { get; set; }
        public string Email { get; set; }
        public string Address { get; set; }
    }

最基本的查询：

var list = db.Queryable<Users>().ToList();//查询所有

这个Queryable就是SqlSugar4的内置方法，我写入的泛型参数必须和数据库一样吗，那我的实体类应该怎么办，我如何在asp.net mvc中，我的model这样也一定会出现诸多的问题，那其实问题很简单，在实体中写上特性即可。

[SugarTable("Users")]
    public class Users
    {
        [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
        public int UserID { get; set; }
        public string UserName { get; set; }
        public string Email { get; set; }
        public string Address { get; set; }
    }

这样问题也就随之解决了，关于UserID这个主键列，数据库中也要设置主键和自增列才会有效，那我们再写一些条件查询、按主键查询、分页查询，以下代码呢根据主键查询，你的model层必须指定才可以，反则是无效的。

var objById = db.Queryable<Users>().InSingle(1);//根据主键查询
var getObjByWhere = db.Queryable<Users>().Where(u => u.UserID == 1);//根据条件查询
var total = 0;
var getPage = db.Queryable<Users>().Where(it => it.UserName == "zaranet").ToPageList(1, 2, ref total);

查询我们基本上都说完了，你们心里一定在想，CRUD的操作，还有3呢，哦？，那其实很简单的，比查询so easy的多。

Users users = new Users() {  UserName = "student hard",   Email="666666@qq.com",  Address="美国洛杉矶" };
int result = db.Insertable(users).ExecuteCommand();//insert
var user2 = new Users(){ UserID = 12, UserName = "厉害了我的ge" };
int result2 = db.Insertable(users).ExecuteCommand();//update
int result3 = db.Deleteable<Users>(1).ExecuteCommand();//bey key del obj

使用SimpleClient优化你的代码

我们之前已经学会用SimpleClient了，但是我们发现我们的查询每次都要通过db.Querytable去搞一些事情，非常的繁琐。我们可以去封装以下Client，创建DbContext；Db.Aop.OnLogExecuting是Sugar给我们提供查看sql的接口；其下图是生成的sql。

DbContext的定义：

    public class DbContext
    {
        public DbContext()
        {
            Db = new SqlSugarClient(new ConnectionConfig()
            {
                ConnectionString = "Data Source=DESKTOP-OEJGKOO;Initial Catalog=TextInfo;Integrated Security=True",
                DbType = SqlSugar.DbType.SqlServer,
                IsAutoCloseConnection = true,
                InitKeyType = InitKeyType.Attribute
            });
            //调式代码 用来打印SQL
            Db.Aop.OnLogExecuting = (sql, pars) =>
            {
                Console.WriteLine(sql + "\r\n" +
                    Db.Utilities.SerializeObject(pars.ToDictionary(it => it.ParameterName, it => it.Value)));
                Console.WriteLine();
            };
        }
        public SqlSugarClient Db;
        public SimpleClient<Users> UsersDb {
            get { return new SimpleClient<Users>(Db); } 
　　　　}
    } 

使用DbContext玩转CRUD

其中需要注意的是使用SqlSugar的部分功能的时候，一定要引用newtonSoft.json.dll 9.0.1及以上版本，否则会出现一些错误，比如：

关于使用SqlSugar的查询有很多方法，根据主键啊，where啊，getsingle啊，你回头自己再看看，我这里就不一一列举了。

使用DbContext要在类中去继承自DbContext,这样你的类都是DbContext派生类了，下面代码中，通过一个简单的条件还有一个枚举类型，做了一个最基本的分页查询，那我们如果是多条件呢，难道还要 && 条件吗？

public class UsersService : DbContext
    {
        public void SearchDemo()
        {
            var p = new PageModel() { PageIndex = 1, PageSize = 2 };// 分页查询
            //分页+排序
            var data = UsersDb.GetPageList(u => u.UserName == "zaraNet", p, u => u.UserName, OrderByType.Asc);
            Console.WriteLine(p.PageCount);
        }
    }

我们可以通过IConditionalModel这个类来组合条件，以方便我们的查询，其代码所示：

var p = new PageModel() { PageIndex = 1, PageSize = 2 };// 分页查询
List<IConditionalModel> conModels = new List<IConditionalModel>();
            conModels.Add(new ConditionalModel()
            {
                FieldName = "id",
                ConditionalType = ConditionalType.Equal,
                FieldValue = "1"
            });
var data = UsersDb.GetPageList(conModels,p,it => it.UserName,OrderByType.Desc);

噢！，其实这样是比较方便了，但是后期维护也是很累的，你看着吧，你想怎么用就怎么用，我们在说一说增删改吧，查我们已经说的差不多了。

首先说一下添加，也是非常简单，直接new对象调用Insert就好，但有一个值得提的是，SqlSugar给我们提供了数组系列,也就是说我们不用循环操作了，其示例代码如下：

var p = new PageModel() { PageIndex = 1, PageSize = 2 };// 分页查询
var user = new Users() { UserName = "zara1", Email = "sad", Address = "asd" };
var user2 = new Users() { UserName = "zaranet", Email = "asd", Address = "zxc" };
UsersDb.Insert(user);//插入
UsersDb.InsertRange(new Users[] {user,user2});

下面是SqlSugar生成的Sql,不难发现插入数组的sql非常的犀利，采用的是insert select 语法。

INSERT INTO [Users]
([UserName],[Email],[Address])
VALUES
(@UserName,@Email,@Address) ;
{"@UserName":"zara1","@Email":"sad","@Address":"asd"}

INSERT [Users] ([UserName],[Email],[Address])
SELECT N'zara1' AS [UserName],N'sad' AS [Email],N'asd' AS [Address]
UNION ALL
SELECT N'zaranet' AS [UserName],N'asd' AS [Email],N'zxc' AS [Address]

在说一说更新和删除吧，当然他们同样有着range系列的操作，其代码所示：

SqlSugar的事务简单使用，我通常都是这么用的，通过这种方式是免去 db.CommitTran();这种啰嗦且邋遢代码。

 var result = Db.Ado.UseTran(() =>
            {
                var obj = UsersDb.GetById(0);
                obj.UserName = "事务demo";
                UsersDb.Update(obj);
            });
            if (result.IsSuccess)
            {
                Console.WriteLine("事务提交了");
                //成功
            }
            else
            {
                Console.WriteLine(result.ErrorMessage);
            }

如何优雅的使用DbContext

UsersService.cs

public class UsersService: DbContext<User>
{
   //有特殊需要的时候在重写方法组
}

　DbContext中被改造成了泛型类，你传过来什么我干什么，这样DbContext真的就是管上下文的了,其优雅度从代码中就可以看出！如果你有特殊情况你需要重写方法，你直接重写即可，这个时候你就可以把这个东西想象成三层框架中的BLL.

 public class UsersService : DbContext<Users>
    {
        public override List<Users> GetList()
        {
            return base.GetList();
        }
    }

　其DbContext的最终定义：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using SqlSugar;

namespace dapperDemo
{
    public class DbContext<T> where T: class,new()
    {
        public DbContext()
        {
            Db = new SqlSugarClient(new ConnectionConfig()
            {
                ConnectionString = "Data Source=DESKTOP-OEJGKOO;Initial Catalog=TextInfo;Integrated Security=True",
                DbType = SqlSugar.DbType.SqlServer,
                IsAutoCloseConnection = true,
                InitKeyType = InitKeyType.Attribute
            });
            //调式代码 用来打印SQL
            Db.Aop.OnLogExecuting = (sql, pars) =>
            {
                Console.WriteLine(sql + "\r\n" +
                    Db.Utilities.SerializeObject(pars.ToDictionary(it => it.ParameterName, it => it.Value)));
                Console.WriteLine();
            };
        }
        public SqlSugarClient Db;
        public SimpleClient<Users> UsersDb {
            get { return new SimpleClient<Users>(Db);
          } }
        public SimpleClient<T> CurrentDb { get { return new SimpleClient<T>(Db); } }
        /// <summary>
        /// 可重写的更新
        /// </summary>
        public virtual bool Update(T obj)
        {
            return CurrentDb.Update(obj);
        }
        public virtual bool Delete(dynamic id)
        {
            return CurrentDb.DeleteById(id);
        }
        public virtual List<T> GetList()
        {
            return CurrentDb.GetList();
        }
    }
}

　　

　　喜欢的话，点个赞噢