.NET：对象持久化模型

适用于 .NET 的 AWS 开发工具包提供的对象持久化模型让您能够将客户端类映射到 Amazon DynamoDB 表。然后，每个数据元实例都可以映射到对应表中的项目。为了在表中保存您的客户端对象，对象持久化模型提供了 DynamoDBContext 类，这是 DynamoDB 的入口点。这个类提供到 DynamoDB 的连接，让您能够访问表、执行各种 CRUD 操作，以及执行查询。

对象持久化模型提供一系列属性，用于将客户端类映射到表和将属性/字段映射到表的属性。

下面的示例显示了对象持久化模型的工作原理。它从 ProductCatalog 表开始。该表使用 Id 作为主键。

ProductCatalog(Id, ...)

假设您有一个包含 Title、ISBN 和 Authors 属性的 Book 类。您可以通过添加由对象持久化模型定义的属性将 Book 类映射到 ProductCatalog 表，如以下 C# 代码示例所示。

[DynamoDBTable("ProductCatalog")]
  public class Book
  {
    [DynamoDBHashKey]   
    public int Id { get; set; }

    public string Title { get; set; }
    public int ISBN { get; set; }

    [DynamoDBProperty("Authors")]    
    public List<string> BookAuthors { get; set; }

    [DynamoDBIgnore]    
    public string CoverPage { get; set; }
  }

在上述示例中，DynamoDBTable 属性将 Book 类映射到 ProductCatalog 表。

对象持久化模型支持类属性和表属性之间的明确映射和默认映射。

您无需映射每个单一类属性。您可以通过添加 DynamoDBIgnore 属性来识别这些属性。当您将 Book 实例保存到表中时，DynamoDBContext 不包括 CoverPage 属性，它也不会在您检索图书实例时返回此属性。

您可以映射 .NET 基元类型 (例如 int 和 string) 的属性。只要您能提供相应的转换器将任意数据映射到某个 DynamoDB 类型，您就可以映射任意数据类型。要了解有关映射任意类型的更多信息，请参阅使用适用于 .NET 的 AWS 开发工具包对象持久化模型向 DynamoDB映射任意数据。

对象持久化模型支持乐观锁。在执行更新操作期间，它可确保您具有要更新的项目的最新副本。有关更多信息，请参阅 乐观锁（使用版本号）与 DynamoDB（使用适用于 .NET 的 AWS 开发工具包对象持久化模型）配合使用。

受支持数据类型

对象持久化模型支持一系列 .NET 基元数据类型、集合和任意数据类型。该模型支持以下基元数据类型。

对象持久化模型也支持 .NET 集合类型。DynamoDBContext 能够转换实体集合类型和简单的无格式旧 CLR 对象 (POCO)。

下表汇总了上述 .NET 类型到 DynamoDB 类型的映射。

对象持久化模型也支持任意数据类型。但是，您必须提供转换器代码，才能将复杂类型映射到 DynamoDB 类型。