SqlSugar入门级教程+实例 (.net core下的)

官方参考:http://www.codeisbug.com/Doc/8

前言:这应该是目前最好用的ORM框架之一了,而且支持.net core,网上除了官方文档其他参考就少了点,自己整理了一下,大致包括:

         · 概念

         ·  一个小demo(会涉及到T4模板生成Model)

         · 常见用法(增删改查)

数据库是sqlserver2012,vs2017版本的,其他还有什么想到再补充。

 

 

一:概念

1.优势

支持.NET 4.0+ 和 .NET CORE

支持主流数据库:SQL Server,MySql,Oracle,Sqlite等;

 

2.安装

Nuget直接搜索

项目是Core安装sqlSugarCore版本,.Net安装sqlSugar。

 

3.连接

通过参数ConnnectionConfig创建连接,ConnectionConfig有6个属性:

1. ConnectionString: 连接字符串 (必填)

2. Data Type: 数据库类型 (必填)

3. IsAutoCloseConnection: 是否自动释放数据库,默认false

4. InitKeyType: 读取主键和自增列信息的方式,默认SystemTable

5. More Settings: 全局设置

6. ConfigureExternalServices: 可以扩展你想要的序列化方式和缓存方式等服务

 

例:

SqlSugarClient db = new SqlSugarClient(new ConnectionConfig()

{

ConnectionString = Config.ConnectionString,

  DbType = DbType.SqlServer,         

  IsAutoCloseConnection = true,       

  InitKeyType = InitKeyType.SystemTable  

});

 

不过后面的版本有变动,以下是4.6.1版本的:

SqlSugar入门级教程+实例 (.net core下的)_第1张图片

 

SqlSugar对象不能是静态变量,但可以是静态属性。

例:

Public static SqlSugarClient Instance

{

get => new SqlSugarClient(xx);
]

Var db = 类.Instance;

db.Queryable().ToList;

 

 

二:项目实例

1:新建项目:.net core

SqlSugar入门级教程+实例 (.net core下的)_第2张图片

我选择空模板,其他的也行,建议MVC

 

2.添加两个类库(我习惯分层写,也可以不分层)

SqlSugar入门级教程+实例 (.net core下的)_第3张图片

一定是添加不要在上面新建

 

SqlSugar入门级教程+实例 (.net core下的)_第4张图片

 

3.在ORM层安装sqlSugar,.net选第一个就好了

SqlSugar入门级教程+实例 (.net core下的)_第5张图片

 

4.使用T4模板生成Model

a.先在sql server中建好表,数据库名:SqlSugarDemo

[表Student]:

SqlSugar入门级教程+实例 (.net core下的)_第6张图片

 

b.右键项目->添加文本模板,名字随便起,后缀tt

SqlSugar入门级教程+实例 (.net core下的)_第7张图片

 

c.写好tt模板保存一下就会刷新出model,Teacher和Course表先不用管

(tt模板里的内容自行百度,我照搬公司的就不贴了,其实都差不多,SqlSugarBase.cs是下一步建的,我截图晚了)

SqlSugar入门级教程+实例 (.net core下的)_第8张图片

 

5.在ORM层新建SqlSugarBase类,用来提供DB访问对象,代码可以参考官方文档:(代码已修正,本页最底下

using SqlSugar;

namespace SqlSugarDemo.ORM
{
    public class SqlSugarBase
    {
        public static string DB_ConnectionString { get; set; }
  
        public static SqlSugarClient DB
        {
            get => new SqlSugarClient(new ConnectionConfig()
            {
                    ConnectionString = DB_ConnectionString,
                    DbType = DbType.SqlServer,
                    IsAutoCloseConnection = true,
                    InitKeyType = InitKeyType.SystemTable,
                    IsShardSameThread = true
                }
            );           
        }
    }
}

SqlSugarBase

 

6.配置Startup.cs和appsettings.json,跟我一样建空模板的要在Web层(API)手动添加:(代码已修正,本页最底下

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using SqlSugarDemo.ORM;

namespace SqlSugarDemo
{
    public class Startup
    {
        readonly private IConfiguration _Configuration;
        public Startup(IConfiguration configuration)
        {
            this._Configuration = configuration;
        }

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc();

            SqlSugarBase.DB_ConnectionString = this._Configuration.GetConnectionString("connectionString");   //为数据库连接字符串赋值

        }

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            app.UseStaticFiles();

            app.UseMvc(routes =>
            {
                routes.MapRoute(
                    name: "default",
                    template: "{controller=Home}/{action=Index}/{id?}");

                routes.MapRoute(
                    name: "default1",
                    template: "{controller=Home}/{action=Index}/{id?}");
            });

        }


        //public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        //{
        //    if (env.IsDevelopment())
        //    {
        //        app.UseDeveloperExceptionPage();
        //    }

        //    app.Run(async (context) =>
        //    {
        //        await context.Response.WriteAsync("Hello World!");
        //    });
        //}
    }
}

startup.cs

以上代码有参考:https://www.cnblogs.com/kuangliwen/p/7895646.html

  "connectionString": "Server=127.0.0.1;Database=SqlSugarDemo;Integrated Security=False;User ID=sa;Password=sa;",
  "Logging": {
    "IncludeScopes": false,
    "Debug": {
      "LogLevel": {
        "Default": "Warning"
      }
    },
    "Console": {
      "LogLevel": {
        "Default": "Warning"
      }
    }
  }
}

appsettings.json

 

7.添加逻辑代码和控制类(可以不分开写)

在Service层右键添加HomeService.cs

using SqlSugarDemo.ORM;
using SqlSugarDemo.ORM.Entity;
using System.Collections.Generic;

namespace SqlSugarDemo.Service
{
    public class HomeService : SqlSugarBase
    {
        public List GetList()
        {
            return DB.Queryable().ToList();
        }
    }
}

HomeService.cs

DB.Queryable().ToList();   相当于select * from Student

 

在Web层右键添加HomeController.cs(代码已修正,本页最底下

using Microsoft.AspNetCore.Mvc;
using SqlSugarDemo.Service;

namespace SqlSugarDemo.API
{
    public class HomeController : Controller
    {
        readonly HomeService _HomeService;
        public HomeController(HomeService homeService)
        {
            _HomeService = homeService;
        }

        [HttpGet]
        public IActionResult Index()
        {
            var result =   _HomeService.GetList();
            ViewBag.Result = result;
            return View();
        }
    }
}

HomeController.cs

 

8.最后别忘了添加Index页面

最终项目结构:

SqlSugar入门级教程+实例 (.net core下的)_第9张图片

我觉得这个项目结构不是很好,随意看看

 编译通过,运行我报500的错误(惨兮兮),原因还在找,可能第6步有点问题,所以不能验证结果,反正过程大致是这么个过程。

//0810更新:数据库连接有问题,稍后修改

//0813更新:全部代码已修改完毕,详见底部

 

 

三:SqlSugar常用方法总结

先上之前的三张表:

[Student]

SqlSugar入门级教程+实例 (.net core下的)_第10张图片

[Teacher]

SqlSugar入门级教程+实例 (.net core下的)_第11张图片

[Course]

很简单的三张表,Id都是主键自增,其中Student.CourseId = Course.Code = Teacher.CourseId

 

 【查询】

1. 查询所有

var result = DB.Queryable().ToList();

相当于 :

select * from Student;

 

2. 跟据主键查询:id为方法参数

var result =  DB.Queryable().InSingle(id);

相当于 :

select * from Student where Id = id;

 

3. 根据给定的字段查询:name为方法参数

var result = DB.Queryable().Where(s => s.Name == name);

相当于:

select * from Student where Name = name;

 

4. 模糊查询:方法参数key为关键字

var result = DB.Queryable().Where(s => s.Name.Contains(key)).ToList();

相当于:

select * from Student where Name  like ‘%key%’;

 

5. 双表查询

var result = DB.Queryable((a, b) => new object[] {
             JoinType.Left,a.CourseId==b.CourseId})
             .Select((a, b) => new { Student = a.Name, Teacher = b.Name }).ToList();

以上将结果返回匿名对象,要是返回实体对象,第三行new 一个model就行了。

相当于:

select Student.Name student,Teacher.Name teacher

from Student

left join Teacher

on Student.CourseId = Teacher.CourseId;

 

6. 三表查询,根据给定id查询学生姓名,老师和课程名称

var result = DB.Queryable((a, b, c) => new object[] {
                        JoinType.Left,a.CourseId == b.CourseId,
                        JoinType.Left,b.CourseId == c.Code
                    })
                    .Where(a => a.Id == id)
                    .Select((a, b, c) => new  { Student = a.Name, Teacher = b.Name,Course = c.name }).ToList();

以上同样返回匿名对象

相当于:

select Student.Name student,Teacher.Name teacher,Course.name course  

from Student

left join Teacher

on Student.CourseId = Teacher.CourseId

left join Course

on Course.Code = Teacher.CourseId

where Student.Id = id;

 

7. 分页,以第四条为例,方法参数pageIndex为页数,pageSize为条数

var result = DB.Queryable().Where(s => s.Name.Contains(key)).ToPageList(pageIndex, pageSize).ToList();

 

 

【删除】

1. 根据主键删除,id为方法参数

var result = DB.Deleteable().In(id).ExecuteCommand();

相当于:

Delete from Student where Id = id;

 

2. 根据主键批量删除,ids为方法参数

var result = DB.Deleteable().In(ids).ExecuteCommand();

 

3. 根据给定字段删除,name为方法参数

var result = DB.Deleteable().Where(s => s.Name == name).ExecuteCommand();

相当于:

Delete from Student where Name = name;

 

4. 批量删除,key为关键字

var result = DB.Deleteable().Where(s => s.Name.Contains(key)).ExecuteCommand();

相当于:

Delete from Student where Name like’%a%’;

 

 【添加】

以向表Student添加数据为例:

 

 

public bool Insert()
        {
            Student model = new Student();
            model.StuId = 8;
            model.Name = "abc";
            model.CourseId = 2;
            var test = DB.Insertable(model).ExecuteCommand();
            return test > 0;
        }

ps:关键就是:DB.Insertable(model).ExecuteCommand()   这一句。

不一定要写,可以使用匿名对象;

model赋值也可以放到添加方法里,比如:

var test = DB.Insertable(new StudentModel

{

Name = "abc",

//这里想要添加几个字段就写几个

}).ExecuteCommand()

 

【更新】

跟添加类似,DB.Insertable(model).ExecuteCommand()  改为  DB.Updateable(model).ExecuteCommand();

 

 



 

代码修改:

Startup.cs:

public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }
        public IConfiguration Configuration { get; }

        public void ConfigureServices (IServiceCollection services)
        {
            services.AddMvc();
        }
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            app.UseStaticFiles();
            app.UseMvc(routes =>
            {
                routes.MapRoute(
                    name: "default",
                    template: "{controller=Home}/{action=Index}/{id?}");
            });
        }
    }

SqlSuagrBase:(连接字符串本来应该在appsettings里的,这个示范不太好,不过作为小demo就不考虑那么多了)

public abstract class SqlSugarBase
    {
        public SqlSugarClient DB => GetInstance();

        SqlSugarClient GetInstance()
        {
            string connectionString = "Server=127.0.0.1;Database=SqlSugarDemo;Integrated Security=False;User ID=sa;Password=sa;";

            var db = new SqlSugarClient(
                new ConnectionConfig
                {
                    ConnectionString = connectionString,
                    DbType = DbType.SqlServer,
                    IsShardSameThread = true
                }
            );
            return db;
        }
    }

Home Controller:这里把Index删了,重新写了查询方法,View里面的Index也可以不用了。

 [HttpGet]
        public List GetList()
        {
            var result = _HomeService.GetList();
            return result;
        }

代码到这里就结束了,下面我添加了一个单元测试来测试这个方法(引用Xunit),测试通过。

SqlSugar入门级教程+实例 (.net core下的)_第12张图片

代码我整理一下再贴上来。

你可能感兴趣的:(VS)