Elasticsearch 入門教程

1.下載

2.安裝

3.Spring整合Elasticsearch

4.ES註解

5.接口測試

---

1.下載

Elasticsearch：https://www.elastic.co/cn/downloads/past-releases/elasticsearch-6-6-2

Kibana（Elasticsearch的客戶端）：https://www.elastic.co/cn/downloads/past-releases/kibana-6-6-2

 

下載好的包

2.安裝

全部解壓：

安裝 ik 中文分詞插件：

在elasticsearch-6.6.2\bin目錄下執行以下命令：elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v6.6.2/elasticsearch-analysis-ik-6.6.2.zip

啓動Elasticsearch：

運行bin目錄下的elasticsearch.bat啓動

執行命令 curl localhost:9200，會得到以下說明信息即成功

啓動 Kibana：

運行bin目錄下的 kibana.bat，啓動 Kibana 的用戶界面

訪問http://localhost:5601 即可打開Kibana的用戶界面

啓動 Kibana 不成功：

則要修改 Elasticsearch 安裝目錄的config/elasticsearch.yml文件，去掉network.host的註釋，將它的值改成0.0.0.0，然後重新啓動 Elasticsearch。

3.Spring整合Elasticsearch

添加依賴

<!--Elasticsearch相關依賴-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
        </dependency>

修改spring配置

  data:
    elasticsearch:
      repositories:
        enabled: true
      cluster-nodes: 127.0.0.1:9300 #es連接地址及端口
      cluster-name: elasticsearch #es集羣的名稱

添加文檔對象EsProduct

不需要中文分詞的字段設置成@Field(type = FieldType.Keyword)類型，需要中文分詞的設置成@Field(analyzer = "ik_max_word",type = FieldType.Text)類型。

@Data
@Document(indexName = "mall",type = "product",shards = 1,replicas = 0)
public class EsProduct implements Serializable {

    private static final long serialVersionUID = -4143445098613480553L;

    @Id
    private Long id;
    @Field(type = FieldType.Keyword)
    private String productSn;
    @Field(type = FieldType.Keyword)
    private String brandName;
    @Field(analyzer = "ik_max_word",type = FieldType.Text)
    private String name;
    @Field(analyzer = "ik_max_word",type = FieldType.Text)
    private String subTitle;
    @Field(analyzer = "ik_max_word",type = FieldType.Text)
    private String keywords;

}

添加EsProductRepository接口用於操作Elasticsearch

/**
 * 繼承ElasticsearchRepository接口，這樣就擁有了一些基本的Elasticsearch數據操作方法，同時定義了一個衍生查詢方法
 */
public interface EsProductRepository extends ElasticsearchRepository<EsProduct,Long> {

    Page<EsProduct> findByNameOrSubTitleOrKeywords(String name, String subTitle, String keywords, Pageable page);

}

添加EsProductService接口和EsProductServiceImpl實現類

public interface EsProductService {

    /**
     * 從數據庫中導入所有產品到ES
     */
    int importAll();

    /**
     * 根據關鍵字搜索名稱或者副標題
     */
    Page<EsProduct> search(String keyword, Integer pageNum, Integer pageSize);
}

@Service
public class EsProductServiceImpl implements EsProductService {

    @Autowired
    private EsProductRepository productRepository;
    @Autowired
    private EsProductDao productDao;

    @Override
    public int importAll() {
        List<EsProduct> esProductList = productDao.getAllEsProductList();
        Iterable<EsProduct> esProductIterable = productRepository.saveAll(esProductList);
        Iterator<EsProduct> iterator = esProductIterable.iterator();
        int result = 0;
        while (iterator.hasNext()) {
            result++;
            iterator.next();
        }
        return result;
    }

    @Override
    public Page<EsProduct> search(String keyword, Integer pageNum, Integer pageSize) {
        Pageable pageable = PageRequest.of(pageNum, pageSize);
        return productRepository.findByNameOrSubTitleOrKeywords(keyword, keyword, keyword, pageable);

    }

}

添加EsProductController控制器

@Api(tags = "EsProductController", description = "搜索產品控制器")
@RestController
@RequestMapping("/es/product")
public class EsProductController {
    @Autowired
    private EsProductService esProductService;

    @ApiOperation(value = "將數據庫中的產品數據寫入到ES")
    @RequestMapping(value = "/importAll", method = RequestMethod.GET)
    public CommonResult<Integer> importAllList() {
        int count = esProductService.importAll();
        return CommonResult.success(count);
    }

    @ApiOperation(value = "全文檢索產品")
    @RequestMapping(value = "/search", method = RequestMethod.GET)
    public CommonResult<CommonPage<EsProduct>> search(@RequestParam(required = false) String keyword,
                                                      @RequestParam(required = false, defaultValue = "0") Integer pageNum,
                                                      @RequestParam(required = false, defaultValue = "5") Integer pageSize) {
        Page<EsProduct> esProductPage = esProductService.search(keyword, pageNum, pageSize);
        return CommonResult.success(CommonPage.restPage(esProductPage));
    }
}

4.ES註解

@Document

//標示映射到Elasticsearch文檔上的領域對象
//Index 裏面單條的記錄稱爲 Document（文檔）。許多條 Document 構成了一個 Index。
public @interface Document {
  //索引庫名次，mysql中數據庫的概念
    String indexName();
  //文檔類型，mysql中表的概念
    String type() default "";
  //默認分片數
    short shards() default 5;
  //默認副本數量
    short replicas() default 1;

}

@Id

//表示是文檔的id，文檔可以認爲是mysql中表行的概念

@Field

public @interface Field {
  //文檔中字段的類型
    FieldType type() default FieldType.Auto;
  //是否建立倒排索引
    boolean index() default true;
  //是否進行存儲
    boolean store() default false;
  //分詞器名次
    String analyzer() default "";
}

//爲文檔自動指定元數據類型
public enum FieldType {
    Text,//會進行分詞並建了索引的字符類型
    Integer,
    Long,
    Date,
    Float,
    Double,
    Boolean,
    Object,
    Auto,//自動判斷字段類型
    Nested,//嵌套對象類型
    Ip,
    Attachment,
    Keyword//不會進行分詞建立索引的類型
}

5.接口測試

將數據庫中數據導入到Elasticsearch

• 數據庫：

• 測試結果

• kibana查看寫入數據

• kibana檢索數據

查詢ES中的產品信息