本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 数据类注释
<a name="ddb-en-client-anno-index"></a>

下表列出了可用于数据类的注释，并提供了指向本指南中信息和示例的链接。该表按注释名称的字母升序排序。


**本指南中使用的数据类注释**  

| 注释名称 | 注释适用于1 | 作用 | 本指南中显示的位置 | 
| --- | --- | --- | --- | 
| DynamoDbAtomicCounter | 属性2 | 每次向数据库写入记录时都会增加一个带标签的数字属性。 | [介绍和讨论。](ddb-en-client-extensions.md#ddb-en-client-extensions-ACE) | 
| DynamoDbAttribute | 属性 | 定义或重命名映射到 DynamoDB 表属性的 Bean 属性。 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sdk-for-java/latest/developer-guide/ddb-en-client-anno-index.html)  | 
| DynamoDbAutoGeneratedTimestampAttribute | 属性 | 每次成功将项目写入数据库时，都使用当前时间戳更新已标记的属性 | [介绍和讨论](ddb-en-client-extensions.md#ddb-en-client-extensions-AGTE)。 | 
| DynamoDbAutoGeneratedUuid | 属性 | 向数据库写入新记录时，为属性生成唯一的 UUID（通用唯一标识符）。 | [介绍和讨论。](ddb-en-client-extensions.md#ddb-en-client-extensions-AGUE) | 
| DynamoDbBean | class | 将数据类标记为可映射到表架构。 | 第一次是在“入门”部分的 [Customer 类](ddb-en-client-gs-tableschema.md#ddb-en-client-gs-tableschema-anno-bean-cust)上使用。本指南中展示了几种用法。 | 
| DynamoDbConvertedBy | 属性 | 将自定义 AttributeConverter 与带注释的属性相关联。 | [初步讨论和示例。](ddb-en-client-adv-features-conversion.md#ddb-en-client-adv-features-conversion-single) | 
| DynamoDbFlatten | 属性 | 扁平化单独的 DynamoDB 数据类的所有属性，并将它们作为顶级属性添加到从数据库读取的记录和写入数据库的记录中。 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sdk-for-java/latest/developer-guide/ddb-en-client-anno-index.html)  | 
| DynamoDbIgnore | 属性 | 导致属性保持未映射状态。 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sdk-for-java/latest/developer-guide/ddb-en-client-anno-index.html)  | 
| DynamoDbIgnoreNulls | 属性 | 防止保存嵌套 DynamoDb 对象的空属性。 | [讨论和示例。](ddb-en-client-adv-features-ignore-null.md) | 
| DynamoDbImmutable | class | 将不可变数据类标记为可映射到表架构。 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sdk-for-java/latest/developer-guide/ddb-en-client-anno-index.html)  | 
| DynamoDbPartitionKey | 属性 | 将属性标记为 DynamoDb 表的主分区键（哈希键）。 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sdk-for-java/latest/developer-guide/ddb-en-client-anno-index.html)  | 
| DynamoDbPreserveEmptyObject | 属性 | 如果映射到带注释的属性的对象没有数据，则指定应使用所有空字段初始化该对象。 | [讨论和示例。](ddb-en-client-adv-features-empty.md) | 
| DynamoDbSecondaryPartitionKey | 属性 | 将属性标记为全局二级属性的分区键。 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sdk-for-java/latest/developer-guide/ddb-en-client-anno-index.html)  | 
| DynamoDbSecondarySortKey | 属性 | 将属性标记为全局或本地二级索引的可选排序键。 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sdk-for-java/latest/developer-guide/ddb-en-client-anno-index.html)  | 
| DynamoDbSortKey | 属性 | 将属性标记为可选的主排序键（范围键）。 |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/sdk-for-java/latest/developer-guide/ddb-en-client-anno-index.html)  | 
| DynamoDbUpdateBehavior | 属性 | 指定在“更新”操作（例如 UpdateItem）中更新此属性时的行为。 | [简介和示例。](ddb-en-client-adv-features-upd-behavior.md) | 
| DynamoDbVersionAttribute | 属性 | 递增项目版本号。 | [介绍和讨论。](ddb-en-client-extensions.md#ddb-en-client-extensions-VRE) | 

1您可以对 getter 或 setter 应用属性级注释，但不能同时应用两者。本指南显示了有关 getter 的注释。

2对于封装在 JavaBean 数据类中的值，通常使用术语 `property`。但是，为了与 DynamoDB 使用的术语保持一致，本指南（英文版）改用术语 `attribute`。（中文版中，两者的翻译均为“属性”。）