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/
這只是基礎的使用，後續我也會發進階用法，小夥伴們自己研究吧！加油、未來可期