1 solr的下载

从Solr官方网站(http://lucene.apache.org/solr/ )下载Solr最新版本,根据Solr的运行环境,Linux下需要下载solr-7.3.1.tgz,windows下需要下载solr-7.3.1.zip

Solr使用指南可参考:https://wiki.apache.org/solr/FrontPage

本教程中我使用的是solr-4.10.3.zip版本。新版本大体上都是一样的。注意solr-7.3.1需要的jdk的版本须在1.8及其以上。

2 solr的文件夹结构

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

binsolr的运行脚本 ,想要运行服务的服务的时候,可以双击运行里面的solr.cmd文件,不过使用的自带的jetty小服务器。

contribsolr的一些贡献软件/插件,用于增强solr的功能。

dist:该目录包含build过程中产生的warjar文件,以及相关的依赖文件。

docssolrAPI文档

examplesolr工程的例子目录:

example/solr

该目录是一个包含了默认配置信息的SolrCore目录。

example/multicore

该目录包含了在Solrmulticore中设置的多个Core目录。

example/webapps

 该目录中包括一个solr.war,该war可作为solr的运行实例工程。

licensessolr相关的一些许可信息

system_requirements.txt : 系统需求信息【里面可以看到对应版本需要的jdk版本信息】

3 运行环境

solr 需要运行在一个Servlet容器中,Solr4.10.3要求jdk使用1.7以上,Solr默认提供Jettyjava写的Servlet容器),本教程使用Tocmat作为Servlet容器,环境如下:

SolrSolr4.10.3

Jdkjdk1.7.0_80

Tomcatapache-tomcat-7.0.52

4 solr整合tomcat

 因为我之前已经安装好了jdk,环境变量都已经配置好了。这里就不需要安装jdk和配置环境变量了。

1 创建目录

第一步:在D盘下面创建一个solr的文件夹

2 解压tomcat到创建的目录

第二步:解压tomcat的安装文件到solr目录下。

这一步建议使用新的安装文件解压,不要使用之前用过的tomcat

完成后的效果:

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

3 解压solr到创建的目录

第三步:解压solr-4.10.3.zip压缩文件到solr目录下

完成后的效果:

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

4 拷贝solr.war

第四步:拷贝solr-4.10.3里面的solr.war包到tomcat的的webapps里面去

1.solr.war在D:solrsolr-4.10.3examplewebapps目录下

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

2.拷贝到D:solrapache-tomcat-7.0.52webapps里面去

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

5 解压solr.war

第五步:使用解压工具解压solr.war包  或者  启动tomcat服务自动完成解压

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

如果启动tomcat服务自动解压的话,解压完成后记得停止tomcat服务,因为我们的配置工作还没有完成,

因此这里建议使用解压工具手动解压

6 删除solr.war

第六步:删除tomcat下的webapps里面的solr.war包

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

7 拷贝jar包到工程中

第七步:solr-4.10.3examplelibext目录下的所有的jar包添加到solr工程中

 注意:对于一个tomcat有两个存放lib包的地方。

1.第一个地方是:你的项目下面的WEB-INF下面的lib目录里面

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

2.第二个地方是:tomcat安装目录下的lib目录里面

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

对于这两处地方,我们建议放到你的项目下面的WEB-INF下面的lib目录里面

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

8 准备solrhome

第八步:配置solrHome 和 solrCore

1.在D:solr目录下创建一个solrhome文件夹(存放solr所有配置文件的一个文件夹)

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

solr-4.10.3examplesolr目录就是一个标准的solrhome

2.复制solr-4.10.3examplesolr文件夹里面的全部内容到刚刚创建的solrhome目录下面

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

为什么不使用solr-4.10.3examplesolr这个标准的solrhome呢?

答:如果是单机版用这个还可以。如果搭建集群我们需要很多个solrhome,你就一个源代码包是不够用的。

补充

solrhome下有一个文件夹叫做collection1这就是一个solrcore。就是一个solr的实例。一个solrcore相当于mysql中一个数据库。Solrcore之间是相互隔离。

solrcore中有一个文件夹叫做conf,包含了索引solr实例的配置信息。
conf文件夹下有一个solrconfig.xml。配置实例的相关信息。如果使用默认配置可以不用做任何修改

        Xml的配置信息:

        Libsolr服务依赖的扩展包,默认的路径是collection1lib文件夹,如果没有  就创建一个

        dataDir:配置了索引库的存放路径。默认路径是collection1data文件夹,如果没有data文件夹,会自动创建。

        requestHandler

9 配置solrhome到web.xml中

 第九步:配置solrhome到我们的web.xml里面

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

其它瞎掰:weblogic服务器一般在我们的政府机构使用,电商一般使用的是tomcat.银行一般使用的IBM公司的websphere,银行使用的数据库一般是db2.

下面正式说一下怎么配置我们的solrhome:

打开web.xml,找到下面的内容

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

修改为:D:solrsolrhome就是上面配置的solrhome所在的位置

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

注意:solr/home名称必须是固定的

10 启动tomcat

第十步:进入tomcat的bin目录,双击startup.bat启动tomcat服务

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

11 访问

第十一步:浏览器访问localhost:8080/solr/出现下面的界面说明安装成功了

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

4 安装中文分词器

第一步:IKAnalyzer2012FF_u1.jar添加到solr/WEB-INF/lib目录下。

第二步:在solr/WEB-INF/下面创建classes目录

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

第三步:复制IKAnalyzer的配置文件和自定义词典和停用词典到solr的classpath下。即是复制到上一步创建的classes目录下。

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

注意:eclipse的文本编辑是以UTF-8 无BOM格式编码的,如果使用文本编辑器编辑推荐使用notepad++编辑,

选择一样的编码格式【以UTF-8 无BOM格式编码】,这样可以避免,你修改ext.dic或者stopword.dic文档之后就不好使了。

第四步:在D:solrsolrhomecollection1conf下的schema.xml文件中添加一个自定义的fieldType,使用中文分析器。

 直接添加下面的代码到配置文件里面就可以了:

<!-- IKAnalyzer-->
<fieldType name="text_ik" class="solr.TextField">
     <analyzer class="org.wltea.analyzer.lucene.IKAnalyzer"/>
</fieldType>

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

第五步:定义一个field,指定field的Type属性为text_ik.

复制下面的代码添加到schema.xml配置文件就可以了。

<!--IKAnalyzer Field-->
<field name="title_ik" type="text_ik" indexed="true" stored="true" />
<field name="content_ik" type="text_ik" indexed="true" stored="false" multiValued="true"/>

四五两步配置后的效果:

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

第六步:重启tomcat,配置生效

第七步:测试

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

 

5 批量导入数据

使用dataimport插件批量导入数据。

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

第一步:把dataimport插件的依赖的jar包添加到solrcore(collection1lib)中去。

1.jar包所在位置

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

2.D:solrsolrhomecollection1下面没有lib文件夹,创建一个

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

3.将jar包拷贝进去

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

第二步:导入数据库的驱动包到solrcore(collection1lib)中去。

这里需要的数据库的驱动包需要你自己准备

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

完成后的效果:

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

第三步:修改D:solrsolrhomecollection1conf下的solrconfig.xml文件,添加一个requestHandler。

<requestHandler name="/dataimport" class="org.apache.solr.handler.dataimport.DataImportHandler">
    <lst name="defaults">
      <str name="config">data-config.xml</str>
     </lst>
</requestHandler> 

效果:

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

第四步:创建一个data-config.xml,保存到D:solrsolrhomecollection1conf目录下

1.创建data-config.xml文件。

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

2.复制下面的代码到data-config.xml文件中

<?xml version="1.0" encoding="UTF-8" ?>
<dataConfig>
<dataSource type="JdbcDataSource"
          driver="com.mysql.jdbc.Driver"
          url="jdbc:mysql://39.105.94.154:3306/lucene"
          user="tom"
          password="tom"/>
<document>
    <entity name="product" query="SELECT pid,name,catalog_name,price,description,picture FROM products ">
         <field column="pid" name="id"/>
         <field column="name" name="product_name"/>
         <field column="catalog_name" name="product_catalog_name"/>
         <field column="price" name="product_price"/> 
         <field column="description" name="product_description"/>
         <field column="picture" name="product_picture"/>
    </entity>
</document>
</dataConfig>

dataSource和entity里面的内容根据自己的实际情况修改.

对于没有的域需要自己配置。

   <!--product-->
   <field name="product_name" type="text_ik" indexed="true" stored="true"/>
   <field name="product_price"  type="float" indexed="true" stored="true"/>
   <field name="product_description" type="text_ik" indexed="true" stored="false" />
   <field name="product_picture" type="string" indexed="false" stored="true" />
   <field name="product_catalog_name" type="string" indexed="true" stored="true" />

   <field name="product_keywords" type="text_ik" indexed="true" stored="false" multiValued="true"/>
   <copyField source="product_name" dest="product_keywords"/>
   <copyField source="product_description" dest="product_keywords"/>

在schema.xml中加入上面的代码,效果如下

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

第五步:重启tomcat,让配置生效。

 solr的安装及配置详细教程/solr入门教程-冯金伟博客园

第六步:点击Execute按钮导入数据。

勾选Auto-Refresh Status 可以自动刷新,看到导入的状态

入数据前会先清空索引库,然后再导入。

6 Solr后台管理界面维护索引

1 添加/修改文档

id相同的话,会先删除原来的,然后保存新的。

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

2 删除文档

1 删除指定id的索引

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

 2 删除查询到的索引数据

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

3 删除所有的索引数据

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

7 solr后台管理界面查询索引

 通过/select 搜索索引,Solr 制定一些参数完成不同需求的搜索

1 q  query

  1 q – 查询字符串,必须的,如果查询所有使用*:*。

 solr的安装及配置详细教程/solr入门教程-冯金伟博客园

2 fq filter query

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

3 sort

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

4 start&rows

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

5  fl

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

6 df

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

7 wt

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

9 hl

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

8  Solr 4.10.1 使用 SolrJ 管理索引库

1 什么是SolrJ

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

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

2 依赖的jar包

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

3 使用SolrJ添加文档

实现步骤:

第一步:创建一个 java 工程。

第二步:导入 jar 包。

maven工程添加下面的依赖

<!-- solr客户端 -->
<dependency>
    <groupId>org.apache.solr</groupId>
    <artifactId>solr-solrj</artifactId>
    <version>4.10.3</version>
</dependency>

第三步:和 Solr 服务器建立连接。HttpSolrServer 对象建立连接。

第四步:创建一个 SolrInputDocument 对象,然后添加域。

第五步:将 SolrInputDocument 添加到索引库。

第六步:提交。

//向索引库中添加索引
    @Test
    public void addDocument() throws Exception {
        //和solr 服务器创建连接
        //参数:solr 服务器的地址,默认找的collection1,如不不是需要指明。
        SolrServer solrServer = new HttpSolrServer("http://localhost:8080/solr");
        //创建一个文档对象
        SolrInputDocument document = new SolrInputDocument();
        //向文档中添加域
        //第一个参数:域的名称,域的名称必须是在 schema.xml 中定义的
        //第二个参数:域的值
        document.addField("id", "c0001");
        document.addField("title_ik", "使用 solrJ 添加的文档");
        document.addField("content_ik", "文档的内容");
        document.addField("product_name", "商品名称");
        //把 document 对象添加到索引库中
        solrServer.add(document);
        //提交修改
        solrServer.commit();
    }

4 根据 id 删除文档

//删除文档,根据 id 删除
    @Test
    public void deleteDocumentByid() throws Exception {
        //创建连接
        SolrServer solrServer = new HttpSolrServer("http://localhost:8080/solr");
        //根据 id 删除文档
        solrServer.deleteById("c0001");
        //提交修改
        solrServer.commit();
    }

5 根据查询删除文档

查询语法完全支持 Lucene 的查询语法。

//根据查询条件删除文档
    @Test
    public void deleteDocumentByQuery() throws Exception {
        //创建连接
        SolrServer solrServer = new HttpSolrServer("http://localhost:8080/solr");
        //根据查询条件删除文档,*:*刪除所有
        solrServer.deleteByQuery("*:*");
        //提交修改
        solrServer.commit();
    }

6 修改文档

在 solrJ 中修改没有对应的 update 方法,只有 add 方法,只需要添加一条新的文档,和被修改的文档 id 一致就,可以
修改了。本质上就是先删除后添加。

7 简单查询

//查询索引
    @Test
    public void queryIndex() throws Exception {
        //创建连接
        SolrServer solrServer = new HttpSolrServer("http://localhost:8080/solr");
        //创建一个 query 对象
        SolrQuery query = new SolrQuery();
        //设置查询条件
        query.setQuery("*:*");
        //也可以这样写:query.set("q","*:*");
        //执行查询
        QueryResponse queryResponse = solrServer.query(query);
        //取查询结果
        SolrDocumentList solrDocumentList = queryResponse.getResults();
        //共查询到商品数量
        System.out.println("共查询到商品数量:" + solrDocumentList.getNumFound());
        //遍历查询的结果
        for (SolrDocument solrDocument : solrDocumentList) {
        System.out.println(solrDocument.get("id"));
        System.out.println(solrDocument.get("product_name"));
        System.out.println(solrDocument.get("product_price"));
        System.out.println(solrDocument.get("product_catalog_name"));
        System.out.println(solrDocument.get("product_picture"));
        }
    }

8 复杂查询

其中包含查询、过滤、分页、排序、高亮显示等处理。

// 复杂查询索引
    @Test
    public void queryIndex2() throws Exception {
        // 创建连接
        SolrServer solrServer = new HttpSolrServer("http://localhost:8080/solr");
        // 创建一个 query 对象
        SolrQuery query = new SolrQuery();
        // 设置查询条件
        query.setQuery("钻石");
        // 也可以这样写:query.set("q","钻石");
        // 也可以这样写:query.set("q", "id:1");
        // 也可以这样写:query.set("q", "*:*");
    
        // 过滤条件
        query.setFilterQueries("product_catalog_name:幽默杂货");
        // 也可以这样写:query.set("fq","product_catalog_name:幽默杂货");
        // 也可以这样写: query.set("fq","product_price:[* TO 10]");
    
        // 排序条件
        query.setSort("product_price", ORDER.asc);
        // 也可以这样写:query.addSort("product_price asc");
        // 也可以这样写:query.addSort("product_price",ORDER.asc);
        // 也可以这样写:query.set("sort", "product_price asc");
    
        // 分页处理
        query.setStart(0);
        query.setRows(10);
        // 也可以这样写:query.set("start", 0);
        // 也可以这样写:query.set("rows", 10);
        // 结果中域的列表
        query.setFields("id", "product_name", "product_price", "product_catalog_name", "product_picture");
        // 也可以写成下面这样:query.set("fl", "product_name","product_price");
    
        // 设置默认搜索域
        query.set("df", "product_keywords");
    
        // 打开高亮显示
        query.setHighlight(true);
        // 高亮显示的域
        query.addHighlightField("product_name");
        // 高亮显示的前缀
        query.setHighlightSimplePre("<span style='color:red;'>");
        // 高亮显示的后缀
        query.setHighlightSimplePost("</span>");
    
        // 执行查询
        QueryResponse queryResponse = solrServer.query(query);
        // 取查询结果
        SolrDocumentList solrDocumentList = queryResponse.getResults();
        // 共查询到商品数量
        System.out.println("共查询到商品数量:" + solrDocumentList.getNumFound());
        // 取高亮显示部分的内容
        // Map k id V Map
        // Map k 域名 V List
        // List list.get(0);
        Map<String, Map<String, List<String>>> highlighting = queryResponse.getHighlighting();
    
        // 遍历查询的结果
        for (SolrDocument solrDocument : solrDocumentList) {
            System.out.println(solrDocument.get("id"));
            //看高亮显示部分是否有此 id 的内容,有取出。没有返回 null.
            Map<String, List<String>> map = highlighting.get(solrDocument.get("id"));
            // 判断一下,防止出现空指针异常
            List<String> list = null;
            if (map != null) {
            list = map.get("product_name");
            }
            // 判断是否有高亮内容
            String productName = "";
            if (null != list) {
                productName = list.get(0);
            } else {
                productName = (String) solrDocument.get("product_name");
            }
            System.out.println(productName);
            System.out.println(solrDocument.get("product_price"));
            System.out.println(solrDocument.get("product_catalog_name"));
            System.out.println(solrDocument.get("product_picture"));
        }
    }
query.setQuery("钻石"); 如果不指定默认搜索域,默认配置文件里面走的是text域。

solr的安装及配置详细教程/solr入门教程-冯金伟博客园

可以看到默认的所搜域是text , 默认的条数是10条。