Dapper多对象查询一对多

Dapper 多对象查询一对多基础概念

Dapper 是一个轻量级的 ORM（对象关系映射）框架，用于简化 .NET 环境中的数据库操作。在一对多的关系中，一个实体类包含另一个实体类的集合。例如，一个订单（Order）可能包含多个订单项（OrderItem）。

优势

性能：Dapper 直接执行 SQL 查询，避免了传统 ORM 的性能开销。
灵活性：可以编写复杂的 SQL 查询，并且可以直接映射到自定义的 POCO（Plain Old CLR Object）对象。
简洁性：代码量少，易于理解和维护。

类型

一对一：一个实体对应另一个实体。
一对多：一个实体对应多个其他实体。
多对一：多个实体对应一个实体。
多对多：多个实体对应多个其他实体。

应用场景

电商系统：订单与订单项的关系。
博客系统：文章与评论的关系。
社交网络：用户与好友列表的关系。

示例代码

假设我们有两个实体类 Order 和 OrderItem，并且一个订单可以有多个订单项。

public class Order
{
    public int Id { get; set; }
    public string CustomerName { get; set; }
    public List<OrderItem> Items { get; set; } = new List<OrderItem>();
}

public class OrderItem
{
    public int Id { get; set; }
    public int OrderId { get; set; }
    public string ProductName { get; set; }
    public int Quantity { get; set; }
}

使用 Dapper 进行一对多查询的示例代码如下：

using (var connection = new SqlConnection("YourConnectionString"))
{
    connection.Open();

    var sql = @"
        SELECT o.Id, o.CustomerName, i.Id AS ItemId, i.ProductName, i.Quantity
        FROM Orders o
        LEFT JOIN OrderItems i ON o.Id = i.OrderId
        WHERE o.Id = @OrderId";

    var order = connection.Query<Order, OrderItem, Order>(
        sql,
        (orderObj, item) =>
        {
            orderObj.Items.Add(item);
            return orderObj;
        },
        splitOn: "ItemId",
        param: new { OrderId = 1 }
    ).FirstOrDefault();

    Console.WriteLine($"Order ID: {order.Id}, Customer: {order.CustomerName}");
    foreach (var item in order.Items)
    {
        Console.WriteLine($"Item: {item.ProductName}, Quantity: {item.Quantity}");
    }
}