isearch/docs/Quickstart.md

为了省去配置机器环境的麻烦，建议通过docker来运行demo容器，在终端执行如下命令：  
```
// KEYWORD_CACHE_SIZE和HANPIN_CACHE_SIZE用于设置缓存的大小，单位为M，默认是100M
docker run --env KEYWORD_CACHE_SIZE=1024 --env HANPIN_CACHE_SIZE=1024 -d intelligentsearch/search_local:1.0
```
启动容器后，通过如下命令进入容器：  
```
docker exec -it 容器id /bin/bash

```
容器id替换为上一步启动的容器对应的id

### 1. 查看项目配置文件

isearch应用的字段配置文件名称为app_field_define.txt，通过以下指令查看配置文件内容：
```
cat /usr/local/intelligentsearch/index_write/conf/app_field_define.txt
```
可以看到，demo应用的appid为10001，对应的字段为doc_id、title、content、author、weight、telephone、longitude、latitude。

### 2. 上报索引数据

说明：由于接入层RESTFul API仍在开发中，目前仅能通过tcp请求的方式进行索引的导入和查询，后续会支持RESTFul格式的API进行索引的操作。

执行如下命令进行测试数据的导入。
```
cd /usr/local/intelligentsearch/tools
./client_test send.json 106 127.0.0.1 11017
```
若屏幕显示如下信息，则表示数据导入成功：
```
send count == 1
recv: 27 bytes
server message: {"code":0}
```
可以通过修改send.json中的数据来导入更多的测试数据。

### 3. 测试搜索

首先，我们分别以亚运会、金牌、公园进行搜索（修改search.json文件）：
```
{"key":"亚运会", "appid":10001, "fields":"title"}
{"key":"金牌", "appid":10001, "fields":"title"}
{"key":"公园", "appid":10001, "fields":"title"}
```
执行如下命令进行数据的查询：
```
cd /usr/local/intelligentsearch/tools
./client_test search.json 101 127.0.0.1 12003
```
以下为公园的搜索结果：
```
{
	"code": 0,
	"count": 1,
	"hlWord": ["公园"],
	"result": [{
		"doc_id": "12351",
		"score": 11.689424985915906,
		"title": "非洲特色动植物首次亮相北京市属公园 "
	}]
}
```
接下来测试复杂的字段以及布尔搜索：
```
// title包含公园的记录
{"key":"title:公园", "appid":10001, "fields":"title"}
// title包含公园或者author是张三的记录
{"key":"title:公园 author:张三", "appid":10001, "fields":"title"}
// content字段包含京东并且author是张三的记录
{"key_and":"content:京东 author:张三", "appid":10001, "fields":"title"}
// content字段包含京东并且author不是张三的记录
{"key":"content:京东", "key_invert":"author:张三", "appid":10001, "fields":"title"}
```
接下来测试模糊匹配的情形：
```
{"key":"author:zs", "appid":10001,"fields":"title"}
{"key":"author:张", "appid":10001,"fields":"title"}
```
接下来测试范围查的情形：
```
// weight字段在21到24之间的记录
{"key":"weight:[21,24]", "appid":10001, "fields":"title"}
// weight字段在21到24之间的记录，并且结果按照weight升序排列
{"key":"weight:[21,24]", "sort_type":"4", "sort_field":"weight", "appid":10001 ,"fields":"title"}
```
接下来测试地理位置查询的场景：
```
// 查询坐标点[116.50, 39.76]附近900米范围内的记录
{"key_and":"longitude:116.50 latitude:39.76 distance:0.9", "appid":10001, "fields":"title"}
```