lucene3.0_IndexSearcher的基础使用及注意事项

较之lucene2.4版本，lucene3.0在indexSearcher这块变动比较大，从api可以直观的了解到。

基类Searcher与搜索有关的方法：

`void`	`search(Query query, Collector results)` Lower-level search API.
`void`	`search(Query query, Filter filter, Collector results)` Lower-level search API.
`TopDocs`	`search(Query query, Filter filter, int n)` Finds the top `n` hits for `query`, applying `filter` if non-null.
`TopFieldDocs`	`search(Query query, Filter filter, int n, Sort sort)` Search implementation with arbitrary sorting.
`TopDocs`	`search(Query query, int n)` Finds the top `n` hits for `query`.
`abstract void`	`search(Weight weight, Filter filter, Collector results)` Lower-level search API.
`abstract TopDocs`	`search(Weight weight, Filter filter, int n)` Expert: Low-level search implementation.
`abstract TopFieldDocs`	`search(Weight weight, Filter filter, int n, Sort sort)` Expert: Low-level search implementation with arbitrary sorting.

该文将讲解上表格中黄色高亮的3个方法：

1.search(Query query , int n)

2.search(Query query , Collector results)

3.search(Query query , Filter filter , int n , Sort sort)

--------------------------------------------------------------------------------

1.search(Query query , int n)示例

取出前n条目标结果。

 
     
   
 
    public 
    void 
     searcher(String queryString){
 
    try 
     {
FSDirectory dir  
    = 
     SimpleFSDirectory.open( 
    new 
     File( 
    " 
    d:/20101015index 
    " 
    ));
 
    // 
    注意点1:创建IndexSearcher实例是传入IndexReader实例还是Directory实例呢？ 
    
 
    IndexReader reader  
    = 
     IndexReader.open(dir);
IndexSearcher searcher  
    = 
    new 
     IndexSearcher(reader);
 
    // 
    使用：search(Query query, int n)  
    
 
    QueryParser parser  
    = 
    new 
     QueryParser(Version.LUCENE_30,  
    " 
    f1 
    " 
    ,  
    new 
     StandardAnalyzer(Version.LUCENE_30));
Query query  
    = 
     parser.parse(queryString);
TopDocs tds  
    = 
     searcher.search(query,  
    5 
    );
ScoreDoc[] sd  
    = 
     tds.scoreDocs;
 
    for 
     ( 
    int 
     i  
    = 
    0 
    ; i  
    < 
     sd.length; i 
    ++ 
    ) {
System.out.println(reader.document(sd[i].doc));
 
    // 
    注意点2：怎么查看每个文档的打分的详情。
 
    // 
    explain(Weight weight, int doc) 
 
    // 
    Expert: low-level implementation method Returns an Explanation that describes how doc scored against weight. 
    
 
    System.out.println( 
    " 
    Explanation: 
    " 
    + 
     (searcher.explain(query, sd[i].doc)));
}
}  
    catch 
     (IOException e) {
e.printStackTrace();
}  
    catch 
     (ParseException e) {
e.printStackTrace();
} 
} 
   
 
     
   

注意点：

1.创建IndexSearcher实例是传入IndexReader实例还是Directory实例呢？

详情请参见:

lucene问题_IndexSearcher初始化，IndexSearcher(Directory dir)和IndexSearcher(IndexReader reader)有什么区别？到底使用那个更合理？

2.查看每个目标文档的打分的详细情况。

在网上看到有朋友问到这个，故在此提出来。

3.真实的项目请不要像上面代码那样——将indexReader和IndexSearcher的实例在搜索方法中创建，为了节约系统开销、提高效率，

应该将这些实例作为单例模式。

这里做了反面教材了 = =！

2.search(Query query , Collector results)

在介绍这个方法之前，先来了解下Collector：

Collectors are primarily meant to be used to gather raw results from a search, and implement sorting or custom result filtering, collation, etc.

先重点了解：

TopScoreDocCollector is a concrete subclass TopDocsCollector and sorts according to score + docID.

This is used internally by the IndexSearcher search methods that do not take an explicitSort. It is likely the most frequently used collector.

他是最常用的collector子类，是默认相关度排序的。下面给出一个实例，使用TopScoreDocCollector进行结果的收集，并提供简单的分页功能。

 
     
   
 
    public 
    void 
     searcher(String queryString , 
    int 
     start,  
    int 
     howMany){
 
    try 
     {
FSDirectory dir  
    = 
     SimpleFSDirectory.open( 
    new 
     File( 
    " 
    d:/20101015index 
    " 
    ));
 
    // 
    注意点1:创建IndexSearcher实例是传入IndexReader实例还是Directory实例呢？ 
    
 
    IndexReader reader  
    = 
     IndexReader.open(dir);
IndexSearcher searcher  
    = 
    new 
     IndexSearcher(reader);
 
    // 
    使用：search(Query query , Collector results) 
    
 
    QueryParser parser  
    = 
    new 
     QueryParser(Version.LUCENE_30,  
    " 
    f1 
    " 
    ,  
    new 
     StandardAnalyzer(Version.LUCENE_30));
Query query  
    = 
     parser.parse(queryString);
 
    int 
     hm  
    = 
     start 
    + 
    howMany ;
TopScoreDocCollector res  
    = TopScoreDocCollector.create(hm, false 
    );
System.out.println( 
    " 
    total hits : 
    " 
    + 
    res.getTotalHits());
searcher.search(query, res);
 
    // 
    注意点2:这里可以控制分页。 
    
 
    TopDocs tds = 
     res.topDocs(start, howMany);
ScoreDoc[] sd  
    = 
     tds.scoreDocs;
 
    for 
     ( 
    int 
     i  
    = 
    0 
    ; i  
    < 
     sd.length; i 
    ++ 
    ) {
System.out.println(reader.document(sd[i].doc));
 
    // 
     System.out.println("Explanation:" + (searcher.explain(query, sd[i].doc))); 
    
 
    }
}  
    catch 
     (IOException e) {
e.printStackTrace();
}  
    catch 
     (ParseException e) {
e.printStackTrace();
} 
} 
   
 
     
   

3.search(Query query , Filter filter , int n , Sort sort)

这种方式的排序很简单，直接给出实例代码，注意的问题其他文章有详细说明。

     按 Ctrl+C 复制代码 
   
     按 Ctrl+C 复制代码

注意点：

lucene问题_检索结果怎么排序？对于不同类型（例如int型）的字段排序有什么区别吗？

lucene问题_怎么对多个字段进行排序？

---------------------------------------------------------

对于lucene3.0检索的基础使用就先介绍这些了，关于搜索应该重点关注：

1.collector的选用

2.分页，及分页效率问题

3.排序，及排序的效率问题

4.多索引搜索

5.实际项目中实时搜索和效率的保障

分类: 92-搜索引擎_lucene

lucene3.0_IndexSearcher的基础使用及注意事项

猜你喜欢