Azure.Data.Tables SDK中POCO与TableEntity双向转换及泛型实现问题

问题场景 #

我在使用Azure.Data.Tables SDK时，发现大部分示例都是基于已废弃的WindowsAzure SDK，无法直接复用。我定义了多个实现ITableEntity接口的POCO实体，例如：

public class BenefitEntity: ITableEntity
{
    public string PartitionKey { get; set; }
    public string RowKey { get; set; }
    public DateTimeOffset? Timestamp { get; set; }
    public ETag ETag { get; set; }
    public string Name { get; set; }
    public double Value { get; set; }
}

使用TableClient<TableEntity>查询返回Pageable<TableEntity>是正常的：

var results = tableClient.Query<TableEntity>(filter: $"PartitionKey eq '{partitionKey}'");

但此时只能通过TableEntity.GetString("Name")这类方法取值，无法直接用tableClient.Query<BenefitEntity>返回强类型的Pageable<BenefitEntity>，也找不到TableEntity与自定义POCO实体的简便双向转换方式。我希望实现一个泛型方法，支持指定实体类型来返回强类型集合，但最初尝试的方案都不适用。

解决过程 #

经过测试发现，直接将Query方法的类型参数替换为自定义实体类型（如BenefitEntity），就能正常返回Pageable<BenefitEntity>。为了适配30余种实体类型，我编写了泛型查询方法：

public Pageable<T> GetItems<T>(string tableName, string partitionKey, string accountName, string storageAccountKey, string storageUri)
{ 
    var tableClient = new TableClient(
    new Uri(storageUri),
    tableName,
    new TableSharedKeyCredential(accountName, storageAccountKey));

    return tableClient.Query<T>(filter: $"PartitionKey eq '{partitionKey}'");
}

但运行时提示错误：类型T需要是引用类型且具有公共无参构造函数。添加对应的泛型约束后，方法即可正常运行：

public Pageable<T> GetItems<T>(string tableName, string partitionKey, string accountName, string storageAccountKey, string storageUri) 
    where T : class, ITableEntity, new()
{ 
    var tableClient = new TableClient(
    new Uri(storageUri),
    tableName,
    new TableSharedKeyCredential(accountName, storageAccountKey));

    return tableClient.Query<T>(filter: $"PartitionKey eq '{partitionKey}'");
}

关键总结 #

• Azure.Data.Tables原生支持对实现ITableEntity的POCO实体进行强类型查询，无需手动通过DynamicTableEntity或反射做转换
• 泛型查询方法必须添加三个约束：
  • class：确保T是引用类型
  • ITableEntity：确保T符合表实体的接口规范
  • new()：SDK需要通过无参构造函数实例化实体对象

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