搜索操作(Search Operation)
搜索过程是Lucene提供的核心功能之一。 下图说明了该过程及其用途。 IndexSearcher是搜索过程的核心组件之一。
我们首先创建包含indexes ,然后将其传递给IndexSearcher ,后者使用IndexReader打开Directory 。 然后我们使用Term创建一个Query ,并通过将Query传递给搜索器来使用IndexSearcher进行搜索。 IndexSearcher返回一个TopDocs对象,该对象包含搜索详细信息以及作为搜索操作结果的Document文档ID。
我们现在将向您展示一种逐步的方法,并使用一个基本示例帮助您理解索引过程。
创建QueryParser
QueryParser类将用户输入的输入解析为Lucene可理解的格式查询。 请按照以下步骤创建QueryParser -
Step 1 - 创建QueryParser的对象。
Step 2 - 初始化使用标准分析器创建的QueryParser对象,该分析器具有要在其上运行此查询的版本信息和索引名称。
QueryParser queryParser;
public Searcher(String indexDirectoryPath) throws IOException {
queryParser = new QueryParser(Version.LUCENE_36,
LuceneConstants.CONTENTS,
new StandardAnalyzer(Version.LUCENE_36));
}
创建一个IndexSearcher
IndexSearcher类充当索引过程中创建的搜索器索引的核心组件。 请按照以下步骤创建IndexSearcher -
Step 1 - 创建IndexSearcher的对象。
Step 2 - 创建一个Lucene目录,该目录应指向要存储索引的位置。
Step 3 - 初始化使用索引目录创建的IndexSearcher对象。
IndexSearcher indexSearcher;
public Searcher(String indexDirectoryPath) throws IOException {
Directory indexDirectory =
FSDirectory.open(new File(indexDirectoryPath));
indexSearcher = new IndexSearcher(indexDirectory);
}
进行搜索
按照以下步骤进行搜索 -
Step 1 - 通过QueryParser解析搜索表达式来创建Query对象。
Step 2 - 通过调用IndexSearcher.search()方法进行搜索。
Query query;
public TopDocs search( String searchQuery) throws IOException, ParseException {
query = queryParser.parse(searchQuery);
return indexSearcher.search(query, LuceneConstants.MAX_SEARCH);
}
获取文档
以下程序显示了如何获取文档。
public Document getDocument(ScoreDoc scoreDoc)
throws CorruptIndexException, IOException {
return indexSearcher.doc(scoreDoc.doc);
}
关闭IndexSearcher
以下程序显示如何关闭IndexSearcher。
public void close() throws IOException {
indexSearcher.close();
}
例子 Example Application
让我们创建一个测试Lucene应用程序来测试搜索过程。
步 | 描述 |
---|---|
1 | 在Lucene - First Application章节中解释,在cn.xnip.lucene包下创建一个名为LuceneFirstApplication的项目。 您还可以使用Lucene - First Application创建的项目Lucene - First Application本章的Lucene - First Application章节来理解搜索过程。 |
2 | 按照Lucene - First Application章节中的说明创建LuceneConstants.java,TextFileFilter.java和Searcher.java 。 保持其余文件不变。 |
3 | 创建LuceneTester.java ,如下所述。 |
4 | 清理并构建应用程序以确保业务逻辑按照要求运行。 |
LuceneConstants.java
此类用于提供跨示例应用程序使用的各种常量。
package cn.xnip.lucene;
public class LuceneConstants {
public static final String CONTENTS = "contents";
public static final String FILE_NAME = "filename";
public static final String FILE_PATH = "filepath";
public static final int MAX_SEARCH = 10;
}
TextFileFilter.java
此类用作.txt文件筛选器。
package cn.xnip.lucene;
import java.io.File;
import java.io.FileFilter;
public class TextFileFilter implements FileFilter {
@Override
public boolean accept(File pathname) {
return pathname.getName().toLowerCase().endsWith(".txt");
}
}
Searcher.java
此类用于读取对原始数据所做的索引,并使用Lucene库搜索数据。
package cn.xnip.lucene;
import java.io.File;
import java.io.IOException;
import org.apache.lucene.analysis.standard.StandardAnalyzer;
import org.apache.lucene.document.Document;
import org.apache.lucene.index.CorruptIndexException;
import org.apache.lucene.queryParser.ParseException;
import org.apache.lucene.queryParser.QueryParser;
import org.apache.lucene.search.IndexSearcher;
import org.apache.lucene.search.Query;
import org.apache.lucene.search.ScoreDoc;
import org.apache.lucene.search.TopDocs;
import org.apache.lucene.store.Directory;
import org.apache.lucene.store.FSDirectory;
import org.apache.lucene.util.Version;
public class Searcher {
IndexSearcher indexSearcher;
QueryParser queryParser;
Query query;
public Searcher(String indexDirectoryPath) throws IOException {
Directory indexDirectory =
FSDirectory.open(new File(indexDirectoryPath));
indexSearcher = new IndexSearcher(indexDirectory);
queryParser = new QueryParser(Version.LUCENE_36,
LuceneConstants.CONTENTS,
new StandardAnalyzer(Version.LUCENE_36));
}
public TopDocs search( String searchQuery)
throws IOException, ParseException {
query = queryParser.parse(searchQuery);
return indexSearcher.search(query, LuceneConstants.MAX_SEARCH);
}
public Document getDocument(ScoreDoc scoreDoc)
throws CorruptIndexException, IOException {
return indexSearcher.doc(scoreDoc.doc);
}
public void close() throws IOException {
indexSearcher.close();
}
}
LuceneTester.java
该类用于测试Lucene库的搜索功能。
package cn.xnip.lucene;
import java.io.IOException;
import org.apache.lucene.document.Document;
import org.apache.lucene.queryParser.ParseException;
import org.apache.lucene.search.ScoreDoc;
import org.apache.lucene.search.TopDocs;
public class LuceneTester {
String indexDir = "E:\\Lucene\\Index";
String dataDir = "E:\\Lucene\\Data";
Searcher searcher;
public static void main(String[] args) {
LuceneTester tester;
try {
tester = new LuceneTester();
tester.search("Mohan");
} catch (IOException e) {
e.printStackTrace();
} catch (ParseException e) {
e.printStackTrace();
}
}
private void search(String searchQuery) throws IOException, ParseException {
searcher = new Searcher(indexDir);
long startTime = System.currentTimeMillis();
TopDocs hits = searcher.search(searchQuery);
long endTime = System.currentTimeMillis();
System.out.println(hits.totalHits +
" documents found. Time :" + (endTime - startTime) +" ms");
for(ScoreDoc scoreDoc : hits.scoreDocs) {
Document doc = searcher.getDocument(scoreDoc);
System.out.println("File: "+ doc.get(LuceneConstants.FILE_PATH));
}
searcher.close();
}
}
数据和索引目录创建
我们使用10个名为record1.txt的文本文件来记录包含学生姓名和其他详细信息的record10.txt,并将它们放在目录E:\Lucene\Data中。。 索引目录路径应创建为E:\Lucene\Index。 在Lucene - Indexing Process一章中运行索引程序后,您可以看到在该文件夹中创建的索引文件列表。
运行程序 (Running the Program)
完成源,原始数据,数据目录,索引目录和索引的创建后,可以继续编译和运行程序。 为此,请保持LuceneTester.Java文件选项卡处于活动状态,并使用Eclipse IDE中提供的“运行”选项或使用Ctrl + F11编译并运行LuceneTesterapplication 。 如果您的应用程序成功运行,它将在Eclipse IDE的控制台中打印以下消息 -
1 documents found. Time :29 ms
File: E:\Lucene\Data\record4.txt