TermRangeQuery是在使用的范围内的文本的词条都被搜索。
类声明
以下是org.apache.lucene.search.TermRangeQuery类的声明：
public class TermRangeQuery extends MultiTermQuery
类的构造函数
| S.N. | 构造函数和说明 |
|---|---|
| 1 |
TermRangeQuery(String field, String lowerTerm, String upperTerm, boolean includeLower, boolean includeUpper) 构造一个查询选择的所有条款大于/等于比lowerTerm，但小于/等于比upperTerm。 |
| 2 |
TermRangeQuery(String field, String lowerTerm, String upperTerm, boolean includeLower, boolean includeUpper, Collator collator) 构造一个查询选择的所有条款大于/等于比lowerTerm，但小于/等于比upperTerm。 |
类方法
| S.N. | 方法及说明 |
|---|---|
| 1 | boolean equals(Object obj) |
| 2 |
Collator getCollator() 返回用于确定范围包括比较装置，如果有的话。 |
| 3 |
protected FilteredTermEnum getEnum(IndexReader reader) 构造所使用的枚举，扩大模式的词条。 |
| 4 |
String getField() 此查询返回字段名称。 |
| 5 |
String getLowerTerm() 返回此范围查询的较低值。 |
| 6 |
String getUpperTerm() 返回此范围查询的上限值。 |
| 7 | int hashCode() |
| 8 |
boolean includesLower() 返回true，如果下端点已包括。 |
| 9 |
boolean includesUpper() 返回true，如果上端点已包括。 |
| 10 |
String toString(String field) 打印这个查询的一个用户可读的版本。 |
继承的方法
这个类继承了以下类方法：
-
org.apache.lucene.search.MultiTermQuery
-
org.apache.lucene.search.Query
-
java.lang.Object
使用
private void searchUsingTermRangeQuery(String searchQueryMin, String searchQueryMax)throws IOException, ParseException{ searcher = new Searcher(indexDir); long startTime = System.currentTimeMillis(); //create the term query object Query query = new TermRangeQuery(LuceneConstants.FILE_NAME, searchQueryMin,searchQueryMax,true,false); //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(); }
应用程序示例
让我们创建一个测试Lucene的应用程序中使用TermRangeQuery测试搜索。
| 步骤 | 描述 |
|---|---|
| 1 | 创建名称为LuceneFirstApplication的项目在packagecom.yiibai.lucene下的Lucene用于解释 Lucene应用程序理解搜索过程。 |
| 2 | 创建LuceneConstants.java和Searcher.java作为Lucene的解释- 第一应用程序一章。保持其它文件不变。 |
| 3 | 创建LuceneTester.java如下所述。 |
| 4 | 清理和构建应用程序，以确保业务逻辑按要求工作。 |
LuceneConstants.java
这个类是用来提供可应用于示例应用程序中使用的各种常量。
package com.yiibai.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.yiibai.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.yiibai.lucene; import java.io.IOException; import org.apache.lucene.document.Document; import org.apache.lucene.queryParser.ParseException; import org.apache.lucene.search.Query; import org.apache.lucene.search.ScoreDoc; import org.apache.lucene.search.TermRangeQuery; 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.searchUsingTermRangeQuery("record2.txt","record6.txt"); } catch (IOException e) { e.printStackTrace(); } catch (ParseException e) { e.printStackTrace(); } } private void searchUsingTermRangeQuery(String searchQueryMin, String searchQueryMax)throws IOException, ParseException{ searcher = new Searcher(indexDir); long startTime = System.currentTimeMillis(); //create the term query object Query query = new TermRangeQuery(LuceneConstants.FILE_NAME, searchQueryMin,searchQueryMax,true,false); //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 的文件中包含简单的名称以及学生的其他细节，并把它们放在目录E:LuceneData。这是测试数据。索引目录路径应创建为E:LuceneIndex。期间，运行 Lucene索引程序后- 索引过程中，可以看到该文件夹中创建的索引文件的列表。
运行程序：
一旦创建源，创造了原始数据，数据目录，索引目录和索引完成后，已经准备好这一步是编译和运行程序。要做到这一点，请LuceneTester.Java文件选项卡中使用Eclipse IDE可使用Run选项，或使用Ctrl+ F11来编译和运行应用程序LuceneTester。如果您的应用程序一切正常，这将在Eclipse IDE的控制台打印以下消息：
4 documents found. Time :17ms File: E:LuceneData ecord2.txt File: E:LuceneData ecord3.txt File: E:LuceneData ecord4.txt File: E:LuceneData ecord5.txt
