C# 資源池實作：高效管理昂貴資源的通用模式

編輯：關於C語言

前言

在實際專案開發中，資料庫連線、執行緒、大型物件等「昂貴資源」的頻繁建立與銷毀會帶來顯著的效能開銷。資源池模式透過重複使用已建立的資源實例，能有效降低系統延遲並提升吞吐量。本文介紹一個基於 C# 泛型實作的通用資源池 ResourcePool<T>，並示範如何整合至專案中。

核心架構

主要類別與介面

ResourcePool<T>：資源池核心類別，負責資源的獲取、歸還、閒置回收與最大數量控制。
IResourceProvider<T>：資源提供者介面，定義 Request() 建立新資源與 Dispose(T) 釋放資源的邏輯，讓資源池解耦具體資源建立細節。
ResourceTag<T>：內部標記類別，追蹤資源是否正在使用中，支援池內部的狀態管理。

關鍵操作流程

呼叫 GetResource(out resourceID) 向池請求資源；池內若有閒置資源則直接返回，否則透過 IResourceProvider 建立新資源（未達上限時）。
使用完畢後，呼叫 ReturnResource(ref resource, resourceID) 歸還資源，標記為可重用。
資源池依據策略（如閒置超時、定期掃描）決定何時釋放多餘資源，避免記憶體洩漏。

實戰範例：SqlConnection 資源池

以下示範如何為 SqlConnection 建立資源池，並在單元測試中驗證基本功能。

1. 實作 IResourceProvider<SqlConnection>

using System;
using System.Data.SqlClient;

public class SqlConnectionProvider : IResourceProvider<SqlConnection>
{
    public SqlConnection Request()
    {
        var conn = new SqlConnection("YourConnectionStringHere");
        conn.Open(); // 資源池要求管理「可用」的資源，故此處預先開啟
        return conn;
    }

    public void Dispose(SqlConnection conn)
    {
        conn?.Dispose();
    }
}

2. 單元測試驗證

using NUnit.Framework;
using System.Data.SqlClient;

[TestFixture]
public class ResourcePoolTests
{
    [Test]
    public void TestPool_BasicUsage()
    {
        // 初始化資源池：提供者實例、最大資源數 10
        var pool = ResourcePool<SqlConnection>.Instance(new SqlConnectionProvider(), 10);

        long resourceId;
        SqlConnection conn = pool.GetResource(out resourceId);
        Assert.IsNotNull(conn);
        Assert.IsTrue(conn.State == System.Data.ConnectionState.Open);

        // 使用連線執行命令...
        // using (var cmd = conn.CreateCommand()) { ... }

        // 歸還資源
        pool.ReturnResource(ref conn, resourceId);
        Assert.IsNull(conn); // 歸還後參考應被清空
    }
}