lucene原理及java实现【容易理解】

た入场券 2023-06-13 04:55 7阅读 0赞

转自

[https://blog.csdn.net/m0\_37955444/article/details/79514811][https_blog.csdn.net_m0_37955444_article_details_79514811]

## 一、Lucene是什么？ ##

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的检索过程，而是描述了全文检索的一般过程。

![\[图\]全文检索的一般过程][format_png]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

![\[图\]字典及倒排表结构][format_png 1]

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

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

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

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

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

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

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

![\[图\]倒排表合并过程][format_png 2]

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

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

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

## 三、如何创建索引 ##

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

### 第一步：一些要索引的原文档(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)创建一个字典。

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

<table> 
 <tbody> 
 <tr> 
 <td>Term</td> 
 <td>Document ID</td> 
 </tr> 
 <tr> 
 <td>student</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>allow</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>go</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>their</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>friend</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>allow</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>drink</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>beer</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>my</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>friend</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>jerry</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>go</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>school</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>see</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>his</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>student</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>find</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>them</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>drink</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>allow</td> 
 <td>2</td> 
 </tr> 
 </tbody> 
</table>

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

<table> 
 <tbody> 
 <tr> 
 <td>Term</td> 
 <td>Document ID</td> 
 </tr> 
 <tr> 
 <td>allow</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>allow</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>allow</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>beer</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>drink</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>drink</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>find</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>friend</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>friend</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>go</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>go</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>his</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>jerry</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>my</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>school</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>see</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>student</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>student</td> 
 <td>2</td> 
 </tr> 
 <tr> 
 <td>their</td> 
 <td>1</td> 
 </tr> 
 <tr> 
 <td>them</td> 
 <td>2</td> 
 </tr> 
 </tbody> 
</table>

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

![\[图\]倒排表结构][format_png 3]

在此表中，有几个定义：

*  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的搜索实例][Google]

当然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形成的语法树如下：

![\[图\]语法树][format_png 4]

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

如learned变成learn等。

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

![\[图\]经过语言处理的语法树][format_png 5]

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

此步骤有分几小步：

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小），找工作越有竞争力。人的价值在于不可替代性就是这个道理。

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

![\[图\]权重计算公式][format_png 6]

![\[图\]权重计算公式变量][format_png 7]

这仅仅只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)是一维。

如图：

![\[图\]向量空间模型][format_png 8]

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

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

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

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

相关性打分公式如下：

![\[图\]相关性打分的公式][format_png 9]

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

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

![\[图\]文档一的打分计算][format_png 10]

![\[图\]文档二的打分计算][format_png 11]

![\[图\]文档三的打分计算][format_png 12]

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

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

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

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

此图参照[http://www.lucene.com.cn/about.htm][http_www.lucene.com.cn_about.htm] 中文章《开放源代码的全文检索引擎Lucene》

![\[图\]索引创建和搜索过程][format_png 13]

1. 索引过程：

1) 有一系列被索引文件

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

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

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

2. 搜索过程：

a) 用户输入查询语句。

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

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

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

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

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

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

## 五、java实现 ##

目前Lucene已经更新到6.5版本，自从4.9版本就需要1.7以上的JDK，所以如果还用1.6甚至是1.5的小盆友，请参考低版本，由于我用的1.7，因此在使用Lucene5.5。

废话不多说直接上实现的代码，里面包含注解:

import java.io.BufferedReader; 
import java.io.File; 
import java.io.FileInputStream; 
import java.io.FileReader; 
import java.nio.file.Paths; 
import java.util.ArrayList; 
import java.util.Date; 
import java.util.List; 
 
import jxl.Cell; 
import jxl.Sheet; 
import jxl.Workbook; 
 
import org.apache.lucene.analysis.Analyzer; 
import org.apache.lucene.analysis.standard.StandardAnalyzer; 
import org.apache.lucene.document.Document; 
import org.apache.lucene.document.Field.Store; 
import org.apache.lucene.document.TextField; 
import org.apache.lucene.index.DirectoryReader; 
import org.apache.lucene.index.IndexWriter; 
import org.apache.lucene.index.IndexWriterConfig; 
import org.apache.lucene.queryparser.classic.QueryParser; 
import org.apache.lucene.search.IndexSearcher; 
import org.apache.lucene.search.Query; 
import org.apache.lucene.search.ScoreDoc; 
import org.apache.lucene.store.Directory; 
import org.apache.lucene.store.FSDirectory; 
import org.apache.poi.POIXMLDocument; 
import org.apache.poi.hwpf.HWPFDocument; 
import org.apache.poi.hwpf.usermodel.Range; 
import org.apache.poi.openxml4j.opc.OPCPackage; 
import org.apache.poi.xwpf.usermodel.XWPFDocument; 
import org.apache.poi.xwpf.usermodel.XWPFParagraph; 
 
 
 
 
public class LuceneTest \{ 
private static LuceneTest indexManager; 
private static String content=""; 
private static String INDEX\_DIR = "e:\\\\luceneIndex"; 
private static String DATA\_DIR = "e:\\\\luceneData"; 
private static Analyzer analyzer = null; 
private static Directory directory = null; 
private static IndexWriter indexWriter = null; 
 
public static void main(String\[\] arg)\{ 
File fileIndex = new File(INDEX\_DIR); 
if(deleteDir(fileIndex))\{ 
           fileIndex.mkdir(); 
       \}else\{ 
           fileIndex.mkdir(); 
    \} 
createIndex(DATA\_DIR); 
    searchIndex("man"); 
\} 
 
    /\*\* 
     \* 创建当前文件目录的索引 
     \* @param path 当前文件目录 
     \* @return 是否成功 
     \*/ 
    public static boolean createIndex(String path)\{ 
     
    Date date1 = new Date(); 
         List<File> fileList = getFileList(path); 
         for (File file : fileList) \{ 
        content = ""; 
             //获取文件后缀 
             String type = file.getName().substring(file.getName().lastIndexOf(".")+1); 
             if("txt".equalsIgnoreCase(type))\{ 
                 content += txt2String(file); 
             \}else if("doc".equalsIgnoreCase(type))\{ 
                 content += doc2String(file); 
             \}else if("xls".equalsIgnoreCase(type))\{ 
                 content += xls2String(file); 
             \} 
             System.out.println("name :"+file.getName()); 
             System.out.println("path :"+file.getPath()); 
             System.out.println("content :"+content); 
             System.out.println(); 
              
             try\{ 
            //词法分析器Analyzer 
            analyzer = new StandardAnalyzer(); 
            //本地文件存储 
                 directory = FSDirectory.open(Paths.get(INDEX\_DIR)); 
                 //内存存储 
                 //Directory directory = new RAMDirectory(); 
      
                 File indexFile = new File(INDEX\_DIR); 
                 if (!indexFile.exists()) \{ 
                     indexFile.mkdirs(); 
                 \} 
                 //创建IndexWriter，进行索引文件的写入 
                 IndexWriterConfig config = new IndexWriterConfig(analyzer); 
                 indexWriter = new IndexWriter(directory, config); 
                  
                 //内容提取，进行索引的存储。 
                 Document document = new Document(); 
                 document.add(new TextField("filename", file.getName(), Store.YES)); 
                 document.add(new TextField("content", content, Store.YES)); 
                 document.add(new TextField("path", file.getPath(), Store.YES)); 
                 indexWriter.addDocument(document); 
                 indexWriter.commit(); 
                 closeWriter(); 
             \}catch(Exception e)\{ 
            e.getStackTrace(); 
             \} 
              
         \} 
         Date date2 = new Date(); 
         System.out.println("创建索引-----耗时：" + (date2.getTime() - date1.getTime()) + "ms\\n"); 
         return true; 
    \} 
    /\*\* 
     \* 查找索引，返回符合条件的文件 
     \* @param text 查找的字符串 
     \* @return 符合条件的文件List 
     \*/ 
    public static void searchIndex(String text)\{ 
    Date date1 = new Date(); 
        try\{ 
        //打开存储位置 
            directory = FSDirectory.open(Paths.get(INDEX\_DIR)); 
            analyzer = new StandardAnalyzer(); 
            DirectoryReader ireader = DirectoryReader.open(directory); 
            //创建搜索器 
            IndexSearcher isearcher = new IndexSearcher(ireader); 
     
            QueryParser parser = new QueryParser("content", analyzer); 
            Query query = parser.parse(text); 
             
            ScoreDoc\[\] hits = isearcher.search(query, null, 1000).scoreDocs; 
         
            for (int i = 0; i < hits.length; i++) \{ 
                Document hitDoc = isearcher.doc(hits\[i\].doc); 
                System.out.println("\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_"); 
                System.out.println(hitDoc.get("filename")); 
                System.out.println(hitDoc.get("content")); 
                System.out.println(hitDoc.get("path")); 
                System.out.println("\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_"); 
            \} 
            ireader.close(); 
            directory.close(); 
        \}catch(Exception e)\{ 
            e.printStackTrace(); 
        \} 
        Date date2 = new Date(); 
        System.out.println("查看索引-----耗时：" + (date2.getTime() - date1.getTime()) + "ms\\n"); 
    \} 
  /\*\* 
     \* 删除文件目录下的所有文件 
     \* @param file 要删除的文件目录 
     \* @return 如果成功，返回true. 
     \*/ 
    public static boolean deleteDir(File file)\{ 
        if(file.isDirectory())\{ 
            File\[\] files = file.listFiles(); 
            for(int i=0; i<files.length; i++)\{ 
                deleteDir(files\[i\]); 
            \} 
        \} 
        file.delete(); 
        return true; 
    \} 
    /\*\* 
     \* 过滤目录下的文件 
     \* @param dirPath 想要获取文件的目录 
     \* @return 返回文件list 
     \*/ 
    public static List<File> getFileList(String dirPath) \{ 
        File\[\] files = new File(dirPath).listFiles(); 
        List<File> fileList = new ArrayList<File>(); 
        for (File file : files) \{ 
            if (isTxtFile(file.getName())) \{ 
                fileList.add(file); 
            \} 
        \} 
        return fileList; 
    \} 
    /\*\* 
     \* 判断是否为目标文件，目前支持txt xls doc格式 
     \* @param fileName 文件名称 
     \* @return 如果是文件类型满足过滤条件，返回true；否则返回false 
     \*/ 
    public static boolean isTxtFile(String fileName) \{ 
        if (fileName.lastIndexOf(".txt") > 0) \{ 
            return true; 
        \}else if (fileName.lastIndexOf(".xls") > 0) \{ 
            return true; 
        \}else if (fileName.lastIndexOf(".doc") > 0) \{ 
            return true; 
        \} 
        return false; 
    \} 
    /\*\* 
     \* 读取txt文件的内容 
     \* @param file 想要读取的文件对象 
     \* @return 返回文件内容 
     \*/ 
    public static String txt2String(File file)\{ 
        String result = ""; 
        try\{ 
            BufferedReader br = new BufferedReader(new FileReader(file));//构造一个BufferedReader类来读取文件 
            String s = null; 
            while((s = br.readLine())!=null)\{//使用readLine方法，一次读一行 
                result = result + "\\n" +s; 
            \} 
            br.close();     
        \}catch(Exception e)\{ 
            e.printStackTrace(); 
        \} 
        return result; 
    \} 
    /\*\* 
     \* 读取doc文件内容 
     \* @param file 想要读取的文件对象 
     \* @return 返回文件内容 
     \*/ 
    public static String doc2String(File file)\{ 
        String result = ""; 
        try\{ 
            FileInputStream fis = new FileInputStream(file); 
            //适合office2007以上 
            OPCPackage pack = POIXMLDocument.openPackage(file.getPath()); 
            XWPFDocument  docx = new XWPFDocument(pack) ; 
            List<XWPFParagraph> paras = docx.getParagraphs();  
            for (XWPFParagraph para : paras) \{  
            result += para.getText().trim(); 
            \}  
            //只适合office2003 
//            HWPFDocument doc = new HWPFDocument(fis); 
//            Range rang = doc.getRange(); 
//            result += rang.text(); 
//            fis.close(); 
        \}catch(Exception e)\{ 
            e.printStackTrace(); 
        \} 
        return result; 
    \} 
    /\*\* 
     \* 读取xls文件内容 
     \* @param file 想要读取的文件对象 
     \* @return 返回文件内容 
     \*/ 
    public static String xls2String(File file)\{ 
        String result = ""; 
        try\{ 
            FileInputStream fis = new FileInputStream(file);    
            StringBuilder sb = new StringBuilder();    
            jxl.Workbook rwb = Workbook.getWorkbook(fis);    
            Sheet\[\] sheet = rwb.getSheets();    
            for (int i = 0; i < sheet.length; i++) \{    
                Sheet rs = rwb.getSheet(i);    
                for (int j = 0; j < rs.getRows(); j++) \{    
                   Cell\[\] cells = rs.getRow(j);    
                   for(int k=0;k<cells.length;k++)    
                   sb.append(cells\[k\].getContents());    
                \}    
            \}    
            fis.close();    
            result += sb.toString(); 
        \}catch(Exception e)\{ 
            e.printStackTrace(); 
        \} 
        return result; 
    \} 
    public static void closeWriter() throws Exception \{ 
        if (indexWriter != null) \{ 
            indexWriter.close(); 
        \} 
    \} 
     
    /\*\* 
     \* 创建索引管理器 
     \* @return 返回索引管理器对象 
     \*/ 
    public LuceneTest getManager()\{ 
        if(indexManager == null)\{ 
            this.indexManager = new LuceneTest(); 
        \} 
        return indexManager; 
    \} 
     
\}

要上传jar包如下图：

## 六、[ 内存索引库和文件索引库结合][Link 1] ##

在lucene索引库的创建的时候，我们有两种不同的索引库创建方式

## 1.文件索引库 ##

final Path docDir = Paths.get("index");

Directory directory=FSDirectory.open(Paths.get("index"));

1.  `这样创建的索引库是在本地磁盘上创建一个index文件夹，并且将索引放在index中，也称为文件索引库`
2.  `优点：将索引持久化到磁盘上，能长久保存。`
3.  `缺点：相比较内存索引库，读取慢`

## 2.内存索引 ##

Directory directory= new RAMDirectory();

1.  `只需要一句代码，就创建了一个内存索引库`
2.  `优点：读取快`
3.  `缺点：不具备持久化能力，结束时候内存索引库便会删除`

## 3.两种索引库的结合 ##

根据两种索引库的特点我们可以将两种索引库结合起来，设计的思路是在程序启动时，将文件索引库中的索引拷贝到内存索引库中，然后让程序与内存索引库交互，当交互完毕后再将内存索引库的索引持久化到文件索引库。

/\*\*  
         \* 1.创建两个索引库  
         \* 2.创建两个IndexWriter  
         \* 3.把文件索引库中的内容放到内存索引库中  
         \* 4.让内存索引库和客户端进行交互  
         \* 5.把内存索引库的内容放到文件索引库  
         \*/  
        final Path docDir = Paths.get("index");  
        //创建文件索引库  
        Directory fileDirectory=FSDirectory.open(Paths.get("index"));  
        //创建内存索引库  
        Directory ramDirectory = new RAMDirectory(FSDirectory.open(Paths.get("index")), null);  
  
  
        Analyzer analyzer = new StandardAnalyzer();  
        IndexWriterConfig iwc = new IndexWriterConfig(analyzer);  
        //操作文件的IndexWriter  
        IndexWriter fileIndexWriter = new IndexWriter(fileDirectory, iwc);  
        //操作内存的IndexWriter  
        Analyzer analyzer1 = new StandardAnalyzer();  
        IndexWriterConfig iwc1 = new IndexWriterConfig(analyzer1);  
        IndexWriter ramIndexWriter=new IndexWriter(ramDirectory, iwc1);  
  
  
        Article article = new Article();  
        article.setAid(1L);  
        article.setTitle("lucene是一个全文检索引擎");  
        article.setContent("baidu,google都是很好的全文检索引擎");  
  
  
        // 创建document  
        Document document = new Document();  
        Field idField = new Field("aid", article.getAid().toString(),  
                TextField.TYPE\_STORED);  
        Field titleField = new Field("title", article.getTitle().toString(),  
                TextField.TYPE\_STORED);  
        Field contentField = new Field("content", article.getContent()  
                .toString(), TextField.TYPE\_STORED);  
        document.add(idField);  
        document.add(titleField);  
        document.add(contentField);  
  
  
        //把document放到内存当中  
        ramIndexWriter.addDocument(document);  
        ramIndexWriter.close();  
        //把内存索引库的内容合并到文件索引库  
        fileIndexWriter.addIndexes(ramDirectory);  
        fileIndexWriter.close();

[https_blog.csdn.net_m0_37955444_article_details_79514811]: https://blog.csdn.net/m0_37955444/article/details/79514811
[format_png]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTE5ZGJlRS5wbmc?x-oss-process=image/format,png
[format_png 1]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTIwRGNjeC5qcGc?x-oss-process=image/format,png
[format_png 2]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTIwNU1STS5qcGc?x-oss-process=image/format,png
[format_png 3]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTIycVhxOS5qcGc?x-oss-process=image/format,png
[Google]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTI4TDNGYy5qcGc?x-oss-process=image/format,png
[format_png 4]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTI5aGYyMi5qcGc?x-oss-process=image/format,png
[format_png 5]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTI5UUNNWC5qcGc?x-oss-process=image/format,png
[format_png 6]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTMwOVd3bS5wbmc?x-oss-process=image/format,png
[format_png 7]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTMwVklseC5wbmc?x-oss-process=image/format,png
[format_png 8]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTMxVUREZy5qcGc?x-oss-process=image/format,png
[format_png 9]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTMyM0l1VS5wbmc?x-oss-process=image/format,png
[format_png 10]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTMyMDE0MC5wbmc?x-oss-process=image/format,png
[format_png 11]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTMzWFI0NS5wbmc?x-oss-process=image/format,png
[format_png 12]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTM0MWhIRi5wbmc?x-oss-process=image/format,png
[http_www.lucene.com.cn_about.htm]: http://www.lucene.com.cn/about.htm
[format_png 13]: https://imgconvert.csdnimg.cn/aHR0cDovL2hpLmNzZG4ubmV0L2F0dGFjaG1lbnQvMjAxMDAyLzEvMzYzNDkxN18xMjY1MDQ4NTM1Y1MzQS5qcGc?x-oss-process=image/format,png
[Link 1]: http://blog.csdn.net/qq_28042463/article/details/51538283