SqlSugar基礎用法

SQLSugar是什麼

**1. 輕量級ORM框架，專為.NET CORE開發人員設計，它提供了簡單、高效的方式來處理資料庫操作，使開發人員能夠更輕鬆地與資料庫進行互動

2. 簡化資料庫操作和資料訪問，允許開發人員在C#程式碼中直接運算元據庫，而不需要編寫複雜的SQL語句

3. 支援多種資料庫，包括但不限於MYSQL、SQLSERVER、SQLITE、ORACLE等**

使用SQLSugar的優點與缺點

優點：

1. 高效能：相比EF等ORM框架，SQLSUGAR在效能上表現出色。在大資料的寫入、更新和查詢統計方面，SQLSUGAR的效能是EF的數倍。此外，它在批次操作和一對多查詢上也進行了不錯的SQL最佳化。

2. 高擴充套件性：SQLSUGAR支援自定義拉姆達函式解析、擴充套件資料型別、自定義實體特性，以及外部快取等功能，這些都使得其具有較高的可擴充套件性。

3. 穩定性：雖然不是官方的ORM框架，但SQLSUGAR在穩定性上也有著數年使用者積累。如果遇到問題，可以在GITHUB上提出，開發者會根據緊急度定期解決。

4. 功能全面：雖然SQLSUGAR體積小巧，但其功能並不遜色於其他大型ORM框架，如EF。

5. 生態豐富與多庫相容：SQLSUGAR支援多種資料庫，為開發者提供了靈活的選擇。同時，它還提供了詳細的文件、教程以及專業技術支援，為開發者提供了全方位的服務。

6. 易用性：SQLSUGAR的使用非常簡單，它提供了各種預設值作為最佳配置，開發者只需關注自己的業務邏輯即可。這種易用性大大降低了學習成本，提高了開發效率。

缺點

沒啥大缺點

SQLSugar基礎使用

安裝SQLSugarCore包

建立上下文類

配置連結字串--這塊有點坑、以下這種格式可能會爆錯、SLL證書錯誤

以下是我的連結字串

Data Source=.;Initial Catalog=SQLSugarDemo;Integrated Security=True;Trust Server Certificate=True

註冊SQLSugar--我封裝了Ioc

在控制器定義方法進行遷移資料庫

當然你也可以用命令進行遷移

Sugar遷移命令：
dotnet ef migrations add 生成資料夾名稱 --project SqlSugarTests.WebAPI.csproj
dotnet ef database update
遷移命令有點麻煩還不一定能遷移成功，可以用ef或者方法進行遷移

以下是基礎用法(增刪改查)

我大概是給整複雜了，我封裝了一下、我再研究研究給整簡單點

定義泛型介面

介面與實現

``

點選檢視程式碼

 public interface IRepository<T> where T : class,new()
 {
     // 插入（增）  
     Task<int> Insert(T entity);
     // 根據ID查詢（查）  
     Task<T> GetById(int id);
     //刪除
     Task<int> DeleteById(int id);

     // 更新（改）  
     Task<bool> Update(T entity, Expression<Func<T, bool>> whereCondition);

     // 刪除（刪）  
     Task<bool> Delete(Expression<Func<T, bool>> whereCondition);

     // 查詢（查）  
     Task<T> Get(Expression<Func<T, bool>> whereCondition);

     // 查詢列表  
     Task<List<T>> GetAll(Expression<Func<T, bool>> whereCondition = null);
     
 }

``

點選檢視程式碼

public class Repository<T> : IRepository<T> where T : class, new()
{
    private readonly ISqlSugarClient _db;

    public Repository(ISqlSugarClient db)
    {
        _db = db;
    }
    // 插入（增）  
    public async Task<int> Insert(T entity)
    {
        try
        {
            return await _db.Insertable(entity).ExecuteCommandAsync();
        }
        catch (Exception ex)
        {
            // 處理異常或記錄日誌  
            throw;
        }
    }
    // 更新（改）  
    public async Task<bool> Update(T entity, Expression<Func<T, bool>> whereCondition)
    {
        try
        {
            var updateable = _db.Updateable(entity).Where(whereCondition);
            return await updateable.ExecuteCommandAsync() > 0;
        }
        catch (Exception ex)
        {
            // 處理異常或記錄日誌  
            throw;
        }
    }
    // 刪除（刪）  
    public async Task<bool> Delete(Expression<Func<T, bool>> whereCondition)
    {
        try
        {
            return await _db.Deleteable<T>().Where(whereCondition).ExecuteCommandAsync() > 0;
        }
        catch (Exception ex)
        {
            // 處理異常或記錄日誌  
            throw;
        }
    }
    // 查詢（查）  
    public async Task<T> Get(Expression<Func<T, bool>> whereCondition)
    {
        try
        {
            return await _db.Queryable<T>().Where(whereCondition).SingleAsync();
        }
        catch (Exception ex)
        {
            // 處理異常或記錄日誌  
            return null;
        }
    }

    // 查詢列表  
    public async Task<List<T>> GetAll(Expression<Func<T, bool>> whereCondition = null)
    {
        try
        {
            var query = _db.Queryable<T>();
            if (whereCondition != null)
            {
                query = query.Where(whereCondition);
            }
            return await query.ToListAsync();
        }
        catch (Exception ex)
        {
            // 處理異常或記錄日誌  
            return null;
        }
    }
    //查詢單個
    public async Task<T> GetById(int id)
    {
        // 使用SQLSugar的Queryable API來獲取單個實體  
        var result = _db.Queryable<T>().InSingle(id);
        // 注意：這裡result已經是DepartmentModel的例項或null（如果沒有找到）  
        // 因為InSingle是同步的，所以不需要await  
        return result;
    }
    /// <summary>
    /// 刪除
    /// </summary>
    /// <param name="id"></param>
    /// <returns></returns>
    public async Task<int> DeleteById(int id)
    {
        var result =_db.Deleteable<T>().In(id).ExecuteCommand();
        return result;
    }

    #region 其他擴充套件
    public async Task<bool> Delete<T1>(int id)
    {
        throw new NotImplementedException();
    }
    public async Task<List<T1>> GetAll<T1>()
    {
        throw new NotImplementedException();
    }
    public T1 GetById<T1>(int id)
    {
        throw new NotImplementedException();
    }
    public int Insert<T1>(T1 entity)
    {
        throw new NotImplementedException();
    }
    public bool Update<T1>(T1 entity, int? id = null)
    {
        throw new NotImplementedException();
    }
    #endregion

}

然後我封裝了IocServer

這段程式碼主要做了兩件事：

將ISqlSugarClient註冊為Scoped服務到依賴注入容器中，並配置了資料庫連線和AOP日誌記錄。

將SqlSugarContext（可能是一個封裝了ISqlSugarClient的上下文類）也註冊為Scoped服務，並確保它能夠從DI容器中獲取到ISqlSugarClient的例項。

``

點選檢視程式碼

 public static void AddRepositoryServer(this WebApplicationBuilder builder)
 {
     // 直接註冊 ISqlSugarClient 到 DI 容器  
     builder.Services.AddScoped<ISqlSugarClient>(sp => new SqlSugarClient(new ConnectionConfig()
     {
         ConnectionString = builder.Configuration.GetConnectionString("SQLSugar"), //資料庫連線串
         DbType = DbType.SqlServer,      //資料庫型別
         IsAutoCloseConnection = true, //自動釋放
         MoreSettings = new ConnMoreSettings()
         {
             SqlServerCodeFirstNvarchar = true,//建表字串預設Nvarchar
         }
     }, db =>
     {
         db.Aop.OnLogExecuting = (sql, pars) =>
         {
             Console.WriteLine(sql);//生成執行Sql語句
         };
     }
     ));
     builder.Services.AddScoped<SqlSugarContext>(sp => new SqlSugarContext(sp.GetRequiredService<ISqlSugarClient>()));
 }

在Program進行註冊

控制器裡使用

``

點選檢視程式碼

public readonly SqlSugarContext db;
private readonly IRepository<DepartmentModel> _repository;
public SQLSugarController(SqlSugarContext context, IRepository<DepartmentModel> repository)
{

    this.db = context;
    this._repository = repository;
}
/// <summary>
/// 建立表
/// </summary>
/// <returns></returns>
[HttpGet("CreateTable")]
public IActionResult CreateTable()
{
    db.CreateTable();
    return Ok("執行成功！");
}
// 新增部門  
[HttpPost("AddDepartment")]
public async Task<IActionResult> AddDepartment([FromBody] DepartmentModel departmentModel)
{
    if (ModelState.IsValid)
    {
        int result = await _repository.Insert(departmentModel);
        if (result > 0)
        {
            return Ok(new { message = "部門新增成功", departmentId = departmentModel.DepartMentId });
        }
        else
        {
            return BadRequest(new { message = "部門新增失敗" });
        }
    }
    else
    {
        return BadRequest(ModelState);
    }
}

// 更新部門  
[HttpPut("UpdateDepartment")]
public async Task<IActionResult> UpdateDepartment(int id, [FromBody] DepartmentModel departmentModel)
{
    if (ModelState.IsValid && departmentModel.DepartMentId == id)
    {
        bool result = await _repository.Update(departmentModel);
        if (result)
        {
            return Ok(new { message = "部門更新成功" });
        }
        else
        {
            return BadRequest(new { message = "部門更新失敗" });
        }
    }
    else
    {
        return BadRequest(ModelState);
    }
}

// 刪除部門  
[HttpDelete("DeleteDepartment")]
public async Task<IActionResult> DeleteDepartment(int id)
{
    int result = await _repository.DeleteById(id);
    if (result!=0)
    {
        return Ok(new { message = "部門刪除成功" });
    }
    else
    {
        return NotFound(new { message = "未找到要刪除的部門" });
    }
}
[HttpGet("GetDepartment")]
public async Task<IActionResult> GetDepartment(int id)
{
    DepartmentModel department = await _repository.GetById(id);
    if (department != null)
    {
        // 將DepartmentModel轉換為DepartmentDto，這裡只是一個簡單的示例  
        //var departmentDto = new DepartmentDto { DepartMentId = department.DepartMentId };
        return Ok(department);
    }
    else
    {
        return NotFound(new { message = "未找到要獲取的部門" });
    }
}
// 獲取所有部門  
[HttpGet("GetAllDepartments")]
public async Task<IActionResult> GetAllDepartments()
{
    List<DepartmentModel> departments = await _repository.GetAll();
    return Ok(departments);
}

官方網站：
果糖網： https://www.donet5.com/
這只是基礎的使用，後續我也會發進階用法，小夥伴們自己研究吧！加油、未來可期