solr4.7开发实践 2——高亮显示

1. 第一种方式是solrj操做：

 
public SolrDocumentList query(String str) {
    SolrQuery query = new SolrQuery(str);
    
    query.setHighlight(true);//开启高亮功能  

    query.addHighlightField("name,content");//高亮字段  :多个域能够用空格或者逗号分隔
    query.setHighlightSimplePre("<font color=red >");//渲染标签  
    query.setHighlightSimplePost("</font>");//渲染标签  
    query.setParam("f.content.hl.fragsize", "200");

    
    QueryResponse qr=server.query(query);//执行查询  
    SolrDocumentList dlist=qr.getResults();  
    
    System.out.println("总数："+dlist.getNumFound());
    //第一个Map的键是文档的ID，第二个Map的键是高亮显示的字段名    
    Map<String, Map<String, List<String>>> map = qr.getHighlighting();    
    for(int i=0;i<dlist.size();i++){  
     SolrDocument d=dlist.get(i);//获取每个document  

     
     Map<String, String> mapRe = new HashMap<String, String>();
     mapRe.put("id", d.get("id").toString());
     if(map.get(d.get("id")).get("name") == null){
      mapRe.put("name", d.getFieldValue("name").toString()+"--"+d.getFieldValue("author").toString()+"-"+d.getFieldValue("theme"));
     }else{
      mapRe.put("name", map.get(d.get("id")).get("name").toString()+"--"+d.getFieldValue("author").toString()+"-"+d.getFieldValue("theme"));
     }
     if(map.get(d.get("id")).get("content") == null){
      mapRe.put("content", d.getFieldValue("content").toString().substring(0,200));
     }else{
      mapRe.put("content", map.get(d.get("id")).get("content").toString());
     }
     list.add(mapRe);
    }     
    return list;
}

2 ) 另外的方法，配置solrconfig.xml

solr是在lucene的基础上作的开发，那么在某些功能的实现上，与lucene也会有类似之处。
solr的高亮显示（包括自动摘要），是经过hl这个param，以及其相关变量来实现的，hl是hightlight的简写。lucene中是经过highlighter来操做高亮和摘要的。
 
配置高亮的相关属性，是在solrconfig.xml中配置的。在 <requestHandler name="search" class="solr.SearchHandler" default="true">下进行配置。solrconfig.xml文件中包含多个requestHandler的标签，可是只有在上述的名为search的标签中配置才有效。现将配置的案列公布以下：

 <requestHandler name="search" class="solr.SearchHandler" default="true">
    <!-- default values for query parameters can be specified, these
         will be overridden by parameters in the request
      -->
     <lst name="defaults">
       <str name="echoParams">explicit</str>
       <int name="rows">10</int>
       <str name="df">text</str>
        <str name="hl">true</str>
        <str name="hl.fl">content</str>
        <str name="f.name.hl.fragsize">50</str>
        <str name="hl.simple.pre">&lt;font color=&quot;red&gt;</str>
        <str name="hl.simple.post">&lt;/font&gt;</str>
     </lst>
  </requestHandler>

其中，hl是指定是否使用高亮；hl.fl，指定对哪些域进行高亮，对多个域进行高亮的话，好像是用逗号隔开；f.name.hl.fragsize是指摘要的长度，默认0表明不作摘要。而hl.simple.pre和hl.simple.post则是指定高亮时显示的格式，默认是<em></em>。详细内容请参见：http://wiki.apache.org/solr/HighlightingParameters。设置完成后，

在solrj中，经过QueryResponse对象的getHighlighting()方法得到。该方法返回 Map<String,Map<String,List<String>>>类型的数据。其中第一个Map中的key是id,第二个Map中的key是field，List<String>中封装的就是高亮与摘要处理事后的内容了

 Map<String, Map<String, List<String>>> map = response.getHighlighting();
 
 经过这个api的方法就能够获得高亮的内容，高亮的内容经过 key 跟索引的document部分关联起来
 
 这个key就是document 的id
参数详细说明：

1.hl.fl: 用空格或逗号隔开的字段列表。要启用某个字段的highlight功能，就得保证该字段在schema中是stored。若是该参数未被给出，那么就会高亮默认字段 standard handler会用df参数，dismax字段用qf参数。你可使用星号去方便的高亮全部字段。若是你使用了通配符，那么要考虑启用hl.requiredFieldMatch选项。
 2.hl.requireFieldMatch: 
若是置为true，除非该字段的查询结果不为空才会被高亮。它的默认值是false，意味着它可能匹配某个字段却高亮一个不一样的字段。若是hl.fl使用了通配符，那么就要启用该参数。尽管如此，若是你的查询是all字段（多是使用copy-field 指令），那么仍是把它设为false，这样搜索结果能代表哪一个字段的查询文本未被找到
 3.hl.usePhraseHighlighter: 
若是一个查询中含有短语（引号框起来的）那么会保证必定要彻底匹配短语的才会被高亮。
 4.hl.highlightMultiTerm 
若是使用通配符和模糊搜索，那么会确保与通配符匹配的term会高亮。默认为false，同时hl.usePhraseHighlighter要为true。
 5.hl.snippets： 
这是highlighted片断的最大数。默认值为1，也几乎不会修改。若是某个特定的字段的该值被置为0（如f.allText.hl.snippets=0），这就代表该字段被禁用高亮了。你可能在hl.fl=*时会这么用。
 6.hl.fragsize: 
每一个snippet返回的最大字符数。默认是100.若是为0，那么该字段不会被fragmented且整个字段的值会被返回。大字段时不会这么作。
 7.hl.mergeContiguous: 
若是被置为true，当snippet重叠时会merge起来。
 8.hl.maxAnalyzedChars: 
会搜索高亮的最大字符，默认值为51200，若是你想禁用，设为-1
 9.hl.alternateField: 
若是没有生成snippet（没有terms 匹配），那么使用另外一个字段值做为返回。
 10.hl.maxAlternateFieldLength: 
若是hl.alternateField启用，则有时须要制定alternateField的最大字符长度，默认0是即没有限制。因此合理的值是应该为:hl.snippets * hl.fragsize这样返回结果的大小就能保持一致。
 12.hl.formatter:一个提供可替换的formatting算法的扩展点。默认值是simple，这是目前仅有的选项。显然这不够用，你能够看看org.apache.solr.highlight.HtmlFormatter.java 和 solrconfig.xml中highlighting元素是如何配置的。 
注意在不论原文中被高亮了什么值的状况下，如预先已存在的em tags，也不会被转义，因此在有时会致使假的高亮。
 13.hl.fragmenter: 
这个是solr制定fragment算法的扩展点。gap是默认值。regex是另外一种选项，这种选项指明highlight的边界由一个正则表达式肯定。这是一种非典型的高级选项。为了知道默认设置和fragmenters (and formatters)是如何配置的，能够看看solrconfig.xml中的highlight段。 
regex 的fragmenter有以下选项：
 14.hl.regex.pattern:正则表达式的pattern
15.hl.regex.slop:这是hl.fragsize能变化以适应正则表达式的因子。默认值是0.6，意思是若是hl.fragsize=100那么fragment的大小会从40-160.