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的文件夹结构
bin：solr的运行脚本 ，想要运行服务的服务的时候，可以双击运行里面的solr.cmd文件，不过使用的自带的jetty小服务器。
contrib：solr的一些贡献软件/插件，用于增强solr的功能。
dist：该目录包含build过程中产生的war和jar文件，以及相关的依赖文件。
docs：solr的API文档
example：solr工程的例子目录：
example/solr：
该目录是一个包含了默认配置信息的Solr的Core目录。
example/multicore：
该目录包含了在Solr的multicore中设置的多个Core目录。
example/webapps：
该目录中包括一个solr.war，该war可作为solr的运行实例工程。
licenses：solr相关的一些许可信息
system_requirements.txt : 系统需求信息【里面可以看到对应版本需要的jdk版本信息】
3 运行环境
solr 需要运行在一个Servlet容器中，Solr4.10.3要求jdk使用1.7以上，Solr默认提供Jetty（java写的Servlet容器），本教程使用Tocmat作为Servlet容器，环境如下：
Solr：Solr4.10.3
Jdk：jdk1.7.0_80
Tomcat：apache-tomcat-7.0.52
4 solr整合tomcat
因为我之前已经安装好了jdk,环境变量都已经配置好了。这里就不需要安装jdk和配置环境变量了。
1 创建目录
第一步：在D盘下面创建一个solr的文件夹
2 解压tomcat到创建的目录
第二步：解压tomcat的安装文件到solr目录下。
这一步建议使用新的安装文件解压，不要使用之前用过的tomcat
完成后的效果：
3 解压solr到创建的目录
第三步：解压solr-4.10.3.zip压缩文件到solr目录下
完成后的效果：
4 拷贝solr.war
第四步:拷贝solr-4.10.3里面的solr.war包到tomcat的的webapps里面去
1.solr.war在D:solrsolr-4.10.3examplewebapps目录下
2.拷贝到D:solrapache-tomcat-7.0.52webapps里面去
5 解压solr.war
第五步：使用解压工具解压solr.war包 或者 启动tomcat服务自动完成解压
如果启动tomcat服务自动解压的话，解压完成后记得停止tomcat服务，因为我们的配置工作还没有完成，
因此这里建议使用解压工具手动解压。
6 删除solr.war
第六步：删除tomcat下的webapps里面的solr.war包
7 拷贝jar包到工程中
第七步：把solr-4.10.3examplelibext目录下的所有的jar包添加到solr工程中
注意：对于一个tomcat有两个存放lib包的地方。
1.第一个地方是：你的项目下面的WEB-INF下面的lib目录里面
2.第二个地方是：tomcat安装目录下的lib目录里面
对于这两处地方，我们建议放到你的项目下面的WEB-INF下面的lib目录里面。
8 准备solrhome
第八步：配置solrHome 和 solrCore
1.在D:solr目录下创建一个solrhome文件夹(存放solr所有配置文件的一个文件夹)
solr-4.10.3examplesolr目录就是一个标准的solrhome。
2.复制solr-4.10.3examplesolr文件夹里面的全部内容到刚刚创建的solrhome目录下面
为什么不使用solr-4.10.3examplesolr这个标准的solrhome呢？
答：如果是单机版用这个还可以。如果搭建集群我们需要很多个solrhome,你就一个源代码包是不够用的。
补充：
在solrhome下有一个文件夹叫做collection1这就是一个solrcore。就是一个solr的实例。一个solrcore相当于mysql中一个数据库。Solrcore之间是相互隔离。
- 在solrcore中有一个文件夹叫做conf，包含了索引solr实例的配置信息。
- 在conf文件夹下有一个solrconfig.xml。配置实例的相关信息。如果使用默认配置可以不用做任何修改。
Xml的配置信息：
Lib：solr服务依赖的扩展包，默认的路径是collection1lib文件夹，如果没有 就创建一个
dataDir：配置了索引库的存放路径。默认路径是collection1data文件夹，如果没有data文件夹，会自动创建。
requestHandler：
9 配置solrhome到web.xml中
第九步：配置solrhome到我们的web.xml里面
其它瞎掰：weblogic服务器一般在我们的政府机构使用，电商一般使用的是tomcat.银行一般使用的IBM公司的websphere,银行使用的数据库一般是db2.
下面正式说一下怎么配置我们的solrhome:
打开web.xml,找到下面的内容
修改为：D:solrsolrhome就是上面配置的solrhome所在的位置
注意：solr/home名称必须是固定的。
10 启动tomcat
第十步：进入tomcat的bin目录，双击startup.bat启动tomcat服务
11 访问
第十一步：浏览器访问localhost:8080/solr/出现下面的界面说明安装成功了
4 安装中文分词器
第一步：把IKAnalyzer2012FF_u1.jar添加到solr/WEB-INF/lib目录下。
第二步：在solr/WEB-INF/下面创建classes目录
第三步：复制IKAnalyzer的配置文件和自定义词典和停用词典到solr的classpath下。即是复制到上一步创建的classes目录下。
注意：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>
第五步：定义一个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"/>
四五两步配置后的效果：
第六步：重启tomcat，配置生效
第七步：测试
5 批量导入数据
使用dataimport插件批量导入数据。
第一步：把dataimport插件的依赖的jar包添加到solrcore(collection1lib)中去。
1.jar包所在位置
2.D:solrsolrhomecollection1下面没有lib文件夹，创建一个
3.将jar包拷贝进去
第二步：导入数据库的驱动包到solrcore(collection1lib)中去。
这里需要的数据库的驱动包需要你自己准备
完成后的效果：
第三步：修改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>
效果：
第四步：创建一个data-config.xml，保存到D:solrsolrhomecollection1conf目录下
1.创建data-config.xml文件。
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中加入上面的代码，效果如下
第五步：重启tomcat,让配置生效。
第六步：点击Execute按钮导入数据。
勾选Auto-Refresh Status 可以自动刷新，看到导入的状态
导入数据前会先清空索引库，然后再导入。
6 Solr后台管理界面维护索引
1 添加/修改文档
id相同的话，会先删除原来的，然后保存新的。
2 删除文档
1 删除指定id的索引
2 删除查询到的索引数据
3 删除所有的索引数据
7 solr后台管理界面查询索引
通过/select 搜索索引，Solr 制定一些参数完成不同需求的搜索
1 q query
1 q - 查询字符串，必须的，如果查询所有使用*:*。
2 fq filter query
3 sort
4 start&rows
5 fl
6 df
7 wt
9 hl
8 Solr 4.10.1 使用 SolrJ 管理索引库
1 什么是SolrJ
solrj 是访问 Solr 服务的 java 客户端，提供索引和搜索的请求方法，SolrJ 通常在嵌入在业务系统中，通过 SolrJ
的 API 接口操作 Solr 服务.如下图：
2 依赖的jar包
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域。
可以看到默认的所搜域是text , 默认的条数是10条。