ElasticSearch入门-结构定义之Mapping

相当于数据库的表结构的定义，elasticsearch的mapping 也很重要。直接关系到性能及搜索结果的准确性。elasticsearch的java api的例子太少，我在这儿就献丑了。

为了说明mapping的定义，我这里定义了一个简单的模型，就ID,type,和catIds 3个属性，重在说明如何使用java api来定义mapping,具体各field应该如何定义，这里不做讨论。

Java代码  

1. public class TestModel implements Serializable {  
2.     private static final long serialVersionUID = 3174577828007649745L;  
3.     //主ID  
4.     private long id;  
5.     //类型，为types之一  
6.     private String type;  
7.     /** 
8.      * 这里是一个列表 
9.      */  
10.     private List<Integer> catIds;  
11.       
12.       
13.     public long getId() {  
14.         return id;  
15.     }  
16.     public void setId(long id) {  
17.         this.id = id;  
18.     }  
19.     public String getType() {  
20.         return type;  
21.     }  
22.     public void setType(String type) {  
23.         this.type = type;  
24.     }  
25.     public List<Integer> getCatIds() {  
26.         return catIds;  
27.     }  
28.     public void setCatIds(List<Integer> catIds) {  
29.         this.catIds = catIds;  
30.     }  
31. }  

 我们假设id就存储为long类型，type存储为字符串类型，catIds为一个列表，其实际类型为integer类型。定义的mapping如下：

Java代码  

1. /** 
2.      * mapping 一旦定义，之后就不能修改。 
3.      * @return 
4.      * @throws Exception 
5.      */  
6.     private static XContentBuilder getMapping() throws Exception{  
7.         XContentBuilder mapping = jsonBuilder()    
8.                    .startObject()    
9.                      .startObject("test")    
10.                      .startObject("properties")           
11.                        .startObject("id")  
12.                             .field("type", "long")  
13.                             .field("store", "yes")  
14.                         .endObject()      
15.                           
16.                        .startObject("type")  
17.                             .field("type", "string")  
18.                             .field("index", "not_analyzed")  
19.                         .endObject()    
20.                           
21.                        .startObject("catIds")  
22.                             .field("type", "integer")  
23.                        .endObject()    
24.                      .endObject()    
25.                     .endObject()    
26.                   .endObject();    
27.         return mapping;  
28.     }  

 注意：elasticsearch的field一旦定义后就无法修改，你想增加一个store属性，都不行。

 

下面就是调用JAVA API了，注意，在定义mapping之前，还需要先创建一个index库。这里，我index库和mapping 写到一个方法里面了。

Java代码  

1. Client client = ESUtils.getClient();  
2.         //首先创建索引库  
3.         CreateIndexResponse  indexresponse = client.admin().indices()  
4.         //这个索引库的名称还必须不包含大写字母  
5.         .prepareCreate("testindex").execute().actionGet();  
6.         System.out.println(indexresponse.acknowledged());;  
7.         //如果是在两台机器上，下面直接putMapping可能会报异常  
8.         PutMappingRequestBuilder builder = client.admin().indices().preparePutMapping("testindex");  
9.         //testType就像当于数据的table  
10.         builder.setType("testType");  
11.         XContentBuilder mapping = getMapping();  
12.         builder.setSource(mapping);  
13.         PutMappingResponse  response = builder.execute().actionGet();  
14.         System.out.println(response.isAcknowledged());  

 其中，这个代码在我本机出现一点问题，当我创建完index后，直接创建mapping 的时候，报index missing。我把两个es Node停掉一个就没有问题了。可见，ES将create index和putMapping放到了两个不同的es Node下面，导致了上面那个异常。

 

好了，有时为了测试，可能需要删除某个索引，代码如下：

Java代码  

1. Client client = ESUtils.getClient();  
2.         client.admin().indices()  
3.         //这个索引库的名称还必须不包含大写字母  
4.         .prepareDelete("testindex").execute().actionGet();