.NET ORM框架 SqlSugar4.0 功能快速預覽【開源】

孫凱旋發表於2017-06-18

ORM框架SqlSugar

SqlSugar 4.0 ORM框架的優勢

為了未來能夠更好的支援多庫分散式的儲存，平行計算等功能，將SqlSugar3.x全部重寫，現有的架構可以輕鬆擴充套件多庫。

原始碼下載：

https://github.com/sunkaixuan/SqlSugar

1.效能

效能最好的ORM之一,具有超越Dapper的效能，走的是EMIT夠構中間語言動態編譯到程式集，完成高效能的實體繫結，達到原生水平。

測試方式用Realease模式，Realease DLL 進行的車輪戰

2.功能

除了EF以外可以說的是功能最大的ORM框架

支援 DbFirst、CodeFirst、資料庫維護、鏈式查詢、鏈式更新、鏈式刪除、鏈式插入、實體屬性、複雜模型的查詢、ADO.NET。特別是批量等功能都是貨真價實的並非迴圈操作。

SqlSugar 4.0版本 6月底支援SqlSever的Core版 ,預計7月份支援多庫,8月分開始分散式ORM的開發。 (3.x版本已經支援了4種資料庫，相對穩定功能簡單)

3.語法

完美的語法，可以秒殺現有所有ORM框架

SqlSugar 4.0 三表查詢並分頁

   int total=0;
   var list8 = db.Queryable<Student,School,School>((st,sc,sc2) =>st.SchoolId ==sc.Id&&sc.Id ==sc2.Id)
                .Select((st, sc, sc2) =>new{st.Name,st.Id,schoolName = sc.Name})
                .ToPageList(1, 2,ref total)

EF 二表查詢並分頁

var queryable = (from a in StudentList
                      join b in SchoolList1
                      on a.Id equals b.Id into b1
                      from b2 in b1.DefaultIfEmpty()
                      select new
                      {
                          a.Id,
                          a.Name,
                          t = b2.Name
 
                      });
var listp = queryable.Skip((pageIndex - 1) * pageSize).Take(pageSize).ToList();
var total = queryable.Count();

從上面的語法可以看出兩者之前的差距，3表查詢比EF2表查詢還要簡潔

我們在來看一下條件拼接的例子

SqlSugar語法：

var list = db.Queryable<Student>()
                .WhereIF(!string.IsNullOrEmpty(a),it => it.Name == a)
                .WhereIF(!string.IsNullOrEmpty(b), it => it.Name == b).ToList();

EF語法：

var queryable = db.Queryable<Student>();
if (!string.IsNullOrEmpty(a)) {
    queryable = queryable.Where(it => it.Name == a);
}
if (!string.IsNullOrEmpty(b)) {
    queryable = queryable.Where(it => it.Name == b);
}
var list = queryable.ToList();

是不是簡單很多呢？

4.輕量級

總大小隻有200多K，比EF的一個小外掛都小，EF主體有5M

5.持續更新

本來4.X預計3月份就可以開發完成的，因為換了新公司半年都是996工作制，我只有週日和晚上有時間開發，可以說我基本都沒有休息過。下半年工作不會這麼緊，我的時間會更充足一些。

功能詳解

SqlSugar 4.X 總共有九大核心功能，並且都設計為鏈式操作，鏈式操作有什麼好處？

第一鏈式操作可以減少方法的過載

第二鏈式操作可以讓程式碼更加易讀，舉個例子一個方法有很多過載，你在寫的程式碼就不清楚這些過載是做嘛的，需要F12到方法主體去看備註。

例如：第一種寫法就能清楚的知道是否建創屬性，並且只建立Student這張表的檔案，第二種方法雖然簡單不易讀

db.DbFirst.IsCreateAttribute().Where("Student").CreateClassFile("c:\\Demo\\5");

db.DbFirst.CreateClassFile(true,"Student","c:\\Demo\\5");

第三鏈式操更具有擴充套件性例如有1234 我可以1和2一組，234一組 1和4一組，如果是過載的方式至少要有十個以上的過載後期將很難維護，功能越多後期易讀越差，也不靈活。

1.Queryable

查詢的核心物件，可以實現多表查詢，分組查詢，分頁，支援SqlFunc函式和拉姆達解析，除EF外也是對拉姆達解析支援最好的ORM之一

簡單查詢

查詢所有

var getAll = db.Queryable<Student>().ToList();

無鎖查詢

var getAllNoLock = db.Queryable<Student>().With(SqlWith.NoLock).ToList();

根據主鍵查詢

var getByPrimaryKey = db.Queryable<Student>().InSingle(2)

查詢單條沒有資料返回NULL, Single超過1條會報錯，First不會

var getSingleOrDefault = db.Queryable<Student>().Single();
var getFirstOrDefault = db.Queryable<Student>().First();

IN查詢

//Id In (1,2,3)
var in1 = db.Queryable<Student>().In(it=>it.Id,new int[] { 1, 2, 3 }).ToList();

//主鍵 In (1,2,3)
var in2 = db.Queryable<Student>().In(new int[] { 1, 2, 3 }).ToList();

//Id In (1,2)
int[] array = new int[] { 1, 2 };
var in3 = db.Queryable<Student>().Where(it=>array.Contains(it.Id)).ToList();

NOT IN查詢

var in3 = db.Queryable<Student>().Where(it=>!array.Contains(it.Id)).ToList();

多條件查詢

var getByWhere = db.Queryable<Student>().Where(it => it.Id == 1 || it.Name == "a").ToList();

使用函式 SqlFunc類

var getByFuns = db.Queryable<Student>().Where(it => SqlFunc.IsNullOrEmpty(it.Name)).ToList();

可以使用 SUM MAX MIN AVG查詢單個欄位

var sum = db.Queryable<Student>().Sum(it => it.Id);

Between 1 and 20

var between = db.Queryable<Student>().Where(it => SqlFunc.Between(it.Id, 1, 20)).ToList();

使用 AS 取新的表名

var getListByRename = db.Queryable<School>().AS("Student").ToList();

排序

var getAllOrder = db.Queryable<Student>()
.OrderBy(it => it.Id)//asc
.OrderBy(it => it.Name, OrderByType.Desc)//desc
.ToList()

是否存在這條記錄

var isAny = db.Queryable<Student>().Where(it => it.Id == -1).Any();
var isAny2 = db.Queryable<Student>().Any(it => it.Id == -1);

獲取同一天的記錄

var getTodayList = db.Queryable<Student>().Where(it => SqlFunc.DateIsSame(it.CreateTime, DateTime.Now)).ToList();

多表查詢

//LEFT JOIN 
var list = db.Queryable<Student, School>((st, sc) => new object[] {
JoinType.Left,st.SchoolId==sc.Id
})
.Where(st => st.Name == "jack").ToList();

//三表 LEFT JOIN
var list2 = db.Queryable<Student, School, Student>((st, sc, st2) => new object[] {
JoinType.Left,st.SchoolId==sc.Id,
JoinType.Left,st.SchoolId==st2.Id
})
.Where((st, sc, st2) => st2.Id == 1 || sc.Id == 1 || st.Id == 1).ToList();

//返回 List<ViewModelStudent>
var list3 = db.Queryable<Student, School>((st, sc) => new object[] {
JoinType.Left,st.SchoolId==sc.Id
}).Select((st, sc) => new ViewModelStudent { Name = st.Name, SchoolId = sc.Id }).ToList();

//join Order By (order by st.id desc,sc.id desc)
var list4 = db.Queryable<Student, School>((st, sc) => new object[] {
JoinType.Left,st.SchoolId==sc.Id
})
.OrderBy(st => st.Id, OrderByType.Desc)
.OrderBy((st, sc) => sc.Id, OrderByType.Desc)
.Select((st, sc) => new ViewModelStudent { Name = st.Name, SchoolId = sc.Id }).ToList();

多表查詢簡化，與JOIN的方式高低搭配，如果不需要LEFT JOIN可以簡寫成下面的語句

var list5 = db.Queryable<Student, School>((st, sc) => st.SchoolId == sc.Id)
.Select((st,sc)=>new {st.Name,st.Id,schoolName=sc.Name}).ToList();

//三表查詢
var list6 = db.Queryable<Student, School,School>((st, sc,sc2) => st.SchoolId == sc.Id&&sc.Id==sc2.Id)
.Select((st, sc,sc2) => new { st.Name, st.Id, schoolName = sc.Name,schoolName2=sc2.Name }).ToList();

//三表查詢分頁
var list8 = db.Queryable<Student, School, School>((st, sc, sc2) => st.SchoolId == sc.Id && sc.Id == sc2.Id)
.OrderBy(st=>st.Id)
.Select((st, sc, sc2) => new { st.Name, st.Id, schoolName = sc.Name, schoolName2 = sc2.Name }).ToPageList(1, 2);

分組查詢

var group = db.Queryable<Student>().GroupBy(it => it.Id)
    .Having(it => SqlFunc.AggregateCount(it.Id) > 10)
    .Select(it => new { id = SqlFunc.AggregateCount(it.Id) }).ToList();

根據欄位分組取第一條，這個非常的好用

var list3 = db.Queryable<Student>()
.PartitionBy(it => new { it.Id, it.Name }).Take(1).ToList();

實體轉換支援2級模型

var s5 = db.Queryable<Student>().Select(it => new ViewModelStudent { Student = it, Name = it.Name }).ToList();
 
//實體結構  
public class ViewModelStudent {
  public Student Student{get;set;}
  pulic string Name{get;set;}
}

如果你是欄位串拼接愛好者你也可以這樣與拉姆達混用，或者純拼SQL

var join3 = db.Queryable("Student", "st")
        .AddJoinInfo("School", "sh", "sh.id=st.schoolid")
        .Where("st.id>@id")
        .AddParameters(new { id = 1 })
        .Select("st.*").ToList();

支援的原生函式

.ToString

.Contains 

.Length

.ToLower

.ToUpper

.ToSubstring 

.Equals

.HasValue

.Replace

.EndsWith

.StartsWith

.Trim

支援的自定義函式

三元判段，相當於 it.id==1?1:2

SqlFunc.IIF(it.Id == 1, 1, 2)

判段是NULL或者空

SqlFunc.IsNullOrEmpty(object thisValue)

判段不是NULL並且不是空

SqlFunc.HasValue(object thisValue)

判段大於0並且不等於NULL

SqlFunc.HasNumber(object thisValue)

轉小寫

SqlFunc.ToLower(object thisValue)

轉大寫

SqlFunc.ToUpper(object thisValue)

去前後空格

SqlFunc.Trim(object thisValue)

模糊查詢 like %@p%

SqlFunc.Contains(string thisValue, string parameterValue)

也可以使用 .Where(it=>it.Name.Contains("a"));

In操作 thisValue={1,2,3} 生成的Sql就是 paramterValie in (1,2,3)

SqlFunc.ContainsArray(object[] thisValue, string parameterValue)

也可以使用 .Where(it=>Array.Contains(it.Id));
Not In 操作
.Where(it=>!Array.Contains(it.Id));

模糊查詢 like @p%

SqlFunc.StartsWith(object thisValue, string parameterValue

模糊查詢 like %@p

SqlFunc.EndsWith(object thisValue, string parameterValue)

等於

SqlFunc.Equals(object thisValue, object parameterValue)

是否是同一天

SqlFunc.DateIsSame(DateTime date1, DateTime date2)

是否是同一時間（dataType 可以是年、月、天、小時、分鐘、秒和毫秒）

SqlFunc.DateIsSame(DateTime date1, DateTime date2, DateType dataType)

在當前時間加一定時間（dataType 可以是年、月、天、小時、分鐘、秒和毫秒）

SqlFunc.DateAdd(DateTime date, int addValue, DateType dataType)

在當前時間加N天

SqlFunc.DateAdd(DateTime date, int addValue)

獲取當前時間的年、月、天、小時、分鐘、秒或者毫秒

SqlFunc.DateValue(DateTime date, DateType dataType)

範圍判段

SqlFunc.Between(object value, object start, object end)

型別轉換

SqlFunc.ToInt32(object value) 
SqlFunc.ToInt64(object value)
SqlFunc.ToDate(object value) 
SqlFunc.ToString(object value) 
SqlFunc.ToDecimal(object value) 
SqlFunc.ToGuid(object value) 
SqlFunc.ToDouble(object value) 
SqlFunc.ToBool(object value)

擷取字串

SqlFunc.Substring(object value, int index, int length)

替換字串

SqlFunc.Replace(object value, string oldChar, string newChar)

獲取字串長度

SqlFunc.Length(object value) { throw new NotImplementedException(); }

聚合函式

SqlFunc.AggregateSum<TResult>(TResult thisValue) 
SqlFunc.AggregateAvg<TResult>(TResult thisValue)
SqlFunc.AggregateMin(TResult thisValue) 
SqlFunc.AggregateMax<TResult>(TResult thisValue) 
SqlFunc.AggregateCount<TResult>(TResult thisValue)

如果還有不支援的可以寫字串

db.Queryable<Student>().Where("xxx(xx)")

2.Updateable

updateable主要功能有批量更新、單條更新、指定更新列、排除更新列、根據拉姆達更新、根據實體更新等操作

根據實體更新（主鍵要有值，主鍵是更新條件）

var t1 = db.Updateable(updateObj).ExecuteCommand();

只更新實體裡面的Name列(主鍵要有值，主鍵是更新條件)

var t3 = db.Updateable(updateObj).UpdateColumns(it => new { it.Name }).ExecuteCommand();

更新 Name和 TestId 以外的所有列 (主鍵要有值，主鍵是更新條件)

var t4 = db.Updateable(updateObj)
.IgnoreColumns(it => new { it.Name, it.TestId }).ExecuteCommand();

更新NAME

var t5 = db.Updateable(updateObj)
.IgnoreColumns(it => it=="name" ).With(SqlWith.UpdLock).ExecuteCommand();

使用鎖

var t6 = db.Updateable(updateObj).With(SqlWith.UpdLock).ExecuteCommand();

批量更新(主鍵要有值，主鍵是更新條件)

List<Students> list=GetList();
var t7 = db.Updateable(list).ExecuteCommand();

實體更新，並且給指定列重新賦值

var t8 = db.Updateable(updateObj)
.ReSetValue(it => it.Name == (it.Name + 1)).ExecuteCommand();

更新實體，更新條件是根據表達示

var t9 = db.Updateable(updateObj).Where(it => it.Id == 1).ExecuteCommand();

根據表示式中的列更新，指定列並賦值的更新，比較常用

var t10 = db.Updateable<Student>()
.UpdateColumns(it => new Student() { Name = "a", CreateTime = DateTime.Now })
.Where(it => it.Id == 11).ExecuteCommand();

別名表

db.Updateable<School>().AS("Student")
.UpdateColumns(it => new School() { Name = "jack" })
.Where(it => it.Id == 1).ExecuteCommand();
//Update Student set Name='jack' Where Id=1

是NULL的列不更新
db.Updateable(updateObj).Where(true).ExecuteCommand();

3.Insertable

Insertable主要功能有批量插入、單條插入、指定插入列、排除插入列等功能

插入並返回受影響行數用ExecuteCommand

var t2 = db.Insertable(insertObj).ExecuteCommand();

插入並返回自增列用ExecuteReutrnIdentity

var t3 = db.Insertable(insertObj).ExecuteReutrnIdentity();

只插入列 Name和SchoolId

var t4 = db.Insertable(insertObj).InsertColumns(it => new { it.Name, it.SchoolId }).ExecuteReutrnIdentity();

不插入列 Name和TestId

var t5 = db.Insertable(insertObj).IgnoreColumns(it => new { it.Name, it.TestId }).ExecuteReutrnIdentity();

根據條件指定不插入列

var t6 = db.Insertable(insertObj).IgnoreColumns(it => it == "Name" || it == "TestId").ExecuteReutrnIdentity();

使用鎖

var t8 = db.Insertable(insertObj).With(SqlWith.UpdLock).ExecuteCommand();

可以設定NULL列不插入和是否強制插入自增列

var t9 = db.Insertable(insertObj2)
.Where(true/* Is no insert null */, true/*off identity*/)
.ExecuteCommand();

批量插入

var insertObjs = new List<Student>();
var s9 = db.Insertable(insertObjs.ToArray()).ExecuteCommand();

Deleteable

根據主鍵刪除、單條刪除、條件刪除、表示式刪除等功能

根據實體刪除（實體內主鍵一定要有值）

var t0 = db.Deleteable<Student>().Where(new Student() { Id = 1 }).ExecuteCommand();

根據實體集刪除

var t1 = db.Deleteable<Student>().Where(new List<Student>() { new Student() { Id = 1 } }).ExecuteCommand();

使用鎖

var t2 = db.Deleteable<Student>().With(SqlWith.RowLock).ExecuteCommand();

根據主鍵刪除

var t3 = db.Deleteable<Student>().In(1).ExecuteCommand();

根據主鍵批量刪除

var t4 = db.Deleteable<Student>().In(new int[] { 1, 2 }).ExecuteCommand();

根據表示式刪除

var t5 = db.Deleteable<Student>().Where(it => it.Id == 1).ExecuteCommand();

其它功能的一些簡介

因為功能太多九大功能只講了4大功能的用法，其它功能我就簡單描述一下

DbFirst：用於建立實體、支援模型自定義、可以生成全部表的實體、也可以指定表和支援生成屬性和預設值

CodeFirst:支援通過類生成實體、主鍵、自增列、支援表的備份和欄位名稱的修改

Ado.Net：支援SqlQuery<T> 一系列原生SQL操作支援事務、儲存過程輸出引數等功能

DbMaintenance：資料庫的維護操作支援表備份、庫備份、新增表、新增列、獲取表資訊、根據表獲取主鍵等相關資料庫層面的操作

EntityProvider：獲取實體類的相關資訊

另外支援了複雜模型的用法：

  var students = db.Queryable<CMStudent>().ToList();
  if (students != null)
  {
       foreach (var item in students)
       {
            Console.WriteLine(item.SchoolName);
 
            Console.WriteLine(item.SchoolSingle.Name);
             
            Console.WriteLine(item.SchoolList.Count);
    }
  }