設計目標
- 簡化 ADO.NET 同步/非同步資料庫操作。
- 預防死鎖,支援非阻塞呼叫模式。
- 零外部依賴,純 C# 實作,針對 SQL Server。
架構分層
- BLL (Business Logic Layer):基底類別,封裝連線池、非同步執行緒、回呼機制、事件驅動狀態通知。不可直接實例化,供 DAL 繼承。
- DAL (Data Access Layer):業務具體實作,定義具體存儲過程/查詢方法,對應不同資料表建立不同 DAL 類別。
核心類別結構
namespace SQLWrapper {
// 回呼結果基類
public abstract class CallbackResult {
public TimeSpan tsWaitForResult = TimeSpan.FromSeconds(30); // 預設命令逾時
public eWaitForSQLResult WaitResult { get; set; }
}
public class StoredProcedureCallbackResult : CallbackResult {
public eRequestType RequestType { get; }
public SqlParameter[] Parameters { get; set; }
public object ScalarValue { get; set; }
public int AffectedRows { get; set; }
public SqlDataReader ResultDataReader { get; set; }
public StoredProcedureCallbackResult(eRequestType type) { RequestType = type; }
}
// 類似定義 ReaderQueryCallbackResult, NonQueryCallbackResult, ScalarQueryCallbackResult
}
DAL 實作範例
public class Dal : BLL {
public Dal(string server, string db, string user, string pass) {
base.Start(server, db, user, pass); // 初始化連線字串、啟動背景執行緒
}
~Dal() { base.Stop(eStopType.ForceStopAll); }
// 同步呼叫範例:執行存儲過程回傳 Scalar
public int GetUserCount(int deptId) {
var ud = new StoredProcedureCallbackResult(eRequestType.Scalar) {
Parameters = new[] { new SqlParameter("@DeptId", deptId) }
};
if (!ExecuteStoredProcedure("usp_GetUserCount", ud)) throw new Exception("執行失敗");
if (WaitSqlCompletes(ud) != eWaitForSQLResult.Success) throw new Exception("逾時/失敗");
return (int)ud.ScalarValue;
}
// 非同步啟動,回傳 CallbackResult 供呼叫端輪詢
public StoredProcedureCallbackResult GetUserCountAsync(int deptId) {
var ud = new StoredProcedureCallbackResult(eRequestType.Reader) {
Parameters = new[] { new SqlParameter("@DeptId", deptId) }
};
ExecuteStoredProcedure("usp_GetUserList", ud);
return ud; // 呼叫端需定期呼叫 WaitSqlCompletes(ud, 10) 檢查狀態
}
}
呼叫端非同步輪詢模式
var ud = dal.GetUserCountAsync(10);
while (true) {
switch (dal.WaitSqlCompletes(ud, 10)) { // 每 10ms 檢查一次
case eWaitForSQLResult.Waiting: continue;
case eWaitForSQLResult.Success:
using (var rd = ud.ResultDataReader) {
while (rd.Read()) { /* 處理資料 */ }
}
break;
default: throw new Exception("資料庫執行失敗");
}
break;
}
資料庫連線狀態事件
// BLL 內部事件
public event Action OnDatabaseStatusChanged;
// 斷線/重連時自動觸發,上層可據此顯示狀態或重試邏輯
關鍵設定:命令逾時與連線逾時
- 連線字串
Connection Timeout:建立連線最長等待秒數。
- 命令物件
CommandTimeout:單一指令執行最長秒數(預設 30 秒)。
- 本元件透過
ud.tsWaitForResult 控制非同步等待上限,可針對長跑查詢單獨調大。
擴充建議
- 支援
async/await 模式(.NET 4.5+),回傳 Task<T>。
- 整合
Polly 重試原則(指數退避、斷路器)。
- 加入分散式追蹤。