PetaPoco詳解

一、PetaPoco開源

PetaPoco是一個開源的、輕量級的ORM框架，它是約翰·戴維斯（John P. Davies）寫的。PetaPoco意為「小Poco」（「Poco」是「Plain Old CLR Object」的縮寫，它代表一種純潔的、面向對象的編程思想）。通過PetaPoco，我們可以簡化資料庫訪問過程，將數據從資料庫查詢或保存到我們的類中，省去了很多重複的代碼。PetaPoco支持.NET Framework 3.5+、.NET Core 1.0+和Mono。

二、PetaPoco in

在使用PetaPoco時，我們需要在項目中添加PetaPoco的引用。

PM> Install-Package PetaPoco

三、PetaPoco 非同步

PetaPoco也支持非同步操作，從而提高應用程序的性能。下面是一個非同步獲取單個實體的示例：

public async Task<Product> GetProductAsync(int productId)
{
    using (var db = new Database("connectionStringName"))
    {
        return await db.SingleOrDefaultAsync<Product>("SELECT * FROM Products WHERE ProductId=@0", productId);
    }
}

四、PetaPoco 連接池

PetaPoco默認情況下使用連接池技術，這可以減少資料庫連接和斷開的次數，提高應用程序的性能。我們可以通過配置文件或代碼來設置連接池的大小、超時時間等參數。

<connectionStrings>
  <add name="myConnStr" connectionString="server=127.0.0.1;database=mydb;uid=myuser;pwd=mypass;pooling=true;Max Pool Size=100;" />
</connectionStrings>

五、PetaPoco 多對多

PetaPoco允許我們通過多對多的方式在數據表之間建立關聯，這非常實用。下面是一個多對多關係的示例：

[TableName("Users")]
[PrimaryKey("UserId")]
public class User
{
    public int UserId { get; set; }
    public string UserName { get; set; }
    public List<Role> Roles { get; set; }
}

[TableName("Roles")]
[PrimaryKey("RoleId")]
public class Role
{
    public int RoleId { get; set; }
    public string RoleName { get; set; }
    public List<User> Users { get; set; }
}

public static void LoadRoles(this Database db, User user)
{
    user.Roles = db.FetchBy<Role, UserRole>(
        u => u.UserId,
        new Sql("SELECT * FROM Roles WHERE RoleId IN (SELECT RoleId FROM UserRoles WHERE UserId=@UserId)", new { user.UserId }));
}

六、PetaPoco factory

PetaPoco也提供了一些工廠方法，用於創建Database對象。

var db = new Database("connectionStringName");

var db = new Database("server=127.0.0.1;database=mydb;uid=myuser;pwd=mypass;pooling=true;Max Pool Size=100;");

var db = PetaPoco.DatabaseConfiguration.Build().UsingConnectionString("connectionStringName").Create();

七、PetaPoco depper區別

PetaPoco有兩個版本：PetaPoco和PetaPoco.Core。其中，PetaPoco.Core是基於.NET Standard的版本，支持.NET Framework、.NET Core和Xamarin等平台。相比之下，PetaPoco的目標框架是.NET Framework，因此其不支持.NET Core等平台。

八、PetaPoco.netcore多線程並發

PetaPoco在.NET Core上支持多線程並發處理，這對於一些高並發場景非常有用。下面是一個多線程獲取數據的示例：

public async Task<List<Product>> GetProductsAsync(int categoryId, int page, int pageSize)
{
    using (var db = new Database("connectionStringName"))
    {
        string sql = "SELECT * FROM [Products] WHERE [CategoryId]=@0 ORDER BY [ProductId] OFFSET @1 ROWS FETCH NEXT @2 ROWS ONLY";
        List<Product> products = new List<Product>();
        var options = new ParallelOptions { MaxDegreeOfParallelism = 4 }; //設置4個線程
        await Task.Run(() =>
        {
            Parallel.For(0, 4, options, (i) =>
            {
                var list = db.Fetch<Product>(sql, categoryId, page + i * (pageSize / 4), pageSize / 4);
                lock (products)
                {
                    products.AddRange(list);
                }
            });
        });
        return products;
    }
}

九、PetaPoco oracle

除了支持SQL Server、MySQL等常見資料庫外，PetaPoco還支持Oracle資料庫。我們只需要修改連接字元串即可連接到Oracle資料庫。下面是一個示例：

<connectionStrings>
  <add name="myConnStr" connectionString="Data Source=//localhost:1521/XE;User Id=myuser;Password=mypass;" providerName="Oracle.ManagedDataAccess.Client" />
</connectionStrings>

十、PetaPoco vs2022

PetaPoco同樣支持最新的Visual Studio 2022開發環境。我們可以通過NuGet安裝VS2022的適配包。

PM> Install-Package PetaPoco.VS2022