手把手撸套框架-SqlSugar搭建与避坑

一，基础搭建

SqlSugar，实在是太简单了，基本看一眼官网就会了。

官网：http://www.codeisbug.com/Doc/8

那我为什么还要专门来写篇博客呢？主要是完整照着官网来，坑定掉坑里。我想把我遇到的几个问题记录一下，顺便普及一下Sqlguar。

首先来说一下，安装：

官网基本说的很明白，SqlSugar 分为 .net framework 版本 和 .net core版本，这个做项目的实话别选错了。

这里我强烈建议，没有转.net Core的新项目尽快转.net core 。两个性能不在一个量级，另外就算你今天不转，再过几个月照样要转。

.net Core 5.0 号称 “大一统”，转core 早晚的事，不如尽早接触，积累经验。

通过nuget 添加程序集之后，直接配置一个连接字符串就可以用了，非常简单：

SqlSugarClient db = new SqlSugarClient(

    new ConnectionConfig()

    {

        ConnectionString = "server=.;uid=sa;pwd=@jhl85661501;database=SqlSugar4XTest",

        DbType = 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();

            };

     

/*查询*/

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

var getById = db.Queryable<StudentModel>().InSingle(1);//根据主键查询

var getByWhere = db.Queryable<StudentModel>().Where(it=>it.Id==1).ToList();//根据条件查询

var total = 0;

var getPage = db.Queryable<StudentModel>().Where(it => it.Id == 1).ToPageList(1,2,ref total);//根据分页查询

//多表查询用法 http://www.codeisbug.com/Doc/8/1124

 

/*插入*/

var data = new Student() { Name = "jack" };

db.Insertable(data).ExecuteCommand();

//更多插入用法 http://www.codeisbug.com/Doc/8/1130

 

/*更新*/

var data2 = new Student() { Id =1, Name = "jack" };

db.Updateable(data2).ExecuteCommand();

//更多更新用法 http://www.codeisbug.com/Doc/8/1129

 

/*删除*/

db.Deleteable<StudentModel>(1).ExecuteCommand();

以上代码都是从官网复制过来的，实际使用可以参考，里面的“三分钟高手”里面的写法：

public class DbContext<T> where T: class,new()

{

    public DbContext()

    {

        Db = new SqlSugarClient(new ConnectionConfig()

        {

            ConnectionString = "server=.;uid=sa;pwd=@jhl85661501;database=SqlSugar4XTest",

            DbType = DbType.SqlServer,

            InitKeyType = InitKeyType.Attribute,//从特性读取主键和自增列信息

            IsAutoCloseConnection = true,//开启自动释放模式和EF原理一样我就不多解释了

 

        });

        //调式代码 用来打印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<Student> StudentDb { get { return new SimpleClient<Student>(Db); } }//用来处理Student表的常用操作

    public SimpleClient<School> SchoolDb { get { return new SimpleClient<School>(Db); } }//用来处理School表的常用操作

    public SimpleClient<T> CurrentDb { get { return new SimpleClient<T>(Db); } }//用来处理T表的常用操作

 

 

    /// <summary>

    /// 获取所有

    /// </summary>

    /// <returns></returns>

    public virtual List<T> GetList()

    {

        return CurrentDb.GetList();

    }

 

    /// <summary>

    /// 根据主键删除

    /// </summary>

    /// <param name="id"></param>

    /// <returns></returns>

    public virtual bool Delete(dynamic id)

    {

        return CurrentDb.Delete(id);

    }

 

 

    /// <summary>

    /// 更新

    /// </summary>

    /// <param name="id"></param>

    /// <returns></returns>

    public virtual bool Update(T obj)

    {

        return CurrentDb.Update(obj);

    }

 

}

然后去继承这个基类就行了，给泛型一个映射实体：

目录结构：

至此，基本的搭建就结束了，但是看到这里，坑也就来了。

二，SqlSugar 避坑

（1）我遇到的第一个坑就是只看了官网的说明，没有变通。官网上，不是这样写的吗？

我以为，每个Da对象（数据表操作类）都要在 DbContxt 中配置一下，搞的我新建一个Da文件就要去配置一下，实在是麻烦，后来查文档知道了，

SqlSugar 提供了一个：

1，SimpleClient 简易版的操作类，

2，SqlSugarClient 完全版操作类

我也不知道这样理解对不对，总之是没必要，每次添加一个Da 都去配置一下。

 public class DbContext<T> where T : class, new()
    {


        //注意：不能写成静态的
        public SqlSugarClient Db;//用来处理事务多表查询和复杂的操作
        public SimpleClient<T> CurrentDb { get { return new SimpleClient<T>(Db); } }//用来操作当前表的数据


        public DbContext()
        {


            Db = new SqlSugarClient(new ConnectionConfig()
            {
                ConnectionString = AppConfig.DB,
                DbType = DbType.Oracle,
                InitKeyType = InitKeyType.Attribute,//从特性读取主键和自增列信息
                IsAutoCloseConnection = true,//开启自动释放模式和EF原理一样我就不多解释了

            });
            //调式代码 用来打印SQL 
            Db.Aop.OnLogExecuting = (sql, pars) =>
            {
                Console.WriteLine(DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"));
                Console.WriteLine();
                Console.WriteLine(sql);
                Console.WriteLine();
                Console.WriteLine(Db.Utilities.SerializeObject(pars.ToDictionary(it => it.ParameterName, it => it.Value)));
                Console.WriteLine();
            };
            

        }
     

    
    }