.NET中使用DynamoDBContext查询单表子对象的实现方法

完全可以通过DynamoDbContext API自动完成订单中产品集合的反序列化，不需要手动映射或多查询，核心是正确配置实体类的DynamoDB属性标记。

1. 配置实体类的映射规则 #

给Order类中的产品集合属性添加[DynamoDBProperty]标记，同时确保嵌套的Product类也正确标记每个字段：

public class Order
{
    [DynamoDBHashKey] // 订单主键
    public string OrderId { get; set; }
    
    [DynamoDBProperty]
    public string CustomerName { get; set; }
    
    // 关键：标记产品集合属性，框架会自动反序列化
    [DynamoDBProperty]
    public List<Product> Products { get; set; }
}

public class Product
{
    [DynamoDBProperty]
    public string ProductId { get; set; }
    
    [DynamoDBProperty]
    public string ProductName { get; set; }
    
    [DynamoDBProperty]
    public decimal UnitPrice { get; set; }
    
    [DynamoDBProperty]
    public int Quantity { get; set; }
}

2. 用DynamoDbContext执行查询 #

初始化DynamoDBContext后，直接调用QueryAsync<Order>，框架会自动将DynamoDB中的嵌套集合数据反序列化为List<Product>：

// 初始化DynamoDB客户端和上下文
var client = new AmazonDynamoDBClient();
var context = new DynamoDBContext(client);

// 构建查询条件
var queryConfig = new QueryOperationConfig
{
    KeyExpression = new Expression
    {
        ExpressionStatement = "OrderId = :orderId",
        ExpressionAttributeValues = new Dictionary<string, DynamoDBEntry>
        {
            { ":orderId", new Primitive("ORD-0001") }
        }
    }
};

// 执行查询并获取结果
var orderResults = await context.QueryAsync<Order>(queryConfig).GetRemainingAsync();
// 此时orderResults[0].Products已自动反序列化为产品集合

3. 注意事项 #

• 确保DynamoDB中存储的产品集合是原生List类型：如果你的订单数据里产品是以分隔字符串、JSON字符串等非原生集合格式存储的，需要自定义转换器，通过[DynamoDBProperty(typeof(YourCustomConverter))]标记属性，实现自定义序列化/反逻辑。
• 如果产品数据是存在独立表中的关联数据（而非嵌套在订单表），那确实需要多查询获取订单后再查产品表，但这种场景属于关联查询，和嵌套集合的自动反序列化是两回事。

为什么不用手动映射？ #

DynamoDbContext的核心价值就是封装了底层的字典与实体类的转换逻辑，相比直接用AmazonDynamoDbClient手动解析Dictionary<string, AttributeValue>，能大幅减少重复代码，降低映射错误的概率。

内容的提问来源于stack exchange，提问作者Joe