为什么要使用CouchDB

jieforest

CouchDBUpdater会监听designdocs目录中的变化，同时自动地将这些变化推到配置的CouchDB数据库。

那么designdocs目录实际上包含什么内容呢？

1.     -designdocs
   
2.         -event
   
3.             -allByDate.map.js
   
4.             -allByParentId.map.js
   
5.             -allByVenueId.map.js
   
6.             -list.map.js
   
7.         -place
   
8.             -list.map.js
   

复制代码

实际上每一个目录都映射到CouchDB中的一个设计文档。

jieforest

图7 DesignDocs事件

jieforest

很好，接下来就让我们编写这些视图。

我们的第一个视图

下面是一个简单的视图，它会查找所有的“event” 类型的文档。

1. function(doc) {
   
2.     if (doc.docType == 'Event') {
   
3.         emit(doc.id, doc);
   
4.     }
   
5. }

复制代码

jieforest

该视图会简单的返回所有具有docType域并且该域值为Event的文档的id。让我们稍微检查一下它做了什么。第一行是一个 JavaScript函数定义，它仅接受一个doc参数。然后就能够检查存储在文档内的值（本例中是doc.docType）。最后，调用了emit函 数，它有两个参数key和value，其中value可以为null。在本例中，key是doc.id域，value是整个文档。

在接下来的几个视图示例中，emit函数才是我们实际上用到的查询数据库的方法。关于emit，我们需要理解的另外一关键点是，它会对返回的文档按照key值进行排序。

下面是调用list视图的测试用例。

1. CouchViewTest.java (testListingQuery())
   
2.     @Test
   
3.     public void testListingQuery() {
   
4.         String viewName = "event/list";
   
5.         ViewResult results = database.queryView(viewName, Event.class, null, null);         
   
6.         assertNotNull(results);
   
7.         assertEquals(27, results.getRows().size());
   
8.     }

复制代码

jieforest

通过venue id检索events

为了方便使用，首先需要创建的视图之一就是通过关联的venueId检索给定事件集合的视图。为此，需要编写一个key为venueId、值为document的视图（尽管jcouchdb的函数并没有严格的需要）。那么，该视图是什么样的呢？

1. function(doc) {
   
2.     if (doc.type == 'Event') {
   
3.         emit(doc.venueId, {doc});
   
4.     }
   
5. }

复制代码

jieforest

它和之前编写的那个简单视图非常相似，但是这次从应用程序中调用该视图进行查询时需要传递一个

1. CouchViewTest.java (testQueryByVenueId())
   
2.     @Test
   
3.     public void testQueryByVenueId() {
   
4.         String viewName = "event/allByVenueId";
   
5. 
   
6. 
   
7.         ViewAndDocumentsResult

复制代码

此处关于如何调用视图的关键区别之一就是使用queryViewAndDocumentsByKeys()方法传入了viewName、映射的Event类以及要查询的键（这种情况下只会查询出键值为指定venueId的事件）。

jieforest

通过日期查询事件

这两个视图都比较简单。而通过日期查询这种稍微复杂一点功能的如何实现呢？首先，我们需要定义视图。

1. function(doc) {
   
2.     if (doc.docType == 'Event') {
   
3.         var startDate = new Date(doc.startTime);
   
4.         var startYear = startDate.getFullYear();
   
5.         var startMonth = startDate.getMonth();
   
6.         var startDay = startDate.getDate();
   
7.         emit([
   
8.             startYear,
   
9.             startMonth,
   
10.             startDay
    
11.         ]);
    
12.     }
    
13. }

复制代码

现在，我们如何调用这个函数呢？

[todo: 在java中调用视图的代码示例]

jieforest

从事件中检索venue的动态查询

1. CouchViewTest.java (testQueryByDate())
   
2.     @Test
   
3.     public void testQueryByDate() {
   
4.         String viewName = "event/allByDate";
   
5.         Options opts = new Options();
   
6.         opts.startKey(Arrays.asList(2013, 7, 11));
   
7.         opts.endKey(Arrays.asList(2013, 7, 11));
   
8. 
   
9.         ViewAndDocumentsResult

复制代码

此处有一个名为Options的新对象，通过它可以指定想要传入视图的查询选项。在本例中，我们提供了一个startKey和一个endKey去检 索对象集合。需要注意的一件事情就是，你要返回或匹配的数据需与传入数据的类型保持一致。在本例中处理的是int类型，所以传入的键必须是int类型的 域。当然顺序也是键，我们依次传入了年、日、月从而匹配视图中的年、日、月。

那么，endKey是什么呢？实际上，endKey参数允许我们指定查询的范围。在本例中我们选择了相同的日期，但是可以很容易地选择不同的值从而返回更多或更少的文档。CouchDB会简单地依次比较每一个键，直到再没有匹配的数据时才会返回结果文档集合。

jieforest

从事件中检索venue的动态查询

除了通过Event id查询地址（place）之外，此处所要做的事情就是编写和之前queryByVenueId相同的逻辑。

1.     @JSONProperty(ignore = true)
   
2.     public Place getVenue() {
   
3.         String viewName = "place/allByEventId";
   
4. 
   
5.         ViewAndDocumentsResult

复制代码

你仅需要为place文档编写一个和allByVenueId相似的视图，仅此而已。

接下来去向何方？

视图（或map）只是CouchDB所提供的map/reduce功能的第一部分。那么什么是reduce（和re-reduce）功能，它能给我们带来什么呢？

Reduce允许我们从之前的map中获取结果集，同时能对其执行附加的操作将结果集分解成更加简洁的形式。

Reduce和re-reduce的功能需要你自己去探索，但是你可以通过它们做一些非常有趣的事情。探索并感受CouchDB带来的乐趣！

jieforest

over.