Morphia快速入门

使用Morphia

下面的代码说明了如何去初始化一个Morphia的实例。使用这个实例,你可以通过Morphia去映射你的实体。

Morphia morphia = new Morphia();

// 告诉Morphia在哪里找到你的类
// 可以为不同的包或者类进行多次的调用
morphia.mapPackage("org.mongodb.morphia.example");

//创建datastore,并连接到指定数据库
//datastore有两个参数,第一个用来连接到MongoDB,第二个是数据库的名字。
final Datastore datastore = morphia.createDatastore(new MongoClient(), "morphia_example");
datastore.ensureIndexes();

通过这种方法配置Morphia,我们可以通过创建多个Datastore实例来连接到多个数据库。
第二行代码,我们告诉Morphia去指定的package中寻找所有标记了@Entity的类,以及所有在类中的映射元数据。(@Id,@Reference等等)。

映射选项

当你拥有了Morphia实例,以可以通过MappingOption类去配置多种映射选项。当创建Morphia时,可以指定Mapper,但大部分用户会使用默认的Mapper。两种最常用的配置参数是storeEmptiesstoreNulls。默认情况下,Morphia不会向MongoDB中存储空的表或者映射值,也不会存储空值。如果你需要去存储这些值,需要把这两个参数设置为true。其它的一些设置这里不一一赘述。

映射类

Morphia有两种方法控制你的类:作为顶级的实体或者潜入在其它实体内。
所有被注释为@Entity的类都会被当作一个顶级的文档直接存储在一个集合中。所有被注释为@Entity的类都必须有一个字段注释为@Id,这会被用来当作MongoDB中的_id字段。@Embedded表明这个类会被作为一个文档里的子文档。@Embedded类不需要有@Id字段。

@Entity("employees")
@Indexes(
    @Index(value = "salary", fields = @Field("salary"))
)
class Employee {
    @Id
    private ObjectId id;
    private String name;
    @Reference
    private Employee manager;
    @Reference
    private List<Employee> directReports;
    @Property("wage")
    private Double salary;
}

这里我们举了一个例子。这个类使用了@Entity注释,所以它是一个顶层的文档。默认情况下,Morphia会使用类名作为集合名,如果你在之前指定了,如"employees",它会使用这个值作为集合名。在这个例子中,所有的Employee实例都会被保存在"employees"集合中。
注释@Indexes列出了Morphia应该创建的索引。在这个实例中,我们定义了一个名为salary的索引,它对salary做了升序排序。
我们标记了id字段作为主键。这个例子中我们使用了Java驱动中的ObjectId类型作为id的类型。这个ID可以是任何类型。除了transient和static的字段,Morphia试图去保存任何没有被注释的字段。
对于注释Property,这个注释是可选的。如果不使用这个注释,Morphia会使用Java中的字段名作为对应文档中的字段名。如果有时你想要改变文档中字段的名字,你可以使用注释Property,它会将你指定的名字传递过去。
剩下的一个注释是@Reference这个注释告诉Morphia这个字段引用了其它的映射实体。这样Morphia会存储MongoDB中被称为DBRef,即集合的名字和一些键值对。这些引用实体必须已经被保存或者至少被分配了ID,否则Morphia会抛出一个异常。

保存数据

大多数情况下,你可以像对待Java对象一样,如果你准备像数据库中写入数据,可以这样:

final Employee elmer = new Employee("Elmer Fudd", 50000.0);
datastore.save(elmer);

再进一步,我们可以定义一些关系并保存下来:

final Employee daffy = new Employee("Daffy Duck", 40000.0);
datastore.save(daffy);

final Employee pepe = new Employee("Pepé Le Pew", 25000.0);
datastore.save(pepe);

elmer.getDirectReports().add(daffy);
elmer.getDirectReports().add(pepe);

datastore.save(elmer);

我们只需要创建和保存其它的雇员,然后我们就可以将他们添加到报告列表中并保存。想要更新MongoDB中的数据,可以更新Java中的对象然后再次调用datastore.save()。对于块更新,这不是一种有效的更新方式。我们可以直接在数据库中进行更新,而不是从每个文档中取出来,转化为Java对象,更新,又转化为文档,再写入MongoDB。为了告诉你怎么这么做,我们需要先学习查询。

查询

Morphia尝试使你的查询类型安全。Morphia将会控制你的数据的所有转换细节,只有很少的一部分需要你去做额外的工作。

final Query<Employee> query = datastore.createQuery(Employee.class);
final List<Employee> employees = query.asList();

这是一个基本的Morphia查询。我们告诉Datastore去创建一个参数为Employee的查询。我们将所有取到的Employee放在一个List中。对于一个非常大的查询结果,对内存来说可能会吃不消。在这个简单的例子中,使用asList()是可以的,但实际上,fetch()通常是更好的选择。
大多数查询都希望使用某种方法去过滤数据,有两种方法:

underpaid = datastore.createQuery(Employee.class)
                     .field("salary").lessThanOrEq(30000)
                     .asList();

这里使用了field()方法来对指定字段进行过滤,返回一个许多方法的接口的实例来建立一次查询。总的来说,查询的建立可以被很安全的完成。
另一种办法是使用filter()方法,这种方法比field()形式更自由简洁。这里我们可以在查询字符串中嵌入特定的操作。虽然这比另一种更简洁,但它在字符串中留下了更多的东西去验证,会有可能出错。

List<Employee> underpaid = datastore.createQuery(Employee.class)
                                    .filter("salary <=", 30000)
                                    .asList();

两种方法的选择在大多数情况下是喜好的问题。每种方法,Morphia都回去验证Employee中被叫做salary的字段。如果数据库中的字段和Java字段不匹配,Morphia会使用任一种形式,对任一个名字进行验证。

更新

更新由两部分组成:一个查询和和一组更新操作符。这个例子中,我们将找到所有薪水低的员工并给他们涨薪10000.第一步是创建一个查询去找到所有的低薪员工:

final Query<Employee> underPaidQuery = datastore.createQuery(Employee.class)
                                             .filter("salary <=", 30000);

为了更新找到的文档,我们创建了一个UpdateOperations的实例。

final UpdateOperations<Employee> updateOperations = datastore.createUpdateOperations(Employee.class)
                                                   .inc("salary", 10000);

这里我们将salary字段增加了10000,对应的操作符是$inc。最后一步是:

final UpdateResults results = datastore.update(underPaidQuery, updateOperations);

这行执行了更新数据库。UpdateResults的实例将包含有关更新操作的各种统计数据。

删除

删除操作只需要进行查询,然后告诉Datastore去删除它。

final Query<Employee> overPaidQuery = datastore.createQuery(Employee.class)
                                                .filter("salary >", 100000);
datastore.delete(overPaidQuery);  

delete()方法有多种不同的形式,但这是做常用的。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容