Mongodb的ORM框架Morphia技术POJO类注解详解.docx

Mongodb的ORM框架Morphia技术POJO类注解详解 1、Entity 如果你想通过Morphia把你的对象保存到Mongo中，你首先要做的是使用Entity注解你的类：import com.google.code.morphia.annotations.Entity; Entity public class Hotel . A、名称和构造方法 你可以为你的MongoDB DBConllection设置名称。必须有一个无参的默认构造方法。Entity(hotels) public class Hotel . public Hotel() . 注意：你的默认构造方法不一定是public，也可以是protected或private。B、在文档中的类名和怎样废弃使用类名在Entity注解中提供了一个可选的参数用来标识是否在文档中保存类名。Entity(value=hotels, noClassnameStored=true)public class Hotel .public Hotel() . 默认会在文档中保存类名。为什么要使用他哪？保存类名的主要目的是，当你在同一个链接中保存不同的实体对象，但是你想作为他们的基类或超类来读取。 如：Entity(animals) abstract class Animal String name; Entity(animals) Cat extends Animal . Entity(animals) Dog extends Animal . /And then performing the following query.List animals = ds.createQuery(Animal.class).asList(); 正如你看到的，如果不在文档中保存类名，Morphia将不能正确的识别创建那个类。如果你在一个链接中只保存唯一的实体类型并且你还关心你的数据库大小，在你的Entity注解上加上noClassnameStored=true参数将会是安全的。 2、Id被Entity注解的类必须有一个唯一的 Id值；这些值被保存在 MongoDB数据库的“id”属性中，这是一个必须的位索引。像在Hotel 类中：Entitypublic class HotelIdprivate ObjectId id; .如上所示：被Id注解的ID是ObjectId类型的，这样，你就不用担心Id的生成问题了，Mongo会自动为你生成一个唯一的新的ObjectId对象（就像MySQL中的auto_increment类型的ID）。如果你想使用其他的类型作为ID，那么在你保存数据时就必须手动为ID赋值。 3、Indexed此注解是为某个字段申请一个索引。 当datastore.ensureIndexes() 方法被调用时 这些索引就会被申请. 更多如下：把Indexed注解在你想让MongoDB创建索引的属性上。Entitypublic class Product Id private ObjectId id; Indexed(value=IndexDirection.ASC, name=upc, unique=true, dropDups=true) private String upcSymbol; . 参数说明如下：value:表名这个索引的方向； IndexDirection.ASC(升序)，IndexDirection.DESC(降序), IndexDirection.BOTH(两者)；默认为 升序。name： 被创建的索引的名称； mongodb默认创建的索引名的格式为(key1_1/-1_key2_1)。unique：创建一个唯一索引，当创建唯一索引后，当在此字段插入相同的值时将会报错。true:为唯一索引；false：不是唯一索引；默认为：false。dropDups：此参数表明，当为某个字段创建唯一索引时，删除其他相同值的记录。只保留第一条记录。true:删除重复；false:不删除重复（当有重复值时唯一索引创建失败）；默认为false。向MongoDB申请创建索引 Datastore.ensureIndexes()需要被调用。这个方法应该在你已经使用Morphia注册了你的实体类后被调用。他将会异步创建你的所有索引。 这个动作也许会在你每次启动你的应用时都被执行。 注意：当在一个存在的系统上，创建已经存在的索引时，将不会花费任何事件(也不会做任何事情)。 Morphia m = . Datastore ds = . m.map(Product.class); ds.ensureIndexes(); /为被Indexed注解的所有字段创建索引。 你可以在 /display/DOCS/Indexes 了解更多关于MongoDB索引的信息。 4、Embedded你可以创建一个类被嵌套在实体类中，在这种情况下我们可以使用Embedded注解。例如，在Hotel类中 可能会有一个Address。 Address是Hotel不可分割的一部分，没有ID, 并且不会被存储在分开的collection中。在这种情况下我们可以使用Embedded注解Address.Entitypublic class Hotel . Idprivate ObjectId id;Embeddedprivate Address address; . Embeddedpublic class Address.正如你所看到的，被Embedded注解的类没有Id。 这是因为他们经常被嵌套在其他类中。事实上，被Embedded注解的类也不允许有Id。 5、Transient和Property一般情况下，保存原始和基本类型的属性到Mongo中，你不必为他们添加任何注解：.private int myInt;private Date myDate;private List myStrings;private String stringArray;. 默认情况下，Morphia将会试着映射所有支持的基本和原始类型到Mongo，包括这些类型的数组。MongoDB仅仅有以下数据类型：Integer(32位有符号值)Long(64有符号值) Double(64位IEEE745浮点值)String (字符串) 这里有些有价值的转换：float doublebyte intshort intchar String 并且，依赖于你的模型中存在的类型和数据库将会试着自动为你转换。我的意思是，因为在MongoDB数据库中只存在三种数字类型(32/64有符号， 64位FP)这将相当容易转换。下面的列表为当前什么样的基本和原始类型可以被保存：enum(在Mongo中作为String保存)java.util.Date(在Mongo中保存为从新纪元UTC的毫秒数)java.util.Locale(作为字符串保存)com.mongodb.DBRefcom.mongodb.ObjectId 正如我我们上面的例子所示，Morphia还支持java.util.List, java.util.Set和java.util.Map容器，和任何支持的原始类型的数组。如果你想把一个属性排除映射到Mongo中， 你可以使用Transient注解： import com.google.code.morphia.annotations.Transient;.Transient private int myTransientInt;. 默认情况下，Morphia把属性名作为Mongo中的字段名。这个可以通过Property注解进行修改，指定一个名称。import com.google.code.morphia.annotations.Property; . Property(my_integer) private int myInt; /在MongoDB中为my_integer . 6、ReferenceMongo在同一个数据库引用一个文档(对象)到另一个。考虑以下类：public class BlogEntry private String title; private Date publishDate; private String body; private Author author; / getters and setters.public class Author private String username; private String fullName; private String emailAddress; / getters and setters 这里的一个问题就是：我们如果注解BlogEntry中的author属性？当然，我们可以是用Embedded注解，但是这样就没什么意义了，因为在每个BlogEntry实例中都保存一个Author对象。我们反而想在多个blog实例中引用一个单独的Author文档(对象)在Mongo中。在这种情况下我们使用 Reference注解import com.google.code.morphia.annotations.Entity;import com.google.code.morphia.annotations.Embedded;import com.google.code.morphia.annotations.Id;import com.google.code.morphia.annotations.Reference;import com.google.code.morphia.annotations.Property; Entitypublic class BlogEntry Id private ObjectId id; private String title; private Date publishDate; private String body; Reference private Author author; / getters and setters.Entitypublic class Author Id private ObjectId id; private String username; private String fullName; private String emailAddress; / getters and setters 当使用引用时有很重要的一点我们必须提及：被引用的对像在被引用之前必须已经保存到了MongoDB数据库中。这个真的的意思是。就像上面的例子，在你创建一个BlogEntry对象之前，一个Author已经被保存到了