Dapper 多表关联查询与对象映射技巧

概述

在使用Dapper进行数据库操作时，经常会遇到需要将多个关联表的数据映射到复杂对象结构中的场景。本文将通过一个典型示例，详细介绍如何使用Dapper高效地实现这种多表关联查询和对象映射。

典型场景分析

假设我们有以下业务模型：

• 用户(User)信息
• 产品(Product)信息
• 订单(Order)信息，其中包含用户信息和产品列表

对应的C#类定义如下：

public class User
{
    public int Id { get; set; }
    public string FirstName { get; set; }
    public string LastName { get; set; }
}

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Description { get; set; }
    public decimal Price { get; set; }
}

public class Order
{
    public int Id { get; set; }
    public DateTime OrderDate { get; set; }
    public User Customer { get; set; }
    public IEnumerable<Product> Products { get; set; }
}

Dapper多表查询解决方案

方案一：使用QueryMultiple方法

Dapper提供了QueryMultiple方法，可以执行包含多个结果集的查询：

var sql = @"
SELECT * FROM Orders WHERE Id = @id;
SELECT * FROM Users WHERE Id = (SELECT UserId FROM Orders WHERE Id = @id);
SELECT p.* FROM Products p 
INNER JOIN OrderProducts op ON p.Id = op.ProductId
WHERE op.OrderId = @id;
";

using (var multi = connection.QueryMultiple(sql, new { id }))
{
    var order = multi.Read<Order>().Single();
    order.Customer = multi.Read<User>().Single();
    order.Products = multi.Read<Product>().ToList();
    return order;
}

方案二：使用多映射(Query with Multi-Mapping)

Dapper支持通过Query方法实现多表映射：

var sql = @"
SELECT o.*, u.*, p.*
FROM Orders o
INNER JOIN Users u ON o.UserId = u.Id
INNER JOIN OrderProducts op ON o.Id = op.OrderId
INNER JOIN Products p ON op.ProductId = p.Id
WHERE o.Id = @id
";

var orderDictionary = new Dictionary<int, Order>();

var order = connection.Query<Order, User, Product, Order>(
    sql,
    (o, u, p) => 
    {
        if (!orderDictionary.TryGetValue(o.Id, out var orderEntry))
        {
            orderEntry = o;
            orderEntry.Customer = u;
            orderEntry.Products = new List<Product>();
            orderDictionary.Add(orderEntry.Id, orderEntry);
        }
        ((List<Product>)orderEntry.Products).Add(p);
        return orderEntry;
    },
    new { id },
    splitOn: "Id,Id"  // 指定分割列
).Distinct().Single();

方案三：使用JSON聚合(PostgreSQL/MySQL)

对于支持JSON功能的数据库，可以使用JSON聚合：

var sql = @"
SELECT 
    o.*,
    u.*,
    (SELECT json_agg(p.*) 
     FROM Products p 
     INNER JOIN OrderProducts op ON p.Id = op.ProductId
     WHERE op.OrderId = o.Id) AS Products
FROM Orders o
INNER JOIN Users u ON o.UserId = u.Id
WHERE o.Id = @id
";

var order = connection.Query<Order>(sql, new { id }).Single();

性能优化建议

1. 索引优化：确保关联字段(UserId, ProductId等)有适当的索引
2. 分页处理：对于大数据量结果集，考虑实现分页
3. 延迟加载：对于不常用的关联数据，可以考虑延迟加载策略
4. 缓存策略：对频繁访问但不常变化的数据实施缓存

常见问题解决

1. 列名冲突：使用AS关键字为列指定别名
2. 空值处理：使用Dapper的DefaultValue特性或自定义类型转换器
3. 循环引用：在JSON序列化时配置忽略循环引用

总结

Dapper提供了多种方式来处理复杂对象关系的映射，开发者可以根据具体场景选择最适合的方案。对于简单关系，多映射方法简洁高效；对于复杂关系，QueryMultiple方法提供了更好的灵活性；而JSON聚合则在支持该功能的数据库中提供了极简的解决方案。