您的位置: 首页  >  文章  >  Lucene5学习之TermRangeQuery使用

Lucene5学习之TermRangeQuery使用

分类: 文章 • 2023-03-10 10:53:28

    TermRangeQuery是用于字符串范围查询的，既然涉及到范围必然需要字符串比较大小，字符串比较大小其实比较的是ASC码值，即ASC码范围查询。一般对于英文来说，进行ASC码范围查询还有那么一点意义，中文汉字进行ASC码值比较没什么太大意义，所以这个TermRangeQuery了解就行，用途不太大，一般数字范围查询NumericRangeQuery用的比较多一点，比如价格，年龄，金额，数量等等都涉及到数字，数字范围查询需求也很普遍。

    我们来看看官方API里是怎么解释这个Query的：


Lucene5学习之TermRangeQuery使用
 意思就是这个Query通过一个范围内的Term来匹配索引文档，这个Query通过一组Term来查找索引文档，哪些Term呢？that后面是解释根据比较byte值落入提供的范围内的Term.但这个Query不适用于数字范围查询，数字范围查询请使用NumericRangeQuery代替。

    下面是TermRangeQuery的使用示例：

    

Java代码  Lucene5学习之TermRangeQuery使用
  1. package com.yida.framework.lucene5.query;  
  2.   
  3. import java.io.IOException;  
  4. import java.nio.file.Paths;  
  5. import java.util.ArrayList;  
  6. import java.util.List;  
  7.   
  8. import org.apache.lucene.document.Document;  
  9. import org.apache.lucene.index.DirectoryReader;  
  10. import org.apache.lucene.index.IndexReader;  
  11. import org.apache.lucene.queryparser.classic.ParseException;  
  12. import org.apache.lucene.search.IndexSearcher;  
  13. import org.apache.lucene.search.Query;  
  14. import org.apache.lucene.search.ScoreDoc;  
  15. import org.apache.lucene.search.TermRangeQuery;  
  16. import org.apache.lucene.search.TopDocs;  
  17. import org.apache.lucene.store.FSDirectory;  
  18. import org.apache.lucene.util.BytesRef;  
  19.   
  20. public class TermRangeQueryTest {  
  21.     public static void main(String[] args) throws ParseException, IOException {  
  22.         //参数定义  
  23.         String directoryPath = "D:/lucenedir";  
  24.         String fieldName = "contents";  
  25.         String lowerTermString = "fa";  
  26.         String upperTermString = "fi";  
  27.   
  28.           
  29.         Query query = new TermRangeQuery(fieldName,   
  30.             new BytesRef(lowerTermString),   
  31.             new BytesRef(upperTermString), false, false);  
  32.         List<Document> list = query(directoryPath,query);  
  33.         if(list == null || list.size() == 0) {  
  34.             System.out.println("No results found.");  
  35.             return;  
  36.         }  
  37.         for(Document doc : list) {  
  38.             String path = doc.get("path");  
  39.             String content = doc.get("contents");  
  40.             System.out.println("path:" + path);  
  41.             //System.out.println("contents:" + content);  
  42.         }  
  43.     }  
  44.     /** 
  45.      * 创建索引阅读器 
  46.      * @param directoryPath  索引目录 
  47.      * @return 
  48.      * @throws IOException   可能会抛出IO异常 
  49.      */  
  50.     public static IndexReader createIndexReader(String directoryPath) throws IOException {  
  51.         return DirectoryReader.open(FSDirectory.open(Paths.get(directoryPath, new String[0])));  
  52.     }  
  53.       
  54.     /** 
  55.      * 创建索引查询器 
  56.      * @param directoryPath   索引目录 
  57.      * @return 
  58.      * @throws IOException 
  59.      */  
  60.     public static IndexSearcher createIndexSearcher(String directoryPath) throws IOException {  
  61.         return new IndexSearcher(createIndexReader(directoryPath));  
  62.     }  
  63.       
  64.     /** 
  65.      * 创建索引查询器 
  66.      * @param reader 
  67.      * @return 
  68.      */  
  69.     public static IndexSearcher createIndexSearcher(IndexReader reader) {  
  70.         return new IndexSearcher(reader);  
  71.     }  
  72.       
  73.     public static List<Document> query(String directoryPath,Query query) throws IOException {  
  74.         IndexSearcher searcher = createIndexSearcher(directoryPath);  
  75.         TopDocs topDocs = searcher.search(query, Integer.MAX_VALUE);  
  76.         List<Document> docList = new ArrayList<Document>();  
  77.         ScoreDoc[] docs = topDocs.scoreDocs;  
  78.         for (ScoreDoc scoreDoc : docs) {  
  79.             int docID = scoreDoc.doc;  
  80.             Document document = searcher.doc(docID);  
  81.             docList.add(document);  
  82.         }  
  83.         searcher.getIndexReader().close();  
  84.         return docList;  
  85.     }  
  86. }  

    TermRangeQuery构造函数如下：

   

Java代码  Lucene5学习之TermRangeQuery使用
  1. TermRangeQuery(String field, BytesRef lowerTerm, BytesRef upperTerm, boolean includeLower, boolean includeUpper)   

   BytesRef创建很简单，直接new BytesRef(string)传入一个字符串即可， TermRangeQuery还提供了一个静态方法来构建TermRangeQuery实例：

    

Java代码  Lucene5学习之TermRangeQuery使用
  1. /** 
  2.    * Factory that creates a new TermRangeQuery using Strings for term text. 
  3.    */  
  4.   public static TermRangeQuery newStringRange(String field, String lowerTerm, String upperTerm, boolean includeLower, boolean includeUpper) {  
  5.     BytesRef lower = lowerTerm == null ? null : new BytesRef(lowerTerm);  
  6.     BytesRef upper = upperTerm == null ? null : new BytesRef(upperTerm);  
  7.     return new TermRangeQuery(field, lower, upper, includeLower, includeUpper);  
  8.   }  

 其实就是在方法内部帮我们new BytesRef()了，这样接口参数里面对用户的只有用户熟悉的String类型了而没有BytesRef类型了，毕竟用户对BytesRef不是很熟悉，会导致用户在使用API时会有些障碍，所以提供了newStringRange这么一个静态方法，当然如果你自己知道怎么使用默认的构造函数，直接使用构造函数new也可以，只是给用户多了一种选择。

     TermRangeQuery就介绍这么多了，打完收工！

 

      如果你还有什么问题请加我Ｑ-Q：7-3-6-0-3-1-3-0-5，

或者加裙
Lucene5学习之TermRangeQuery使用一起交流学习！

转载：http://iamyida.iteye.com/blog/2194705

相关推荐