一、基础内容

0、官方文档说明

（1）org.apache.lucene.index provides two primary classes: 
IndexWriter, which creates and adds documents to indices; and 
IndexReader, which accesses the data in the index.

（2）涉及的两个主要包有：

org.apache.lucene.
index:Code to maintain and access indices.
org.apache.lucene.
document:The
logical representation of a Document for indexing and searching.

1、创建一个索引时，涉及的重要类有以下几个：

（1）IndexWriter：索引过程中的核心组件，用于创建新索引或者打开已有索引，以及向索引中添加、删除、更新被索引文档的信息。

（2）Document：代表一些域(field)的集合。

（3）Field及其子类：一个域，如文档创建时间，作者，内容等。

（4）Analyzer：分析器。

（5）Directory：可用于描述Lucene索引的存放位置。

2、索引文档的基本步骤如下：

（1）创建索引库IndexWriter
（2）根据文件创建文档Document
（3）向索引库中写入文档内容

基本程序如下：

[java]  view plain copy

package
 org.jediael.search.index;  
1.
  
1.
import
 java.io.File;  
1.
import
 java.io.FileReader;  
1.
import
 java.io.IOException;  
1.
  
1.
import
 org.apache.lucene.analysis.standard.StandardAnalyzer;  
1.
import
 org.apache.lucene.document.Document;  
1.
import
 org.apache.lucene.document.Field;  
1.
import
 org.apache.lucene.document.LongField;  
1.
import
 org.apache.lucene.document.StringField;  
1.
import
 org.apache.lucene.document.TextField;  
1.
import
 org.apache.lucene.index.IndexWriter;  
1.
import
 org.apache.lucene.index.IndexWriterConfig;  
1.
import
 org.apache.lucene.store.Directory;  
1.
import
 org.apache.lucene.store.FSDirectory;  
1.
import
 org.apache.lucene.util.Version;  
1.
import
 org.jediael.util.LoadProperties;  
1.
  
1.
// 1、创建索引库IndexWriter
  
1.
// 2、根据文件创建文档Document
  
1.
// 3、向索引库中写入文档内容
  
1.
  
1.
public
 
class
 IndexFiles {  
1.
      
1.
    
private
 IndexWriter writer = 
null
;  
1.
  
1.
    
public
 
void
 indexAllFileinDirectory(String indexPath, String docsPath)  
1.
            
throws
 IOException {  
1.
        
// 获取放置待索引文件的位置，若传入参数为空，则读取search.properties中设置的默认值。
  
1.
        
if
 (docsPath == 
null
) {  
1.
            docsPath = LoadProperties.getProperties(
"docsDir"
);  
1.
        }  
1.
        
final
 File docDir = 
new
 File(docsPath);  
1.
        
if
 (!docDir.exists() || !docDir.canRead()) {  
1.
            System.out  
1.
                    .println(
"Document directory '"
  
1.
                            + docDir.getAbsolutePath()  
1.
                            + 
"' does not exist or is not readable, please check the path"
);  
1.
            System.exit(
1
);  
1.
        }  
1.
  
1.
        
// 获取放置索引文件的位置，若传入参数为空，则读取search.properties中设置的默认值。
  
1.
        
if
 (indexPath == 
null
) {  
1.
            indexPath = LoadProperties.getProperties(
"indexDir"
);  
1.
        }  
1.
        
final
 File indexDir = 
new
 File(indexPath);  
1.
        
if
 (!indexDir.exists() || !indexDir.canRead()) {  
1.
            System.out  
1.
                    .println(
"Document directory '"
  
1.
                            + indexDir.getAbsolutePath()  
1.
                            + 
"' does not exist or is not readable, please check the path"
);  
1.
            System.exit(
1
);  
1.
        }  
1.
  
1.
          
1.
        
try
 {  
1.
            
// 1、创建索引库IndexWriter
  
1.
            
if
(writer == 
null
){  
1.
                initialIndexWriter(indexDir);  
1.
            }  
1.
            index(writer, docDir);  
1.
        } 
catch
 (IOException e) {  
1.
            e.printStackTrace();  
1.
        } 
finally
{  
1.
            writer.close();  
1.
        }  
1.
    }  
1.
  
1.
    
//使用了最简单的单例模式，用于返回一个唯一的IndexWirter，注意此处非线程安全，需要进一步优化。
  
1.
    
private
 
void
 initialIndexWriter(File indexDir) 
throws
 IOException {  
1.
  
1.
        Directory returnIndexDir = FSDirectory.open(indexDir);  
1.
        IndexWriterConfig iwc = 
new
 IndexWriterConfig(Version.LUCENE_48,
new
 StandardAnalyzer(Version.LUCENE_48));  
1.
        writer = 
new
 IndexWriter(returnIndexDir, iwc);  
1.
  
1.
    }  
1.
  
1.
    
private
 
void
 index(IndexWriter writer, File filetoIndex) 
throws
 IOException {  
1.
  
1.
        
if
 (filetoIndex.isDirectory()) {  
1.
            String[] files = filetoIndex.list();  
1.
            
if
 (files != 
null
) {  
1.
                
for
 (
int
 i = 
0
; i < files.length; i++) {  
1.
                    index(writer, 
new
 File(filetoIndex, files[i]));  
1.
                }  
1.
            }  
1.
        } 
else
 {  
1.
            
// 2、根据文件创建文档Document，考虑一下能否不用每次创建Document对象
  
1.
            Document doc = 
new
 Document();  
1.
            Field pathField = 
new
 StringField(
"path"
, filetoIndex.getPath(),  
1.
                    Field.Store.YES);  
1.
            doc.add(pathField);  
1.
            doc.add(
new
 LongField(
"modified"
, filetoIndex.lastModified(),  
1.
                    Field.Store.YES));  
1.
            doc.add(
new
 StringField(
"title"
,filetoIndex.getName(),Field.Store.YES));  
1.
            doc.add(
new
 TextField(
"contents"
, 
new
 FileReader(filetoIndex)));  
1.
            
//System.out.println("Indexing " + filetoIndex.getName());
  
1.
  
1.
            
// 3、向索引库中写入文档内容
  
1.
            writer.addDocument(doc);  
1.
        }  
1.
    }  
1.
}  

一些说明：

（1）使用了最简单的单例模式，用于返回一个唯一的IndexWirter，注意此处非线程安全，需要进一步优化。

（2）注意IndexWriter，IndexReader等均需要耗费较大的资源用于创建实例，因此如非必要，使用单例模式创建一个实例后。

3、索引、Document、Filed之间的关系

简而言之，多个Filed组成一个Document，多个Document组成一个索引。

它们之间通过以下方法相互调用：

[java]  view plain copy

Document doc = 
new
 Document();  
1.
Field pathField = 
new
 StringField(
"path"
, filetoIndex.getPath(),Field.Store.YES);  
1.
doc.add(pathField);  
1.
  
1.
writer.addDocument(doc);  

二、关于Field

（一）创建一个域（field）的基本方法

1、在Lucene4.x前，使用以下方式创建一个Field：

[java]  view plain copy

Field field = 
new
 Field(
"filename"
, f.getName(),  Field.Store.YES, Field.Index.NOT_ANALYZED);  
1.
Field field = 
new
 Field(
"contents"
, 
new
 FileReader(f));  
1.
Field field = 
new
 Field(
"fullpath"
, f.getCanonicalPath(), Field.Store.YES, Field.Index.NOT_ANALYZED)  
Filed的四个参数分别代表：

域的名称

域的值

是否保存

是否分析，对于文件名称，url，文件路径等内容，不需要对其进行分析。

2、在Lucene4后，定义了大量的Field的实现类型，根据需要，直接使用其中一个，不再使用笼统的Field来直接创建域。

Direct Known Subclasses:

BinaryDocValuesField, DoubleField, FloatField,
IntField, LongField, NumericDocValuesField, SortedDocValuesField, SortedSetDocValuesField, StoredField, StringField,
TextField
例如，对于上述三个Filed，可相应的改为：

[java]  view plain copy

<pre name=
"code"
 
class

"java"

Field field = 

new
 StringField(
"path"
, filetoIndex.getPath(),Field.Store.YES);  
1.
Field field = 
new
 LongField(
"modified"
, filetoIndex.lastModified(),Field.Store.NO);  
1.
Field field = 
new
 TextField(
"contents"
, 
new
 FileReader(filetoIndex));  
在4.x以后，StringField即为NOT_ANALYZED的（即不对域的内容进行分割分析），而textField是ANALYZED的，因此，创建Field对象时，无需再指定此属性。见http://stackoverflow.com/questions/19042587/how-to-prevent-a-field-from-not-analyzing-in-lucene

即每一个Field的子类均具有默认的是否INDEXED与ANALYZED属性，不再需要显式指定。

官方文档：

StringField: 
A field that is indexed but not tokenized: the entire String value is indexed as a single token. For example this might be used for a 'country' field or an 'id' field, or any field that you intend to use for sorting or access through the field cache

TextField: 
A field that is indexed and tokenized,without term vectors. For example this would be used on a 'body' field, that contains the bulk of a document's text.

（二）有关于Field的一些选项

1、Field.Store.Yes/No

在创建一个Field的时候，需要传入一个参数，用于指定内容是否需要存储到索引中。这些被存储的内容可以在搜索结果中返回，呈现给用户。

二者最直观的差异在于：使用document.get("fileName")时，是否可以返回内容。

比如，一个文件的标题通常都是Field.Store.Yes，因为其内容一般需要呈现给用户，文件的作者、摘要等信息也一样。

但一个文件的内容可能就没必要保存了，一方面是文件内容太大，另一方面是没必要在索引中保存其信息，因为可以引导用户进入原有文件即可。

2、加权

可以对Filed及Document进行加权。注意加权是影响返回结果顺序的一个因素，但也仅仅是一个因素，它和其它因素一起构成了Lucene的排序算法。

（三）对富文本（非纯文本）的索引

上述的对正文的索引语句：

[java]  view plain copy

Field field = 
new
 TextField(
"contents"
, 
new
 FileReader(filetoIndex));  
只对纯文本有效。对于word，excel，pdf等富文本，FileReader读取到的内容只是一些乱码，并不能形成有效的索引。

若需要对此类文本进行索引，需要使用Tika等工具先将其正文内容提取出来，然后再进行索引。
http://stackoverflow.com/questions/16640292/lucene-4-2-0-index-pdf

Lucene doesn't handle files at all, really. That demo handles plain text files, but core Lucene doesn't. FileStreamReader is a Java standard stream reader, and for your purposes, it will only handle plain text. This works on the Unix philosophy. Lucene indexes content. Tika extracts content from rich documents. I've added links to a couple of examples using Tika, one with Lucene directly, the other using Solr (which you might want to consider as well). 

一个简单示例如下：

首先使用Tika提取word中的正文，再使用TextField索引文字。

[java]  view plain copy

doc.add(
new
 TextField(
"contents"
, TikaBasicUtil.extractContent(filetoIndex),Field.Store.NO));  
注意此处不能使用StringField，因为StringField限制了字符串的大小不能超过32766，否则会报异常IllegalArgumentException:
Document contains at least one immense term in field="contents" (whose UTF8 encoding is longer than the max length 32766)*/

使用Tika索引富文本的简单示例如下：

注意，此示例不仅可以索引word，还可以索引pdf,excel等。

[java]  view plain copy

package
 org.jediael.util;  
1.
  
1.
import
 java.io.File;  
1.
import
 java.io.FileInputStream;  
1.
import
 java.io.FileNotFoundException;  
1.
import
 java.io.IOException;  
1.
import
 java.io.InputStream;  
1.
  
1.
import
 org.apache.tika.exception.TikaException;  
1.
import
 org.apache.tika.metadata.Metadata;  
1.
import
 org.apache.tika.parser.AutoDetectParser;  
1.
import
 org.apache.tika.parser.ParseContext;  
1.
import
 org.apache.tika.parser.Parser;  
1.
import
 org.apache.tika.sax.BodyContentHandler;  
1.
import
 org.xml.sax.ContentHandler;  
1.
import
 org.xml.sax.SAXException;  
1.
  
1.
public
 
class
 TikaBasicUtil {  
1.
      
1.
    
public
 
static
 String extractContent(File f) {  
1.
        
//1、创建一个parser
  
1.
        Parser parser = 
new
 AutoDetectParser();  
1.
        InputStream is = 
null
;  
1.
        
try
 {  
1.
            Metadata metadata = 
new
 Metadata();  
1.
            metadata.set(Metadata.RESOURCE_NAME_KEY, f.getName());  
1.
            is = 
new
 FileInputStream(f);  
1.
            ContentHandler handler = 
new
 BodyContentHandler();  
1.
            ParseContext context = 
new
 ParseContext();  
1.
            context.set(Parser.
class
,parser);  
1.
              
1.
            
//2、执行parser的parse()方法。
  
1.
            parser.parse(is,handler, metadata,context);  
1.
                  
1.
            String returnString = handler.toString();  
1.
              
1.
            System.out.println(returnString.length());  
1.
            
return
 returnString;  
1.
        } 
catch
 (FileNotFoundException e) {  
1.
            e.printStackTrace();  
1.
        } 
catch
 (IOException e) {  
1.
            e.printStackTrace();  
1.
        } 
catch
 (SAXException e) {  
1.
            e.printStackTrace();  
1.
        } 
catch
 (TikaException e) {  
1.
            e.printStackTrace();  
1.
        }
finally
 {  
1.
            
try
 {  
1.
                
if
(is!=
null
) is.close();  
1.
            } 
catch
 (IOException e) {  
1.
                e.printStackTrace();  
1.
            }  
1.
        }  
1.
        
return
 
"No Contents"
;  
1.
    }  
1.
}  

三、关于Document

FSDocument RAMDocument

四、关于IndexWriter

1、创建一个IndexWriter

[java]  view plain copy

Directory returnIndexDir = FSDirectory.open(indexDir);  
1.
IndexWriterConfig iwc = 
new
 IndexWriterConfig(Version.LUCENE_48,
new
 StandardAnalyzer(Version.LUCENE_48));  
1.
iwc.setOpenMode(IndexWriterConfig.OpenMode.CREATE);  
1.
writer = 
new
 IndexWriter(returnIndexDir, iwc);  
1.
System.out.println(writer.getConfig().getOpenMode()+
""
);  
1.
System.out.println(iwc.getOpenMode());  
创建一个IndexWriter时，需要2个参数，一个是Directory对象，用于指定所创建的索引写到哪个地方；另一个是IndexWriterConfig对象，用于指定writer的配置。

2、IndexWriterConfig

（1）继承关系

• java.lang.Object

• • org.apache.lucene.index.LiveIndexWriterConfig

    • • org.apache.lucene.index.IndexWriterConfig

All Implemented Interfaces:
Cloneable
（2）
Holds
 all the configuration that is used to create an IndexWriter
. Once  IndexWriter
 has been created with this object, changes to this object will not affect the  IndexWriter
instance.
（3）IndexWriterConfig.OpenMode：指明了打开索引目录的方式，有以下三种：
APPEND:Opens an existing index. 若原来存在索引，则将本次索引的内容追加进来。不管文档是否与原来是否重复，因此若2次索引的文档相同，则返回结果数则为原来的2倍。
CREATE:Creates a new index or overwrites an existing one. 若原来存在索引，则先将其删除，再创建新的索引
CREATE_OR_APPEND【默认值】:Creates a new index if one does not exist, otherwise it opens the index and documents will be appended.

3、索引的优化

索引过程中，会将索引结果存放至多个索引文件中，这样会回收索引的效率，但在搜索时，需要将多个索引文件中的返回结果进行合并处理，因此效率较低。

为了加快搜索结果的返回，可以将索引进行优化。

[java]  view plain copy

writer.addDocument(doc);  
1.
writer.forceMerge(
2
);  
索引的优化是将索引结果文件归为一个或者有限的多个，它加大的索引过程中的消耗，减少了搜索时的消耗。

五、关于Analyzer

此处主要关于和索引期间相关的analyzer，关于analyzer更详细的内容请参见 http://blog.csdn.net/jediael_lu/article/details/33303499   【Lucene4.8教程之四】分析

在创建IndexWriter时，需要指定分析器，如：

[java]  view plain copy

IndexWriterConfig iwc = 
new
 IndexWriterConfig(Version.LUCENE_48,
new
 StandardAnalyzer(Version.LUCENE_48));  
1.
writer = 
new
 IndexWriter(IndexDir, iwc);  

便在每次向writer中添加文档时，可以针对该文档指定一个分析器，如

[java]  view plain copy

writer.addDocument(doc, 
new
 SimpleAnalyzer(Version.LUCENE_48));  

六、关于Directory