- 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