为什么要使用CouchDB

jieforest

图4. Iris CouchFuton页面

jieforest

另一个选择是在本地机器（或主机）上安装CouchDB。我们并不会带你在你的操作系统上安装它，但是在CouchDB的wiki上有一些非常好的说明。

在账号创建完成之后（或者在设置并启动CouchDB之后），将需要创建一个的数据库。在我们的应用程序中选择了couchspring作为数据库名。你可以随意取名，但是当我们开始配置设置时需要将其修改为对应的名字。

在CloudAnt中，可以在数据库截图（图1）中创建数据库，而对于Iris Couch来说可以直接在Futon页面（管理CouchDB实例的用户界面）中创建。关于管理页面的更多信息可以在CouchDB wiki中找到。本文并不会过多的使用管理页面，但是这是一个非常好的操作视图的工具。

图5.在管理页面中创建数据库的步骤1

jieforest

图6.在Futon页面中创建数据库的步骤2

jieforest

配置jcouchdb、Spring和POJOS

在新数据库设置完成之后，我们需要：

1. 创建基础POJO对象

2. 提供一个json配置映射，它能够将CouchDB使用的Java对象和JSON对象自动地进行转换

3. Spring 配置

首先，让我们创建一些对象！

jieforest

带有自定义注解的POJOs

我们将要为事件系统创建的基础对象是哪些？

1. Event——存储来自于外部源（如Eventful.com）或Web界面的事件

2. Place——存储事件的发生位置。

同时，还会结合使用一些其他的对象（从外部源中抽取数据时做一些额外的数据处理）：

1. AppDocument ——由json映射实用程序所使用的用来定义文档类型识别域的基础对象

2. Description——用于格式化并过滤事件的描述

3. Location——用于记录给定位置/地点的经纬度

jieforest

首先，需要创建基础类AppDocument

AppDocument.java

1. package com.clearboxmedia.couchspring.domain;
   
2. 
   
3. import org.jcouchdb.document.BaseDocument;
   
4. import org.svenson.JSONProperty;
   
5. 
   
6. public class AppDocument extends BaseDocument {
   
7.     /**
   
8.      * Returns the simple name of the class as doc type.
   
9.      *
   
10.      * The annotation makes it a read-only property and also
    
11.      * shortens the JSON name a little.
    
12.      *
    
13.      * @return document type name
    
14.      */
    
15.     @JSONProperty(value = "docType", readOnly = true)
    
16.     public String getDocumentType()
    
17.     {
    
18.         return this.getClass().getSimpleName();
    
19.     }
    
20. 
    
21. }

复制代码

jieforest

该对象继承了jcouchdb自身的BaseDocument对象，同时它还提供了一种区分不同的文档类型的方法。CouchDB并没有提供处理这 些内容的默认方式，而是将其留给了开发者，让他们去实现各自的处理方式。我们选择使用类名作为识别符，例如：Event对象的docType会输出 Event，而Place对象会输出Place。
接下来需要创建Event类。

Event.java（为简单起见，我们省略了一些域和方法）

1. package com.clearboxmedia.couchspring.domain;
   
2. 
   
3. import java.util.ArrayList;
   
4. import java.util.Arrays;
   
5. import java.util.Iterator;
   
6. import java.util.LinkedHashMap;
   
7. import java.util.List;
   
8. import java.util.Map;
   
9. 
   
10. import javax.xml.bind.annotation.XmlRootElement;
    
11. import javax.xml.bind.annotation.XmlElement;
    
12. 
    
13. import org.svenson.JSONProperty;
    
14. 
    
15. public class Event extends AppDocument {
    
16.     private String id;
    
17.     private String title;
    
18.     private String description;
    
19.     private String startTime;
    
20.     private String stopTime;
    
21.     private String venueId;
    
22.     private Map

复制代码

jieforest

这里有几件有趣的事。首先就是我们将会在对象中存储的是venueId而非venue，为什么要这样做呢？

因为CouchDB并不是关系型数据库，它没有一种直接的方式去定义两个不同文档之间的关系，因此我们在Event对象中存储venue的id。我 们可以在event对象中存储venue对象，但是将这些对象分开存储更清晰，尤其对于一个给定的地点可能会有多个事件。因此，我们将会提供一个动态的获 取器，仅在我们需要的时候才会检索venue对象，而不是存储关系。我们将会在查询文档部分介绍这如何实现。[todo: 动态查询]

现在，我们来定义Place类。

Place.java

1. package com.clearboxmedia.couchspring.domain;
   
2. import java.util.LinkedHashMap;
   
3. import java.util.List;
   
4. 
   
5. public class Place extends AppDocument {
   
6.     private String id;
   
7.     private String name;
   
8.     private String address1;
   
9.     private String address2;
   
10.     private String city;
    
11.     private String state;
    
12.     private String postalCode;
    
13.     private String lastUpdated;
    
14.     private Boolean active;
    
15.     private Location location;
    
16.     private String venueType;
    
17.     private List<String> tags;
    
18. 
    
19.     public Place() {
    
20.     }
    
21. 
    
22.     public String getId() {
    
23.         return this.id;
    
24.     }
    
25. 
    
26.     public void setId(final String id) {
    
27.         this.id = id;
    
28.     }
    
29. 
    
30.     public String getName() {
    
31.         return this.name;
    
32.     }
    
33. 
    
34.     public void setName(final String name) {
    
35.         this.name = name;
    
36.     }
    
37. 
    
38.     public String getAddress1() {
    
39.         return this.address1;
    
40.     }
    
41. 
    
42.     public void setAddress1(final String address1) {
    
43.         this.address1 = address1;
    
44.     }
    
45. 
    
46.     public String getAddress2() {
    
47.         return this.address2;
    
48.     }
    
49. 
    
50.     public void setAddress2(final String address2) {
    
51.         this.address2 = address2;
    
52.     }
    
53. 
    
54.     public String getCity() {
    
55.         return this.city;
    
56.     }
    
57. 
    
58.     public void setCity(final String city) {
    
59.         this.city = city;
    
60.     }
    
61. 
    
62.     public String getState() {
    
63.         return this.state;
    
64.     }
    
65. 
    
66.     public void setState(final String state) {
    
67.         this.state = state;
    
68.     }
    
69. 
    
70.     public Location getLocation() {
    
71.         return this.location;
    
72.     }
    
73. 
    
74.     public void setLocation(final Location location) {
    
75.         this.location = location;
    
76.     }
    
77. 
    
78.     public String getVenueType() {
    
79.         return this.venueType;
    
80.     }
    
81. 
    
82.     public void setVenueType(final String venueType) {
    
83.         this.venueType = venueType;
    
84.     }
    
85. 
    
86.     public String getPostalCode() {
    
87.         return this.postalCode;
    
88.     }
    
89. 
    
90.     public void setPostalCode(final String postalCode) {
    
91.         this.postalCode = postalCode;
    
92.     }
    
93. 
    
94.     public String getLastUpdated() {
    
95.         return this.lastUpdated;
    
96.     }
    
97. 
    
98.     public void setLastUpdated(final String lastUpdated) {
    
99.         this.lastUpdated = lastUpdated;
    
100.     }
     
101. 
     
102.     public Boolean getActive() {
     
103.         return this.active;
     
104.     }
     
105. 
     
106.     public void setActive(final Boolean active) {
     
107.         this.active = active;
     
108.     }
     
109. 
     
110.     public List<String> getTags() {
     
111.         return this.tags;
     
112.     }
     
113. 
     
114.     public void setTags(final List<String> tags) {
     
115.         this.tags = tags;
     
116.     }
     
117. }

复制代码

jieforest

我们不再详细介绍其他的辅助对象Description 或者 Location，因为它们实在是太简单了。如果你对它们感兴趣，可以从GitHub仓库中检出它们。

配置jcouchdb和JsonConfigFactory

在配置之前，需要创建一些即将使用的类。JsonConfigFactory用于json数据（CouchDB）和Java类之间的映射，CouchDbServerFactory为将要连接的服务器创建新的实例。

1. JsonConfigFactory.java public class JsonConfigFactory {
   
2.     /**
   
3.      * Factory method for creating a {@link JSONConfig}
   
4.      *
   
5.      * @return {@link JSONConfig} to create
   
6.      */
   
7.     JSONConfig createJsonConfig() {
   
8.         final DateConverter dateConverter = new DateConverter();
   
9. 
   
10.         final DefaultTypeConverterRepository typeConverterRepository =
    
11.                                                 new DefaultTypeConverterRepository();
    
12.         typeConverterRepository.addTypeConverter(dateConverter);
    
13.         // typeConverterRepository.addTypeConverter(new LatLongConverter());
    
14. 
    
15.         // we use the new sub type matcher  
    
16.         final ClassNameBasedTypeMapper typeMapper = new ClassNameBasedTypeMapper();
    
17.         typeMapper.setBasePackage(AppDocument.class.getPackage().getName());
    
18.         // we only want to have AppDocument instances
    
19.         typeMapper.setEnforcedBaseType(AppDocument.class);
    
20.         // we use the docType property of the AppDocument
    
21.         typeMapper.setDiscriminatorField("docType");        
    
22.         // we only want to do the expensive look ahead if we're being told to
    
23.         // deliver AppDocument instances.        
    
24.         typeMapper.setPathMatcher(new SubtypeMatcher(AppDocument.class));
    
25. 
    
26.         final JSON generator = new JSON();
    
27.         generator.setIgnoredProperties(Arrays.asList("metaClass"));
    
28.         generator.setTypeConverterRepository(typeConverterRepository);
    
29.         generator.registerTypeConversion(java.util.Date.class, dateConverter);
    
30.         generator.registerTypeConversion(java.sql.Date.class, dateConverter);
    
31.         generator.registerTypeConversion(java.sql.Timestamp.class, dateConverter);
    
32. 
    
33.         final JSONParser parser = new JSONParser();
    
34.         parser.setTypeMapper(typeMapper);
    
35.         parser.setTypeConverterRepository(typeConverterRepository);
    
36.         parser.registerTypeConversion(java.util.Date.class, dateConverter);
    
37.         parser.registerTypeConversion(java.sql.Date.class, dateConverter);
    
38.         parser.registerTypeConversion(java.sql.Timestamp.class, dateConverter);
    
39. 
    
40.         return new JSONConfig(generator, parser);
    
41.     }
    
42. }

复制代码

jieforest

该类会创建一个生成器，它将Java类（Event或Place）转换成对应的json，而解析器执行相反的过程。在typeMapper（生成器和解析器都会用到它）中有几个关键点需要注意，特别是基础类型和鉴别器域。
typeMapper.setEnforcedBaseType(AppDocument.class)仅会转换继承自AppDocument类的文档。

typeMapper.setDiscriminatorField("docType")将使用docType域和值来鉴别不同的文档类型。可以 自由地将该域修改为其他的名字，但是这需要在AppDocument类中改变方法和json映射。为了刷新内存，可以参考下面的方法：

1. @JSONProperty(value = "docType", readOnly = true)
   
2. public String getDocumentType()
   
3. {
   
4.     return this.getClass().getSimpleName();
   
5. }

复制代码