使用Dapper映射嵌套对象

基础概念

Dapper 是一个轻量级的 ORM（对象关系映射）框架，用于简化 C# 中的数据库操作。它允许开发者通过简单的对象映射来执行 SQL 查询，并将结果自动映射到 C# 对象中。嵌套对象映射是指将数据库中的多表关联数据映射到一个复杂对象中，这个复杂对象包含多个子对象。

优势

性能：Dapper 的性能优于许多其他 ORM 框架，因为它直接使用 ADO.NET，避免了额外的开销。
简单易用：Dapper 的 API 设计简洁，易于上手和使用。
灵活性：Dapper 支持多种数据库，且不强制使用特定的数据库访问模式。
轻量级：Dapper 不依赖于复杂的配置文件或大量的依赖库。

类型

Dapper 支持多种映射方式，包括：

简单对象映射：将数据库表中的每一行映射到一个简单的 C# 对象。
嵌套对象映射：将数据库中的多表关联数据映射到一个复杂对象中。
动态对象映射：将查询结果映射到动态类型。

应用场景

嵌套对象映射常用于以下场景：

多表关联查询：当需要从多个表中获取数据并组合成一个复杂对象时。
实体关系映射：在 ORM 中表示实体之间的关系，如一对多、多对多等。

示例代码

假设有两个表：Users 和 Orders，它们通过 UserId 进行关联。

CREATE TABLE Users (
    Id INT PRIMARY KEY,
    Name NVARCHAR(100)
);

CREATE TABLE Orders (
    Id INT PRIMARY KEY,
    UserId INT,
    ProductName NVARCHAR(100),
    FOREIGN KEY (UserId) REFERENCES Users(Id)
);

对应的 C# 类定义如下：

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    public List<Order> Orders { get; set; }
}

public class Order
{
    public int Id { get; set; }
    public int UserId { get; set; }
    public string ProductName { get; set; }
}

使用 Dapper 映射嵌套对象的代码如下：

using System.Collections.Generic;
using System.Data.SqlClient;
using Dapper;

public class UserRepository
{
    private readonly string _connectionString;

    public UserRepository(string connectionString)
    {
        _connectionString = connectionString;
    }

    public User GetUserWithOrders(int userId)
    {
        using (var connection = new SqlConnection(_connectionString))
        {
            connection.Open();

            var query = @"
                SELECT u.Id, u.Name, o.Id AS OrderId, o.ProductName
                FROM Users u
                LEFT JOIN Orders o ON u.Id = o.UserId
                WHERE u.Id = @UserId";

            return connection.Query<User, Order, User>(query, (user, order) =>
            {
                user.Orders ??= new List<Order>();
                user.Orders.Add(order);
                return user;
            }, splitOn: "OrderId", param: new { UserId = userId }).FirstOrDefault();
        }
    }
}