萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MS SQL 資料庫

非同步 SQL 資料庫存取封裝元件設計詳解

設計目標

  • 簡化 ADO.NET 同步/非同步資料庫操作。
  • 預防死鎖,支援非阻塞呼叫模式。
  • 零外部依賴,純 C# 實作,針對 SQL Server。

架構分層

  1. BLL (Business Logic Layer):基底類別,封裝連線池、非同步執行緒、回呼機制、事件驅動狀態通知。不可直接實例化,供 DAL 繼承。
  2. 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 重試原則(指數退避、斷路器)。
  • 加入分散式追蹤。
copyright © 萬盛學電腦網 all rights reserved