# 目录

  * [二、索引里面究竟存些什么](#二、索引里面究竟存些什么)
  * [三、如何创建索引](#三、如何创建索引)
    * [第一步：一些要索引的原文档(Document)。](#第一步：一些要索引的原文档document。)
    * [第二步：将原文档传给分次组件(Tokenizer)。](#第二步：将原文档传给分次组件tokenizer。)
    * [第三步：将得到的词元(Token)传给语言处理组件(Linguistic Processor)。](#第三步：将得到的词元token传给语言处理组件linguistic-processor。)
    * [第四步：将得到的词(Term)传给索引组件(Indexer)。](#第四步：将得到的词term传给索引组件indexer。)
  * [三、如何对索引进行搜索？](#三、如何对索引进行搜索？)
    * [第一步：用户输入查询语句。](#第一步：用户输入查询语句。)
    * [第二步：对查询语句进行词法分析，语法分析，及语言处理。](#第二步：对查询语句进行词法分析，语法分析，及语言处理。)
    * [第三步：搜索索引，得到符合语法树的文档。](#第三步：搜索索引，得到符合语法树的文档。)
    * [第四步：根据得到的文档和查询语句的相关性，对结果进行排序。](#第四步：根据得到的文档和查询语句的相关性，对结果进行排序。)
    * [1. 计算权重(Term weight)的过程。](#1-计算权重term-weight的过程。)
    * [2\. 判断Term之间的关系从而得到文档相关性的过程，也即向量空间模型的算法(VSM)。](#2-判断term之间的关系从而得到文档相关性的过程，也即向量空间模型的算法vsm。)
  * [Spring Boot 中使用 Java API 调用 lucene](#spring-boot-中使用-java-api-调用-lucene)
  * [Github 代码](#github-代码)
  * [添加依赖](#添加依赖)
  * [配置 lucene](#配置-lucene)
  * [创建索引](#创建索引)
  * [删除文档](#删除文档)
  * [更新文档](#更新文档)
  * [按词条搜索](#按词条搜索)
  * [多条件查询](#多条件查询)
  * [匹配前缀](#匹配前缀)
  * [短语搜索](#短语搜索)
  * [相近词语搜索](#相近词语搜索)
  * [通配符搜索](#通配符搜索)
  * [分词查询](#分词查询)
  * [多个 Field 分词查询](#多个-field-分词查询)
  * [中文分词器](#中文分词器)
  * [高亮处理](#高亮处理)


[toc]
Lucene是一个高效的，基于Java的全文检索库。

所以在了解Lucene之前要费一番工夫了解一下全文检索。

那么什么叫做全文检索呢？这要从我们生活中的数据说起。

我们生活中的数据总体分为两种：结构化数据和非结构化数据。

*   结构化数据：指具有固定格式或有限长度的数据，如数据库，元数据等。
*   非结构化数据：指不定长或无固定格式的数据，如邮件，word文档等。

当然有的地方还会提到第三种，半结构化数据，如XML，HTML等，当根据需要可按结构化数据来处理，也可抽取出纯文本按非结构化数据来处理。

非结构化数据又一种叫法叫全文数据。

按照数据的分类，搜索也分为两种：

*   对结构化数据的搜索：如对数据库的搜索，用SQL语句。再如对元数据的搜索，如利用windows搜索对文件名，类型，修改时间进行搜索等。
*   对非结构化数据的搜索：如利用windows的搜索也可以搜索文件内容，Linux下的grep命令，再如用Google和百度可以搜索大量内容数据。

对非结构化数据也即对全文数据的搜索主要有两种方法：

一种是顺序扫描法(Serial Scanning)：所谓顺序扫描，比如要找内容包含某一个字符串的文件，就是一个文档一个文档的看，对于每一个文档，从头看到尾，如果此文档包含此字符串，则此文档为我们要找的文件，接着看下一个文件，直到扫描完所有的文件。如利用windows的搜索也可以搜索文件内容，只是相当的慢。如果你有一个80G硬盘，如果想在上面找到一个内容包含某字符串的文件，不花他几个小时，怕是做不到。Linux下的grep命令也是这一种方式。大家可能觉得这种方法比较原始，但对于小数据量的文件，这种方法还是最直接，最方便的。但是对于大量的文件，这种方法就很慢了。

有人可能会说，对非结构化数据顺序扫描很慢，对结构化数据的搜索却相对较快（由于结构化数据有一定的结构可以采取一定的搜索算法加快速度），那么把我们的非结构化数据想办法弄得有一定结构不就行了吗？

这种想法很天然，却构成了全文检索的基本思路，也即将非结构化数据中的一部分信息提取出来，重新组织，使其变得有一定结构，然后对此有一定结构的数据进行搜索，从而达到搜索相对较快的目的。

这部分从非结构化数据中提取出的然后重新组织的信息，我们称之索引。

这种说法比较抽象，举几个例子就很容易明白，比如字典，字典的拼音表和部首检字表就相当于字典的索引，对每一个字的解释是非结构化的，如果字典没有音节表和部首检字表，在茫茫辞海中找一个字只能顺序扫描。然而字的某些信息可以提取出来进行结构化处理，比如读音，就比较结构化，分声母和韵母，分别只有几种可以一一列举，于是将读音拿出来按一定的顺序排列，每一项读音都指向此字的详细解释的页数。我们搜索时按结构化的拼音搜到读音，然后按其指向的页数，便可找到我们的非结构化数据——也即对字的解释。

这种先建立索引，再对索引进行搜索的过程就叫全文检索(Full-text Search)。

下面这幅图来自《Lucene in action》，但却不仅仅描述了Lucene的检索过程，而是描述了全文检索的一般过程。

全文检索大体分两个过程，索引创建(Indexing)和搜索索引(Search)。

*   索引创建：将现实世界中所有的结构化和非结构化数据提取信息，创建索引的过程。
*   搜索索引：就是得到用户的查询请求，搜索创建的索引，然后返回结果的过程。

于是全文检索就存在三个重要问题：

1\. 索引里面究竟存些什么？(Index)

2\. 如何创建索引？(Indexing)

3\. 如何对索引进行搜索？(Search)

下面我们顺序对每个个问题进行研究。

## 二、索引里面究竟存些什么

索引里面究竟需要存些什么呢？

首先我们来看为什么顺序扫描的速度慢：

其实是由于我们想要搜索的信息和非结构化数据中所存储的信息不一致造成的。

非结构化数据中所存储的信息是每个文件包含哪些字符串，也即已知文件，欲求字符串相对容易，也即是从文件到字符串的映射。而我们想搜索的信息是哪些文件包含此字符串，也即已知字符串，欲求文件，也即从字符串到文件的映射。两者恰恰相反。于是如果索引总能够保存从字符串到文件的映射，则会大大提高搜索速度。

由于从字符串到文件的映射是文件到字符串映射的反向过程，于是保存这种信息的索引称为反向索引。

反向索引的所保存的信息一般如下：

假设我的文档集合里面有100篇文档，为了方便表示，我们为文档编号从1到100，得到下面的结构

左边保存的是一系列字符串，称为词典。

每个字符串都指向包含此字符串的文档(Document)链表，此文档链表称为倒排表(Posting List)。

有了索引，便使保存的信息和要搜索的信息一致，可以大大加快搜索的速度。

比如说，我们要寻找既包含字符串“lucene”又包含字符串“solr”的文档，我们只需要以下几步：

1\. 取出包含字符串“lucene”的文档链表。

2\. 取出包含字符串“solr”的文档链表。

3\. 通过合并链表，找出既包含“lucene”又包含“solr”的文件。

<figure data-size="normal">


![](https://java-tutorial.oss-cn-shanghai.aliyuncs.com/v2-c1064a6ada64169f76ec63e44e82f0f5_720w.webp)

</figure>

看到这个地方，有人可能会说，全文检索的确加快了搜索的速度，但是多了索引的过程，两者加起来不一定比顺序扫描快多少。的确，加上索引的过程，全文检索不一定比顺序扫描快，尤其是在数据量小的时候更是如此。而对一个很大量的数据创建索引也是一个很慢的过程。

然而两者还是有区别的，顺序扫描是每次都要扫描，而创建索引的过程仅仅需要一次，以后便是一劳永逸的了，每次搜索，创建索引的过程不必经过，仅仅搜索创建好的索引就可以了。

这也是全文搜索相对于顺序扫描的优势之一：一次索引，多次使用。

## 三、如何创建索引

全文检索的索引创建过程一般有以下几步：

### 第一步：一些要索引的原文档(Document)。

为了方便说明索引创建过程，这里特意用两个文件为例：

文件一：Students should be allowed to go out with their friends, but not allowed to drink beer.

文件二：My friend Jerry went to school to see his students but found them drunk which is not allowed.

### 第二步：将原文档传给分次组件(Tokenizer)。

分词组件(Tokenizer)会做以下几件事情(此过程称为Tokenize)：

1\. 将文档分成一个一个单独的单词。

2\. 去除标点符号。

3\. 去除停词(Stop word)。

所谓停词(Stop word)就是一种语言中最普通的一些单词，由于没有特别的意义，因而大多数情况下不能成为搜索的关键词，因而创建索引时，这种词会被去掉而减少索引的大小。

英语中挺词(Stop word)如：“the”,“a”，“this”等。

对于每一种语言的分词组件(Tokenizer)，都有一个停词(stop word)集合。

经过分词(Tokenizer)后得到的结果称为词元(Token)。

在我们的例子中，便得到以下词元(Token)：



```
“Students”，“allowed”，“go”，“their”，“friends”，“allowed”，“drink”，“beer”，“My”，“friend”，“Jerry”，“went”，“school”，“see”，“his”，“students”，“found”，“them”，“drunk”，“allowed”。
```



### 第三步：将得到的词元(Token)传给语言处理组件(Linguistic Processor)。

语言处理组件(linguistic processor)主要是对得到的词元(Token)做一些同语言相关的处理。

对于英语，语言处理组件(Linguistic Processor)一般做以下几点：

1\. 变为小写(Lowercase)。

2\. 将单词缩减为词根形式，如“cars”到“car”等。这种操作称为：stemming。

3\. 将单词转变为词根形式，如“drove”到“drive”等。这种操作称为：lemmatization。

Stemming 和 lemmatization的异同：

*   相同之处：Stemming和lemmatization都要使词汇成为词根形式。
*   两者的方式不同：

*   Stemming采用的是“缩减”的方式：“cars”到“car”，“driving”到“drive”。
*   Lemmatization采用的是“转变”的方式：“drove”到“drove”，“driving”到“drive”。

*   两者的算法不同：

*   Stemming主要是采取某种固定的算法来做这种缩减，如去除“s”，去除“ing”加“e”，将“ational”变为“ate”，将“tional”变为“tion”。
*   Lemmatization主要是采用保存某种字典的方式做这种转变。比如字典中有“driving”到“drive”，“drove”到“drive”，“am, is, are”到“be”的映射，做转变时，只要查字典就可以了。

*   Stemming和lemmatization不是互斥关系，是有交集的，有的词利用这两种方式都能达到相同的转换。

语言处理组件(linguistic processor)的结果称为词(Term)。

在我们的例子中，经过语言处理，得到的词(Term)如下：



```
“student”，“allow”，“go”，“their”，“friend”，“allow”，“drink”，“beer”，“my”，“friend”，“jerry”，“go”，“school”，“see”，“his”，“student”，“find”，“them”，“drink”，“allow”。
```



也正是因为有语言处理的步骤，才能使搜索drove，而drive也能被搜索出来。

### 第四步：将得到的词(Term)传给索引组件(Indexer)。

索引组件(Indexer)主要做以下几件事情：

1\. 利用得到的词(Term)创建一个字典。

在我们的例子中字典如下：

<figure data-size="normal">


![](https://java-tutorial.oss-cn-shanghai.aliyuncs.com/v2-b8477ac42cb442585aa090f33c0b34a6_720w.webp)

</figure>

2\. 对字典按字母顺序进行排序。

<figure data-size="normal">


![](https://java-tutorial.oss-cn-shanghai.aliyuncs.com/20230408113241.png)

</figure>

3\. 合并相同的词(Term)成为文档倒排(Posting List)链表。

在此表中，有几个定义：

*   Document Frequency 即文档频次，表示总共有多少文件包含此词(Term)。
*   Frequency 即词频率，表示此文件中包含了几个此词(Term)。

所以对词(Term) “allow”来讲，总共有两篇文档包含此词(Term)，从而词(Term)后面的文档链表总共有两项，第一项表示包含“allow”的第一篇文档，即1号文档，此文档中，“allow”出现了2次，第二项表示包含“allow”的第二个文档，是2号文档，此文档中，“allow”出现了1次。

到此为止，索引已经创建好了，我们可以通过它很快的找到我们想要的文档。

而且在此过程中，我们惊喜地发现，搜索“drive”，“driving”，“drove”，“driven”也能够被搜到。因为在我们的索引中，“driving”，“drove”，“driven”都会经过语言处理而变成“drive”，在搜索时，如果您输入“driving”，输入的查询语句同样经过我们这里的一到三步，从而变为查询“drive”，从而可以搜索到想要的文档。

## 三、如何对索引进行搜索？

到这里似乎我们可以宣布“我们找到想要的文档了”。

然而事情并没有结束，找到了仅仅是全文检索的一个方面。不是吗？如果仅仅只有一个或十个文档包含我们查询的字符串，我们的确找到了。然而如果结果有一千个，甚至成千上万个呢？那个又是您最想要的文件呢？

打开Google吧，比如说您想在微软找份工作，于是您输入“Microsoft job”，您却发现总共有22600000个结果返回。好大的数字呀，突然发现找不到是一个问题，找到的太多也是一个问题。在如此多的结果中，如何将最相关的放在最前面呢？

当然Google做的很不错，您一下就找到了jobs at Microsoft。想象一下，如果前几个全部是“Microsoft does a good job at software industry…”将是多么可怕的事情呀。

如何像Google一样，在成千上万的搜索结果中，找到和查询语句最相关的呢？

如何判断搜索出的文档和查询语句的相关性呢？

这要回到我们第三个问题：如何对索引进行搜索？

搜索主要分为以下几步：

### 第一步：用户输入查询语句。

查询语句同我们普通的语言一样，也是有一定语法的。

不同的查询语句有不同的语法，如SQL语句就有一定的语法。

查询语句的语法根据全文检索系统的实现而不同。最基本的有比如：AND, OR, NOT等。

举个例子，用户输入语句：lucene AND learned NOT hadoop。

说明用户想找一个包含lucene和learned然而不包括hadoop的文档。

### 第二步：对查询语句进行词法分析，语法分析，及语言处理。

由于查询语句有语法，因而也要进行语法分析，语法分析及语言处理。

1\. 词法分析主要用来识别单词和关键字。

如上述例子中，经过词法分析，得到单词有lucene，learned，hadoop, 关键字有AND, NOT。

如果在词法分析中发现不合法的关键字，则会出现错误。如lucene AMD learned，其中由于AND拼错，导致AMD作为一个普通的单词参与查询。

2\. 语法分析主要是根据查询语句的语法规则来形成一棵语法树。

如果发现查询语句不满足语法规则，则会报错。如lucene NOT AND learned，则会出错。

如上述例子，lucene AND learned NOT hadoop形成的语法树如下：

<figure data-size="normal">


![](https://java-tutorial.oss-cn-shanghai.aliyuncs.com/v2-5acb4fdbd41e04fe83396ea82679bee9_720w.webp)

</figure>

3\. 语言处理同索引过程中的语言处理几乎相同。

如learned变成learn等。

经过第二步，我们得到一棵经过语言处理的语法树。

<figure data-size="normal">


![](https://java-tutorial.oss-cn-shanghai.aliyuncs.com/20230408113252.png)

</figure>

### 第三步：搜索索引，得到符合语法树的文档。

此步骤有分几小步：

1.  首先，在反向索引表中，分别找出包含lucene，learn，hadoop的文档链表。
2.  其次，对包含lucene，learn的链表进行合并操作，得到既包含lucene又包含learn的文档链表。
3.  然后，将此链表与hadoop的文档链表进行差操作，去除包含hadoop的文档，从而得到既包含lucene又包含learn而且不包含hadoop的文档链表。
4.  此文档链表就是我们要找的文档。

### 第四步：根据得到的文档和查询语句的相关性，对结果进行排序。

虽然在上一步，我们得到了想要的文档，然而对于查询结果应该按照与查询语句的相关性进行排序，越相关者越靠前。

如何计算文档和查询语句的相关性呢？

不如我们把查询语句看作一片短小的文档，对文档与文档之间的相关性(relevance)进行打分(scoring)，分数高的相关性好，就应该排在前面。

那么又怎么对文档之间的关系进行打分呢？

这可不是一件容易的事情，首先我们看一看判断人之间的关系吧。

首先看一个人，往往有很多要素，如性格，信仰，爱好，衣着，高矮，胖瘦等等。

其次对于人与人之间的关系，不同的要素重要性不同，性格，信仰，爱好可能重要些，衣着，高矮，胖瘦可能就不那么重要了，所以具有相同或相似性格，信仰，爱好的人比较容易成为好的朋友，然而衣着，高矮，胖瘦不同的人，也可以成为好的朋友。

因而判断人与人之间的关系，首先要找出哪些要素对人与人之间的关系最重要，比如性格，信仰，爱好。其次要判断两个人的这些要素之间的关系，比如一个人性格开朗，另一个人性格外向，一个人信仰佛教，另一个信仰上帝，一个人爱好打篮球，另一个爱好踢足球。我们发现，两个人在性格方面都很积极，信仰方面都很善良，爱好方面都爱运动，因而两个人关系应该会很好。

我们再来看看公司之间的关系吧。

首先看一个公司，有很多人组成，如总经理，经理，首席技术官，普通员工，保安，门卫等。

其次对于公司与公司之间的关系，不同的人重要性不同，总经理，经理，首席技术官可能更重要一些，普通员工，保安，门卫可能较不重要一点。所以如果两个公司总经理，经理，首席技术官之间关系比较好，两个公司容易有比较好的关系。然而一位普通员工就算与另一家公司的一位普通员工有血海深仇，怕也难影响两个公司之间的关系。

因而判断公司与公司之间的关系，首先要找出哪些人对公司与公司之间的关系最重要，比如总经理，经理，首席技术官。其次要判断这些人之间的关系，不如两家公司的总经理曾经是同学，经理是老乡，首席技术官曾是创业伙伴。我们发现，两家公司无论总经理，经理，首席技术官，关系都很好，因而两家公司关系应该会很好。

分析了两种关系，下面看一下如何判断文档之间的关系了。

首先，一个文档有很多词(Term)组成，如search, lucene, full-text, this, a, what等。

其次对于文档之间的关系，不同的Term重要性不同，比如对于本篇文档，search, Lucene, full-text就相对重要一些，this, a , what可能相对不重要一些。所以如果两篇文档都包含search, Lucene，fulltext，这两篇文档的相关性好一些，然而就算一篇文档包含this, a, what，另一篇文档不包含this, a, what，也不能影响两篇文档的相关性。

因而判断文档之间的关系，首先找出哪些词(Term)对文档之间的关系最重要，如search, Lucene, fulltext。然后判断这些词(Term)之间的关系。

找出词(Term)对文档的重要性的过程称为计算词的权重(Term weight)的过程。

计算词的权重(term weight)有两个参数，第一个是词(Term)，第二个是文档(Document)。

词的权重(Term weight)表示此词(Term)在此文档中的重要程度，越重要的词(Term)有越大的权重(Term weight)，因而在计算文档之间的相关性中将发挥更大的作用。

判断词(Term)之间的关系从而得到文档相关性的过程应用一种叫做向量空间模型的算法(Vector Space Model)。

下面仔细分析一下这两个过程：

### 1. 计算权重(Term weight)的过程。

影响一个词(Term)在一篇文档中的重要性主要有两个因素：

*   Term Frequency (tf)：即此Term在此文档中出现了多少次。tf 越大说明越重要。
*   Document Frequency (df)：即有多少文档包含次Term。df 越大说明越不重要。

容易理解吗？词(Term)在文档中出现的次数越多，说明此词(Term)对该文档越重要，如“搜索”这个词，在本文档中出现的次数很多，说明本文档主要就是讲这方面的事的。然而在一篇英语文档中，this出现的次数更多，就说明越重要吗？不是的，这是由第二个因素进行调整，第二个因素说明，有越多的文档包含此词(Term), 说明此词(Term)太普通，不足以区分这些文档，因而重要性越低。

这也如我们程序员所学的技术，对于程序员本身来说，这项技术掌握越深越好（掌握越深说明花时间看的越多，tf越大），找工作时越有竞争力。然而对于所有程序员来说，这项技术懂得的人越少越好（懂得的人少df小），找工作越有竞争力。人的价值在于不可替代性就是这个道理。

道理明白了，我们来看看公式：

这仅仅只term weight计算公式的简单典型实现。实现全文检索系统的人会有自己的实现，Lucene就与此稍有不同。

### 2\. 判断Term之间的关系从而得到文档相关性的过程，也即向量空间模型的算法(VSM)。

我们把文档看作一系列词(Term)，每一个词(Term)都有一个权重(Term weight)，不同的词(Term)根据自己在文档中的权重来影响文档相关性的打分计算。

于是我们把所有此文档中词(term)的权重(term weight) 看作一个向量。

Document = {term1, term2, …… ,term N}

Document Vector = {weight1, weight2, …… ,weight N}

同样我们把查询语句看作一个简单的文档，也用向量来表示。

Query = {term1, term 2, …… , term N}

Query Vector = {weight1, weight2, …… , weight N}

我们把所有搜索出的文档向量及查询向量放到一个N维空间中，每个词(term)是一维。

我们认为两个向量之间的夹角越小，相关性越大。

所以我们计算夹角的余弦值作为相关性的打分，夹角越小，余弦值越大，打分越高，相关性越大。

有人可能会问，查询语句一般是很短的，包含的词(Term)是很少的，因而查询向量的维数很小，而文档很长，包含词(Term)很多，文档向量维数很大。你的图中两者维数怎么都是N呢？

在这里，既然要放到相同的向量空间，自然维数是相同的，不同时，取二者的并集，如果不含某个词(Term)时，则权重(Term Weight)为0。

相关性打分公式如下：

举个例子，查询语句有11个Term，共有三篇文档搜索出来。其中各自的权重(Term weight)，如下表格。

<figure data-size="normal">


![](https://java-tutorial.oss-cn-shanghai.aliyuncs.com/20230408113310.png)

</figure>

于是计算，三篇文档同查询语句的相关性打分分别为：

于是文档二相关性最高，先返回，其次是文档一，最后是文档三。

到此为止，我们可以找到我们最想要的文档了。

说了这么多，其实还没有进入到Lucene，而仅仅是信息检索技术(Information retrieval)中的基本理论，然而当我们看过Lucene后我们会发现，Lucene是对这种基本理论的一种基本的的实践。所以在以后分析Lucene的文章中，会常常看到以上理论在Lucene中的应用。

在进入Lucene之前，对上述索引创建和搜索过程所一个总结，如图：

<figure data-size="normal">


![](https://java-tutorial.oss-cn-shanghai.aliyuncs.com/20230408113319.png)

</figure>

1\. 索引过程：

1) 有一系列被索引文件

2) 被索引文件经过语法分析和语言处理形成一系列词(Term)。

3) 经过索引创建形成词典和反向索引表。

4) 通过索引存储将索引写入硬盘。

2\. 搜索过程：

a) 用户输入查询语句。

b) 对查询语句经过语法分析和语言分析得到一系列词(Term)。

c) 通过语法分析得到一个查询树。

d) 通过索引存储将索引读入到内存。

e) 利用查询树搜索索引，从而得到每个词(Term)的文档链表，对文档链表进行交，差，并得到结果文档。

f) 将搜索到的结果文档对查询的相关性进行排序。

g) 返回查询结果给用户。

下面我们可以进入Lucene的世界了。

## Spring Boot 中使用 Java API 调用 lucene

## Github 代码

代码我已放到 Github ，导入`spring-boot-lucene-demo` 项目

github [spring-boot-lucene-demo](https://link.juejin.im/?target=https%3A%2F%2Fgithub.com%2Fsouyunku%2Fspring-boot-examples%2Ftree%2Fmaster%2Fspring-boot-lucene-demo)

## 添加依赖



```
      21  <!--对分词索引查询解析-->
        <dependency>
            <groupId>org.apache.lucene</groupId>
            <artifactId>lucene-queryparser</artifactId>
            <version>7.1.0</version>
        </dependency>
        <!--高亮 -->
        <dependency>
            <groupId>org.apache.lucene</groupId>
            <artifactId>lucene-highlighter</artifactId>
            <version>7.1.0</version>
        </dependency>
        <!--smartcn 中文分词器 SmartChineseAnalyzer  smartcn分词器 需要lucene依赖 且和lucene版本同步-->
        <dependency>
            <groupId>org.apache.lucene</groupId>
            <artifactId>lucene-analyzers-smartcn</artifactId>
            <version>7.1.0</version>
        </dependency>
        <!--ik-analyzer 中文分词器-->
        <dependency>
            <groupId>cn.bestwu</groupId>
            <artifactId>ik-analyzers</artifactId>
            <version>5.1.0</version>
        </dependency> <!--MMSeg4j 分词器-->
        <dependency>
            <groupId>com.chenlb.mmseg4j</groupId>
            <artifactId>mmseg4j-solr</artifactId>
            <version>2.4.0</version>
            <exclusions>
                <exclusion>
                    <groupId>org.apache.solr</groupId>
                    <artifactId>solr-core</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
```



## 配置 lucene



```
private Directory directory; private IndexReader indexReader; 
private IndexSearcher indexSearcher; 
@Beforepublic void setUp() throws IOException {
//索引存放的位置，设置在当前目录中    
directory = FSDirectory.open(Paths.get("indexDir/"));     
//创建索引的读取器    
indexReader = DirectoryReader.open(directory);     
//创建一个索引的查找器，来检索索引库    
indexSearcher = new IndexSearcher(indexReader);
} 
@Afterpublic void tearDown() throws Exception {    
indexReader.close();
} 
** * 执行查询，并打印查询到的记录数 * * 
@param query * @throws IOException */
public void executeQuery(Query query) throws IOException {     
TopDocs topDocs = indexSearcher.search(query, 100);     
//打印查询到的记录数    
System.out.println("总共查询到" + topDocs.totalHits + "个文档");    
for (ScoreDoc scoreDoc : topDocs.scoreDocs) {         
//取得对应的文档对象        Document document = indexSearcher.doc(scoreDoc.doc);
System.out.println("id：" + document.get("id"));        
System.out.println("title：" + document.get("title"));        
System.out.println("content：" + document.get("content"));    
}} 
/** * 分词打印 * * @param analyzer * @param text * @throws IOException */
public void printAnalyzerDoc(Analyzer analyzer, String text) throws IOException {     
TokenStream tokenStream = analyzer.tokenStream("content", new StringReader(text));    
CharTermAttribute charTermAttribute = tokenStream.addAttribute(CharTermAttribute.class);    
try {        
tokenStream.reset();        
while (tokenStream.incrementToken()) {            
System.out.println(charTermAttribute.toString());        
}        
tokenStream.end();    
} finally {        
tokenStream.close();        
analyzer.close();    
}}
```



## 创建索引



```
@Test
public void indexWriterTest() throws IOException {    
long start = System.currentTimeMillis();     
//索引存放的位置，设置在当前目录中   
Directory directory = FSDirectory.open(Paths.get("indexDir/"));    
//在 6.6 以上版本中 version 不再是必要的，并且，存在无参构造方法，可以直接使用默认的 StandardAnalyzer 分词器。    Version version = Version.LUCENE_7_1_0;     
//Analyzer analyzer = new StandardAnalyzer(); 
// 标准分词器，适用于英文    
//Analyzer analyzer = new SmartChineseAnalyzer();
//中文分词    
//Analyzer analyzer = new ComplexAnalyzer();//中文分词    
//Analyzer analyzer = new IKAnalyzer();//中文分词     
Analyzer analyzer = new IKAnalyzer();
//中文分词     
//创建索引写入配置    
IndexWriterConfig indexWriterConfig = new IndexWriterConfig(analyzer);     
//创建索引写入对象    
IndexWriter indexWriter = new IndexWriter(directory, indexWriterConfig);     
//创建Document对象，存储索引     
Document doc = new Document();     int id = 1;     
//将字段加入到doc中    
doc.add(new IntPoint("id", id));    
doc.add(new StringField("title", "Spark", Field.Store.YES));    
doc.add(new TextField("content", "Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎", Field.Store.YES));    
doc.add(new StoredField("id", id));     
//将doc对象保存到索引库中    
indexWriter.addDocument(doc);     
indexWriter.commit();    
//关闭流    
indexWriter.close();     
long end = System.currentTimeMillis();    
System.out.println("索引花费了" + (end - start) + " 毫秒");}
```



响应

17:58:14.655 [main] DEBUG org.wltea.analyzer.dic.Dictionary - 加载扩展词典：ext.dic17:58:14.660 [main] DEBUG org.wltea.analyzer.dic.Dictionary - 加载扩展停止词典：stopword.dic索引花费了879 毫秒

## 删除文档



```
@Testpublic void deleteDocumentsTest() throws IOException 
// 标准分词器，适用于英文   
//Analyzer analyzer = new SmartChineseAnalyzer();
//中文分词    
//Analyzer analyzer = new ComplexAnalyzer();
//中文分词    
//Analyzer analyzer = new IKAnalyzer();
//中文分词     
Analyzer analyzer = new IKAnalyzer();
//中文分词     
//创建索引写入配置    
IndexWriterConfig indexWriterConfig = new IndexWriterConfig(analyzer);     
//创建索引写入对象    
IndexWriter indexWriter = new IndexWriter(directory, indexWriterConfig);     
// 删除title中含有关键词“Spark”的文档    
long count = indexWriter.deleteDocuments(new Term("title", "Spark"));     
//  除此之外IndexWriter还提供了以下方法：   
// DeleteDocuments(Query query):根据Query条件来删除单个或多个Document    
// DeleteDocuments(Query[] queries):根据Query条件来删除单个或多个Document    
// DeleteDocuments(Term term):根据Term来删除单个或多个Document    
// DeleteDocuments(Term[] terms):根据Term来删除单个或多个Document    
// DeleteAll():删除所有的Document     
//使用IndexWriter进行Document删除操作时，文档并不会立即被删除，而是把这个删除动作缓存起来，当IndexWriter.Commit()或IndexWriter.Close()时，删除操作才会被真正执行。     
indexWriter.commit();    
indexWriter.close();     
System.out.println("删除完成:" + count);
}
```



响应

删除完成:1

## 更新文档



```
/** * 测试更新 * 实际上就是删除后新增一条 * * @throws IOException */
@Test
public void updateDocumentTest() throws IOException {    
//Analyzer analyzer = new StandardAnalyzer(); 
// 标准分词器，适用于英文   
//Analyzer analyzer = new SmartChineseAnalyzer();//中文分词    
//Analyzer analyzer = new ComplexAnalyzer();
//中文分词    
//Analyzer analyzer = new IKAnalyzer();
//中文分词     
Analyzer analyzer = new IKAnalyzer();
//中文分词     
//创建索引写入配置    
IndexWriterConfig indexWriterConfig = new IndexWriterConfig(analyzer);     
//创建索引写入对象    
IndexWriter indexWriter = new IndexWriter(directory, indexWriterConfig);    
Document doc = new Document();     
int id = 1;     
doc.add(new IntPoint("id", id));    
doc.add(new StringField("title", "Spark", Field.Store.YES));    
doc.add(new TextField("content", "Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎", Field.Store.YES));    
doc.add(new StoredField("id", id));     
long count = indexWriter.updateDocument(new Term("id", "1"), doc);    
System.out.println("更新文档:" + count);    
indexWriter.close();
}
```



响应

更新文档:1

## 按词条搜索



```
/** * 按词条搜索 * <p> * TermQuery是最简单、也是最常用的Query。TermQuery可以理解成为“词条搜索”， * 在搜索引擎中最基本的搜索就是在索引中搜索某一词条，而TermQuery就是用来完成这项工作的。 * 在Lucene中词条是最基本的搜索单位，从本质上来讲一个词条其实就是一个名/值对。 * 只不过这个“名”是字段名，而“值”则表示字段中所包含的某个关键字。 * * @throws IOException */
@Test
public void termQueryTest() throws IOException {
     String searchField = "title";    
     //这是一个条件查询的api，用于添加条件    
     TermQuery query = new TermQuery(new Term(searchField, "Spark"));     
     //执行查询，并打印查询到的记录数    
     executeQuery(query);
     }
```



响应

总共查询到1个文档id：1title：Sparkcontent：Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎!

## 多条件查询



```
/** * 多条件查询 * * BooleanQuery也是实际开发过程中经常使用的一种Query。 * 它其实是一个组合的Query，在使用时可以把各种Query对象添加进去并标明它们之间的逻辑关系。 * BooleanQuery本身来讲是一个布尔子句的容器，它提供了专门的API方法往其中添加子句， * 并标明它们之间的关系，以下代码为BooleanQuery提供的用于添加子句的API接口： * * @throws IOException */
@Testpublic void BooleanQueryTest() throws IOException { 
    String searchField1 = "title";    
    String searchField2 = "content";    
    Query query1 = new TermQuery(new Term(searchField1, "Spark"));    
    Query query2 = new TermQuery(new Term(searchField2, "Apache"));    
    BooleanQuery.Builder builder = new BooleanQuery.Builder();     
    // BooleanClause用于表示布尔查询子句关系的类，    
    // 包 括：    
    // BooleanClause.Occur.MUST，    
    // BooleanClause.Occur.MUST_NOT，    
    // BooleanClause.Occur.SHOULD。    
    // 必须包含,不能包含,可以包含三种.有以下6种组合：    
    //    
    // 1．MUST和MUST：取得连个查询子句的交集。    
    // 2．MUST和MUST_NOT：表示查询结果中不能包含MUST_NOT所对应得查询子句的检索结果。    
    // 3．SHOULD与MUST_NOT：连用时，功能同MUST和MUST_NOT。    
    // 4．SHOULD与MUST连用时，结果为MUST子句的检索结果,但是SHOULD可影响排序。    
    // 5．SHOULD与SHOULD：表示“或”关系，最终检索结果为所有检索子句的并集。    
    // 6．MUST_NOT和MUST_NOT：无意义，检索无结果。     
    builder.add(query1, BooleanClause.Occur.SHOULD);   
    builder.add(query2, BooleanClause.Occur.SHOULD);     
    BooleanQuery query = builder.build();     
    //执行查询，并打印查询到的记录数    
    executeQuery(query);
    }
```



响应

总共查询到1个文档id：1title：Sparkcontent：Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎!

## 匹配前缀



```
/** * 匹配前缀 * <p> * PrefixQuery用于匹配其索引开始以指定的字符串的文档。就是文档中存在xxx% * <p> * * @throws IOException */
@Testpublic void prefixQueryTest() throws IOException {    
String searchField = "title";    
Term term = new Term(searchField, "Spar");    
Query query = new PrefixQuery(term);     
//执行查询，并打印查询到的记录数    
executeQuery(query);
}
```



响应

总共查询到1个文档id：1title：Sparkcontent：Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎!

## 短语搜索



```
/** * 短语搜索 * <p> * 所谓PhraseQuery，就是通过短语来检索，比如我想查“big car”这个短语， * 那么如果待匹配的document的指定项里包含了"big car"这个短语， * 这个document就算匹配成功。可如果待匹配的句子里包含的是“big black car”， * 那么就无法匹配成功了，如果也想让这个匹配，就需要设定slop， * 先给出slop的概念：slop是指两个项的位置之间允许的最大间隔距离 * * @throws IOException */
@Testpublic void phraseQueryTest() throws IOException {     
String searchField = "content";    
String query1 = "apache";    
String query2 = "spark";     
PhraseQuery.Builder builder = new PhraseQuery.Builder();    
builder.add(new Term(searchField, query1));    
builder.add(new Term(searchField, query2));    
builder.setSlop(0);    
PhraseQuery phraseQuery = builder.build();     
//执行查询，并打印查询到的记录数    
executeQuery(phraseQuery);
}
```



响应

总共查询到1个文档id：1title：Sparkcontent：Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎!

## 相近词语搜索

/** * 相近词语搜索 * <p> * FuzzyQuery是一种模糊查询，它可以简单地识别两个相近的词语。 * * @throws IOException */@Testpublic void fuzzyQueryTest() throws IOException { String searchField = "content"; Term t = new Term(searchField, "大规模"); Query query = new FuzzyQuery(t); //执行查询，并打印查询到的记录数 executeQuery(query);}

响应

总共查询到1个文档id：1title：Sparkcontent：Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎!

## 通配符搜索

/** * 通配符搜索 * <p> * Lucene也提供了通配符的查询，这就是WildcardQuery。 * 通配符“?”代表1个字符，而“*”则代表0至多个字符。 * * @throws IOException */@Testpublic void wildcardQueryTest() throws IOException { String searchField = "content"; Term term = new Term(searchField, "大*规模"); Query query = new WildcardQuery(term); //执行查询，并打印查询到的记录数 executeQuery(query);}

响应

总共查询到1个文档id：1title：Sparkcontent：Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎!

## 分词查询



```
/** * 分词查询 * * @throws IOException * @throws ParseException */
@Test
public void queryParserTest() throws IOException, ParseException {    
//Analyzer analyzer = new StandardAnalyzer(); 
// 标准分词器，适用于英文    
//Analyzer analyzer = new SmartChineseAnalyzer();
//中文分词    
//Analyzer analyzer = new ComplexAnalyzer();
//中文分词    //Analyzer analyzer = new IKAnalyzer();
//中文分词     Analyzer analyzer = new IKAnalyzer();
//中文分词     String searchField = "content";     
//指定搜索字段和分析器    
QueryParser parser = new QueryParser(searchField, analyzer);     
//用户输入内容    Query query = parser.parse("计算引擎");     
//执行查询，并打印查询到的记录数    
executeQuery(query);
}
```



响应

总共查询到1个文档id：1title：Sparkcontent：Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎!

## 多个 Field 分词查询



```
/** * 多个 Field 分词查询 * * @throws IOException * @throws ParseException */
@Testpublic void multiFieldQueryParserTest() throws IOException, ParseException {    
//Analyzer analyzer = new StandardAnalyzer(); 
// 标准分词器，适用于英文    
//Analyzer analyzer = new SmartChineseAnalyzer();//中文分词    
//Analyzer analyzer = new ComplexAnalyzer();
//中文分词    
//Analyzer analyzer = new IKAnalyzer();
//中文分词     Analyzer analyzer = new IKAnalyzer();
//中文分词     String[] filedStr = new String[]{"title", "content"};     
//指定搜索字段和分析器    
QueryParser queryParser = new MultiFieldQueryParser(filedStr, analyzer);     
//用户输入内容    
Query query = queryParser.parse("Spark");     
//执行查询，并打印查询到的记录数    executeQuery(query);}
```



响应

总共查询到1个文档id：1title：Sparkcontent：Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎!

## 中文分词器



```
/** * IKAnalyzer  中文分词器 * SmartChineseAnalyzer  smartcn分词器 需要lucene依赖 且和lucene版本同步 * * @throws IOException */
@Test
public void AnalyzerTest() throws IOException { 
//Analyzer analyzer = new StandardAnalyzer(); 
// 标准分词器，适用于英文    
//Analyzer analyzer = new SmartChineseAnalyzer();
//中文分词    //Analyzer analyzer = new ComplexAnalyzer();
//中文分词    //Analyzer analyzer = new IKAnalyzer();
//中文分词     
Analyzer analyzer = null;    
String text = "Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎";
analyzer = new IKAnalyzer();//IKAnalyzer 中文分词    
printAnalyzerDoc(analyzer, text);    
System.out.println();     
analyzer = new ComplexAnalyzer();
//MMSeg4j 中文分词    
printAnalyzerDoc(analyzer, text);    
System.out.println();     
analyzer = new SmartChineseAnalyzer();
//Lucene 中文分词器    
printAnalyzerDoc(analyzer, text);}
```



三种分词响应

apachespark专为大规模规模模数数据处理数据处理而设设计快速通用计算引擎

apachespark是专为大规模数据处理而设计的快速通用的计算引擎

apachspark是专为大规模数据处理而设计的快速通用的计算引擎

## 高亮处理



```
/** * 高亮处理 * * @throws IOException */
@Test
public void HighlighterTest() throws IOException, ParseException, InvalidTokenOffsetsException {
//Analyzer analyzer = new StandardAnalyzer(); 
// 标准分词器，适用于英文   
//Analyzer analyzer = new SmartChineseAnalyzer();
//中文分词   
//Analyzer analyzer = new ComplexAnalyzer();
//中文分词    
//Analyzer analyzer = new IKAnalyzer();
//中文分词     Analyzer analyzer = new IKAnalyzer();
//中文分词     String searchField = "content";    
String text = "Apache Spark 大规模数据处理";     
//指定搜索字段和分析器    
QueryParser parser = new QueryParser(searchField, analyzer);     
//用户输入内容    
Query query = parser.parse(text);     
TopDocs topDocs = indexSearcher.search(query, 100);     
// 关键字高亮显示的html标签，需要导入lucene-highlighter-xxx.jar    
SimpleHTMLFormatter simpleHTMLFormatter = new SimpleHTMLFormatter("", "");    
Highlighter highlighter = new Highlighter(simpleHTMLFormatter, new QueryScorer(query));     
for (ScoreDoc scoreDoc : topDocs.scoreDocs) {         
//取得对应的文档对象        
Document document = indexSearcher.doc(scoreDoc.doc);         
// 内容增加高亮显示        
TokenStream tokenStream = analyzer.tokenStream("content", new StringReader(document.get("content")));        
String content = highlighter.getBestFragment(tokenStream, document.get("content"));         
System.out.println(content);    
} 
}
```



响应

Apache Spark 是专为大规模数据处理而设计的快速通用的计算引擎!

代码我已放到 Github ，导入`spring-boot-lucene-demo` 项目

[github spring-boot-lucene-demo](https://docs.qq.com/doc/DWVNPQXRvcWhMTktC)
