- Lucene 教程
- Lucene - 首页
- Lucene - 概述
- Lucene - 环境搭建
- Lucene - 第一个应用程序
- Lucene - 索引类
- Lucene - 搜索类
- Lucene - 索引过程
- Lucene - 索引操作
- Lucene - 搜索操作
- Lucene - 查询编程
- Lucene - 分析
- Lucene - 排序
- Lucene 有用资源
- Lucene - 快速指南
- Lucene - 有用资源
- Lucene - 讨论
Lucene - TermQuery
TermQuery 是最常用的查询对象,也是 Lucene 可以使用的许多复杂查询的基础。它用于根据区分大小写的键检索文档。
类声明
以下是org.apache.lucene.search.TermQuery类的声明:
public class TermQuery extends Query
类构造函数
下表显示了一个类构造函数:
| 序号 | 构造函数及说明 |
|---|---|
| 1 | TermQuery(Term t) 为项t构造一个查询。 |
类方法
下表显示了不同的类方法:
| 序号 | 方法及说明 |
|---|---|
| 1 | void addDocument(Document doc) 向此索引添加文档。 |
| 2 | Weight createWeight(Searcher searcher) 专家:为此查询构造合适的 Weight 实现。 |
| 3 | boolean equals(Object o) 如果对象o等于此对象,则返回true。 |
| 4 | void extractTerms(Set<Term> terms) 专家:将此查询中出现的所有术语添加到术语集中。 |
| 5 | Term getTerm() 返回此查询的术语。 |
| 6 | int hashCode() 返回此对象的哈希码值。 |
| 7 | String toString(String field) 打印此查询的用户可读版本。 |
继承的方法
此类继承自以下类的方法:
- org.apache.lucene.search.Query
- java.lang.Object
用法
private void searchUsingTermQuery(
String searchQuery)throws IOException, ParseException {
searcher = new Searcher(indexDir);
long startTime = System.currentTimeMillis();
//create a term to search file name
Term term = new Term(LuceneConstants.FILE_NAME, searchQuery);
//create the term query object
Query query = new TermQuery(term);
//do the search
TopDocs hits = searcher.search(query);
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();
}
示例应用程序
要测试使用 TermQuery 的搜索,让我们创建一个测试 Lucene 应用程序。
| 步骤 | 描述 |
|---|---|
| 1 | 创建一个名为LuceneFirstApplication的项目,放在packagecom.tutorialspoint.lucene下,如Lucene - 第一个应用程序章节所述。您也可以使用Lucene - 第一个应用程序章节中创建的项目,以便理解搜索过程。 |
| 2 | 创建LuceneConstants.java和Searcher.java,如Lucene - 第一个应用程序章节所述。保持其余文件不变。 |
| 3 | 创建如下所示的LuceneTester.java。 |
| 4 | 清理并构建应用程序,以确保业务逻辑按要求工作。 |
LuceneConstants.java
此类用于提供可在示例应用程序中使用的各种常量。
package com.tutorialspoint.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;
}
Searcher.java
此类用于读取对原始数据创建的索引,并使用 Lucene 库搜索数据。
package com.tutorialspoint.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 TopDocs search(Query query) throws IOException, ParseException {
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 com.tutorialspoint.lucene;
import java.io.IOException;
import org.apache.lucene.document.Document;
import org.apache.lucene.index.Term;
import org.apache.lucene.queryParser.ParseException;
import org.apache.lucene.search.Query;
import org.apache.lucene.search.ScoreDoc;
import org.apache.lucene.search.TermQuery;
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.searchUsingTermQuery("record4.txt");
} catch (IOException e) {
e.printStackTrace();
} catch (ParseException e) {
e.printStackTrace();
}
}
private void searchUsingTermQuery(
String searchQuery)throws IOException, ParseException {
searcher = new Searcher(indexDir);
long startTime = System.currentTimeMillis();
//create a term to search file name
Term term = new Term(LuceneConstants.FILE_NAME, searchQuery);
//create the term query object
Query query = new TermQuery(term);
//do the search
TopDocs hits = searcher.search(query);
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();
}
}
数据和索引目录创建
我使用了从 record1.txt 到 record10.txt 的 10 个文本文件,其中包含学生姓名和其他详细信息,并将它们放在E:\Lucene\Data目录中。测试数据。应创建索引目录路径为E:\Lucene\Index。在Lucene - 索引过程章节中运行索引程序后,您可以在该文件夹中看到创建的索引文件列表。
运行程序
完成源代码、原始数据、数据目录、索引目录和索引的创建后,您可以通过编译和运行程序继续操作。为此,请保持LuceneTester.Java文件选项卡处于活动状态,并使用 Eclipse IDE 中提供的“运行”选项,或者使用Ctrl + F11来编译和运行您的LuceneTester应用程序。如果您的应用程序成功运行,它将在 Eclipse IDE 的控制台中打印以下消息:
1 documents found. Time :13 ms File: E:\Lucene\Data\record4.txt