Question

当使用JPA的时候，我们需要将Java实体类映射到关系型表和列上。JPA规范提供了一些支持对象-关系映射的注解，而有一些JPA实现，如Hibernate，也添加了自己的映射注解。

但是，MongoDB并没有提供对象-文档映射的注解。Spring Data MongoDB填补了这一空白，提供了一些将Java类型映射为MongoDB文档的注解。表12.1描述了这些注解。

表12.1　用于对象-文档映射的Spring Data MongoDB注解

注　　解	描　　述
@Document	标示映射到MongoDB文档上的领域对象
@Id	标示某个域为ID域
@DbRef	标示某个域要引用其他的文档，这个文档有可能位于另外一个数据库中
@Field	为文档域指定自定义的元数据
@Version	标示某个属性用作版本域

@Document和@Id注解类似于JPA的@Entity和@Id注解。我们将会经常使用这两个注解，对于要以文档形式保存到MongoDB数据库的每个Java类型都会使用这两个注解。例如，如下的程序清单展现了如何为Order类添加注解，它会被持久化到MongoDB中。

程序清单12.5　Spring Data MongoDB注解将Java类型映射为文档

我们可以看到，Order类添加了@Document注解，这样它就能够借助MongoTemplate或自动生成的Repository进行持久化。其id属性上使用了@Id注解，用来指定它作为文档的ID。除此之外，customer属性上使用了@Field注解，这样的话，当文档持久化的时候customer属性将会映射为名为client的域。

注意，其他的属性并没有添加注解。除非将属性设置为瞬时态（transient）的，否则Java对象中所有的域都会持久化为文档中的域。并且如果我们不使用@Field注解进行设置的话，那么文档域中的名字将会与对应的Java属性相同。

同时，需要注意的是items属性，它指的是订单中具体条目的集合。在传统的关系型数据库中，这些条目将会保存在另外的一个数据库表中，通过外键进行应用，items域上很可能还会使用JPA的@OneToMany注解。但在这里，情形完全不同。

图12.1　文档展现了关联但非规范化的数据。
相关的概念（如订单中的条目）被嵌入到顶层的文档数据中

如我前面所述，文档可以与其他的文档产生关联，但这并不是文档数据库所擅长的功能。在本例购买订单与行条目之间的关联关系中，行条目只是同一个订单文档里面内嵌的一部分（如图12.1所示）。因此，没有必要为这种关联关系添加任何注解。实际上，Item类本身并没有任何注解：

我们没有必要为Item添加@Document注解，也没有必要为它的域指定@Id。这是因为我们不会单独将Item持久化为文档。它始终会是Order文档中Item列表的一个成员，并且会作为文档中的嵌入元素。

当然，如果你想指定Item中的某个域如何持久化到文档中，那么可以为对应的Item属性添加@Field注解。不过在本例中，并没有必要这样做。

我们现在已经为Java对象添加了MongoDB持久化的注解。接下来，看一下如何使用MongoTemplate来存储它们。