搜索引擎之solr

1       Solr介绍

1.1   什么是solr

Solr 是Apache下的一个顶级开源项目，采用Java开发，它是基于Lucene的全文搜索服务器。Solr可以独立运行在Jetty、Tomcat等这些Servlet容器中。

Solr提供了比Lucene更为丰富的查询语言，同时实现了可配置、可扩展，并对索引、搜索性能进行了优化。

使用Solr 进行创建索引和搜索索引的实现方法很简单，如下：

l  创建索引：客户端（可以是浏览器可以是Java程序）用 POST 方法向 Solr 服务器发送一个描述 Field 及其内容的 XML 文档，Solr服务器根据xml文档添加、删除、更新索引 。

l  搜索索引：客户端（可以是浏览器可以是Java程序）用 GET方法向 Solr 服务器发送请求，然后对 Solr服务器返回Xml、json等格式的查询结果进行解析，组织页面布局。Solr不提供构建页面UI的功能，但是Solr提供了一个管理界面，通过管理界面可以查询Solr的配置和运行情况。

1.2   Solr和Lucene的区别

Lucene是一个开放源代码的全文检索引擎工具包，它不是一个完整的全文检索应用。Lucene仅提供了完整的查询引擎和索引引擎，目的是为软件开发人员提供一个简单易用的工具包，以方便的在目标系统中实现全文检索的功能，或者以Lucene为基础构建全文检索应用。

 Solr的目标是打造一款企业级的搜索引擎系统，它是基于Lucene一个搜索引擎服务，可以独立运行，通过Solr可以非常快速的构建企业的搜索引擎，通过Solr也可以高效的完成站内搜索功能。

　　　　　　　　　　　　　　　　

2      Solr安装配置

　　2.1   SolrCore配置

　　　　2.1.1  SolrHome和SolrCore

SolrHome是Solr运行的主目录，该目录中包括了多个SolrCore目录。SolrCore目录中包含了运行Solr实例所有的配置文件和数据文件，Solr实例就是SolrCore。

一个SolrHome可以包括多个SolrCore（Solr实例），每个SolrCore提供单独的搜索和索引服务。

2.1.2  目录结构

　　SolrHome目录：

　　　　

　　　　　　SolrCore目录：

　　　　　　　　

2.1.2  创建SolrCore

创建SolrCore先要创建SolrHome。在solr解压包下solr-4.10.3examplesolr文件夹就是一个标准的SolrHome。

l  拷贝solr解压包下solr-4.10.3examplesolr文件夹。

 　　　　　　

　　　　l  复制该文件夹到本地的一个目录，把文件名称改为mySolrHome。

注：改名不是必须的，只是为了便于理解

　　　　　　　　

进入此目录

　　

　　　　　　

　　　　　　　　SolrCore创建成功。

 　　

2.1.3  配置SolrCore

在conf文件夹下有一个solrconfig.xml。这个文件是来配置SolrCore实例的相关信息。如果使用默认配置可以不用做任何修改。它里面包含了不少标签，但是我们关注的标签为：lib标签、datadir标签、requestHandler标签。

2.1.4       lib 标签

将contrib和dist两个目录拷贝到mySolrHome目录下；

在solrconfig.xml中可以加载一些扩展的jar，solr.install.dir表示solrCore的目录位置，需要如下修改：

　　　　　　　　

注意:把../..改为自己jar包存放的路径，才可以找到相关jar包。也可以配置相对路径：

 

2.2       datadir标签

　　　　　　每个SolrCore都有自己的索引文件目录 ，默认在SolrCore目录下的data中。

　　　　　　　　　　　　　　　　

data数据目录下包括了index索引目录 和tlog日志文件目录。

如果不想使用默认的目录也可以通过solrConfig.xml更改索引目录 ，如下：

　　　　　　

　　

2.3       requestHandler标签

requestHandler请求处理器，定义了索引和搜索的访问方式。

通过/update维护索引，可以完成索引的添加、修改、删除操作。

 提交xml、json数据完成索引维护，索引维护小节详细介绍。

 通过/select搜索索引。

 设置搜索参数完成搜索，搜索参数也可以设置一些默认值，如下：

 <requestHandler name="/select" class="solr.SearchHandler">

    <!-- 设置默认的参数值，可以在请求地址中修改这些参数-->

    <lst name="defaults">

        <str name="echoParams">explicit</str>

        <int name="rows">10</int><!--显示数量-->

        <str name="wt">json</str><!--显示格式-->

        <str name="df">text</str><!--默认搜索字段-->

    </lst>

</requestHandler>

3   Solr工程部署

　　　　由于在项目中用到的web服务器大多数是用的Tomcat，所以就讲solr和Tomcat的整合。

　　3.1  安装Tomcat

　　　　　　

　　　　

3.2  把solr.war部署到Tomcat中

　　1、  从solr解压包下的solr-4.10.3examplewebapps目录中拷贝solr.war

　　　　

　　　　

3.3  添加solr服务的扩展依赖包（日志包）

　　l  把solr解压包下的solr-4.10.3examplelibext目录下的所有jar包拷贝。

　　l  复制到解压缩后的solr工程的WEB-INFlib目录

3.4  添加log4j.properties

　　1、  把solr解压包下solr-4.10.3example esourceslog4j.properties文件进行拷贝

　　2、  在解压缩后的solr工程中的WEB-INF目录中创建classes文件夹

　　　　3、  复制log4j.properties文件到刚创建的classes目录

3.5  在solr应用的web.xml文件中，加载SolrHome

修改web.xml使用jndi的方式告诉solr服务器。

Solr/home名称必须是固定的。

4 启动Tomcat进行访问

先启动部署了solr项目的tomcat服务器，再访问http://localhost:8080/solr/

出现以下界面则说明solr安装成功！！！

 

5      Solrj的使用

　　　　5.1   什么是solrj

　　　　　　solrj是访问Solr服务的java客户端，提供索引和搜索的请求方法，SolrJ通常在嵌入在业务系统中，通过SolrJ的API接口操作Solr服务，如下图：

 　　　　　　　　

　　　　　　　　　　　　　　　　　　Solrj和图形界面操作的区别就类似于数据库中你使用jdbc和mysql客户端的区别一样。

代码示例:

　　　　

1  添加jar

　　　　　　　　

 

 

package cn.xjy.test ;

import java.io.IOException ;
import java.util.List ;
import java.util.Map ;
import org.apache.solr.client.solrj.SolrQuery ;
import org.apache.solr.client.solrj.SolrQuery.ORDER ;
import org.apache.solr.client.solrj.SolrServer ;
import org.apache.solr.client.solrj.impl.HttpSolrServer ;
import org.apache.solr.client.solrj.response.QueryResponse ;
import org.apache.solr.common.SolrDocument ;
import org.apache.solr.common.SolrDocumentList ;
import org.apache.solr.common.SolrInputDocument ;
import org.junit.Before ;
import org.junit.Test ;

public class TestSolrJ {
    
    SolrServer    solrServer    = null ;
    
    @Before
    public void init() {
        // 1、 创建HttpSolrServer对象，通过它和Solr服务器建立连接。
        // 参数：solr服务器的访问地址
        solrServer = new HttpSolrServer("http://localhost:8080/solr/collection2") ;
    }
    
    /**
     * 更新或添加
     * 存在就更新,不存在就添加(根据id判断)
     * @throws Exception
     * @throws IOException
     */
    @Test
    public void testAddandUpdate() throws Exception, IOException {
        
        // 2、 创建SolrInputDocument对象，然后通过它来添加域。
        SolrInputDocument doc = new SolrInputDocument() ;
        
        /* 测试添加 */
        /* doc.addField("id","测试1"); doc.addField("product_name","测试name");
         * doc.addField("product_catalog_name","测试product_catalog_name");
         * doc.addField("product_price",22f);
         * doc.addField("product_description","测试product_description");
         * doc.addField("product_picture","测试product_picture"); */
        
        /* 测试更新 */
        
        // 第一个参数：域的名称，域的名称必须是在schema.xml中定义的
        // 第二个参数：域的值
        // 注意：id的域不能少
        doc.addField("id", "测试1") ;
        doc.addField("product_name", "测试更新name") ;
        doc.addField("product_catalog_name", "测试更新product_catalog_name") ;
        doc.addField("product_price", 23f) ;
        doc.addField("product_description", "测试更新product_description") ;
        doc.addField("product_picture", "测试更新product_picture") ;
        
        // 3、 通过HttpSolrServer对象将SolrInputDocument添加到索引库。
        solrServer.add(doc) ;
        
        // 4、 提交。
        solrServer.commit() ;
    }
    
    /**
     * 删除索引
     * @throws Exception
     */
    @Test
    public void testDelete() throws Exception {
        // 根据id删除
        /* solrServer.deleteById("测试1") ; solrServer.commit(); */
        
        // 根据条件删除
        solrServer.deleteByQuery("product_price:23") ;
        
        // 全部删除
        // solrServer.deleteByQuery("*:*");
        solrServer.commit() ;
    }
    
    /**
     * 简单查询
     * @throws Exception 
     */
    @Test
    public void testSimpleQuery() throws Exception {
        
        SolrQuery query = new SolrQuery() ;
        // q是固定的且必须 的
        query.set("q", "id:测试1") ;
        query.set("fl", "id,product_catalog_name") ;
        // query.setFields("id", "product_catalog_name");//效果同上
        
        QueryResponse queryResponse = solrServer.query(query) ;
        
        SolrDocumentList results = queryResponse.getResults() ;
        
        System.out.println("总数:" + results.getNumFound()) ;
        
        for (SolrDocument solrDocument : results) {
            // System.out.println(solrDocument.get("id")) ;
            System.out.println(solrDocument) ;
        }
    }
    
    /**
     * 复杂查询
     * @throws Exception 
     */
    @Test
    public void testComplexQuery() throws Exception {
        SolrServer solrServer2 = new HttpSolrServer("http://localhost:8080/solr") ;
        
        SolrQuery query = new SolrQuery() ;
        
        // 查询条件
        query.setQuery("product_catalog_name:幽默杂货") ;
        
        // 过滤条件
        query.setFilterQueries("product_catalog_name:幽默杂货") ;
        
        // 按指定字段排序
        query.setSort("id", ORDER.desc) ;
        
        // 分页
        query.setStart(0) ;
        query.setRows(100) ;
        
        // 设置要显示的字段
        // query.setFields("id,product_catalog_name") ;
        
        // 设置默认搜索域
        // query.set("df", "product_name");
        
        // 给特定字段设置样式,要显示样式的字段必须是查询条件中的字段
        query.setHighlight(true) ;
        query.addHighlightField("product_catalog_name") ;
        query.setHighlightSimplePre("<span color='red'>") ;
        query.setHighlightSimplePost("</sapn>") ;
        
        // 查询
        QueryResponse queryResponse = solrServer2.query(query) ;
        
        // 获得结果集
        SolrDocumentList results = queryResponse.getResults() ;
        
        System.out.println("总数:" + results.getNumFound()) ;
        
        // 遍历结果集
        for (SolrDocument solrDocument : results) {
            Map<String, Map<String, List<String>>> highlighting = queryResponse.getHighlighting() ;
            System.out.println(highlighting.get(solrDocument.get("id"))) ;
            System.out.println(solrDocument) ;
        }
    }
}