Solr初体验

 

Solr 的官方介绍

Solr is the popular, blazing fast open source enterprise search platform from the Apache Lucene project. Its major features include powerful full-text search, hit highlighting, faceted search, dynamic clustering, database integration, and rich document (e.g., Word, PDF) handling. Solr is highly scalable, providing distributed search and index replication, and it powers the search and navigation features of many of the world's largest internet sites.

 

Solr 安装

1 、上 apache 下载 solr 安装文件（ http://lucene.apache.org/solr/ ），我做测试时下载的是最新版本的压缩包（ apache-solr-1.4.1 ）。

2 、解压缩，将 apache-solr-1.4.1\example\webapps 下的 solr.war 放置在 tomcat 容器的 webapps 目录中

3 、设置 Solr 的主位置，可以通过以下三种方式：

A 、设置 java 系统属性  solr.solr.home  （没错，就是  solr.solr.home ）。

B 、配置  java:comp/env/solr/home  的一个 JNDI 查找指向  solr  目录。

C 、在包含 solr 目录的目录中启动 servlet 容器。（默认的 Solr 主目录是当前工作目录下的  solr 。）。

我采用的方式是在 tomcat 的 conf\Catalina\localhos 目录下建立 solr.xml 文件，我将 solr 的 home 放在 D 盘，文件内同如下：

 

<?xml version="1.0" encoding="UTF-8"?>
<Context docBase="D:\apache-solr-1.4.1\example\webapps\solr.war" debug="0" crossContext="true" >
	   <Environment name="solr/home" type="java.lang.String" value="D:\solr_home" override="true" />
</Context>

 这样配置不需要将 solr.war 文件放在 tomcat 容器的 webapps 目录中。 Solr home 中的内容为 apache-solr-1.4.1\example\solr 下的内容，其中主要的三个文件夹为： bin 、 conf 、 data ， data 下就是存放索引的地方。如果一切配置成功，启动 tomcat ，访问 http://localhost:8088/solr/admin

 

( 我的 tomcat 端口号为 8088) ，即可访问到 solr 管理主界面。

 

Solr 重要文件的简单说明（详细信息 tosee solr wiki ）

solrconfig.xml 是 solr 的基础文件，里面配置了各种 web 请求处理器、请求响应处理器、日志、缓存等。

schema.xml 配置映射了各种数据类型的索引方案。分词器的配置、索引文档中包含的字段也在此配置。

 

 

 

Solr 使用

Solr 以 web 形式的发布，对外提供了添加、修改、删除索引和检索的 web 服务。并且提供多种格式的信息传输，如 xml 、 json 、 cvs 等，默认提供的是 xml 格式。

以下是按照 solr 的默认配置，对 solr 初步体验的过程

<!--[if !supportLists]-->1、  <!--[endif]-->设计索引模型。 索引模型中包含四个不同数据类型的字段： Id(int) 、 time （ Calendar ）、 enabled(boolean) 、 content(String) 。其中 id 是文档的唯一标识。

<!--[if !supportLists]-->2、  <!--[endif]-->在 schema.xml 中映射索引模型的各个字段。

具体的内同如下：

 

 

<!—field 标签配置了字段的解析类型、是否需要索引、是否需要存储等，详细信息 to see  solr wiki-- >
<field name="id" type="integer" indexed="true" stored="true"/>
<field name="time" type="date" indexed="true" stored="true"/>
<field name="enabled" type="boolean" indexed="true" stored="true"/>
<field name="content" type="text" indexed="true" stored="true"/>

<!- 字段all是一个虚拟的字段，代表所有的字段，在此表示：id，time，enabled，content 
<field name="all" type="text" indexed="true" stored="true" multiValued="true"/>

<!—uniqueKey告诉solr id字段是文档的唯一标识 -->
<uniqueKey>id</uniqueKey>

<!—solrQueryParser 标签表示多条件检索时采用的策略。如：检索条件content：xxx time：xxx solr就会采取content：xxx OR time：xxx 这种形式-->
<solrQueryParser defaultOperator="OR"/>

<!—defaultSearchField标签表示如果没有明确检索那个字段，solr就会检索这个标签配置的字段 -->
<defaultSearchField>all</defaultSearchField>

<!—copyField标签表示将其他字段复制到目标字段，方面检索。如：将id、time、enabled、content 复制到all上面，当不指定明确的检索字段，solr就会检索all字段，其实就是检索id、time、enabled、content -->
<copyField source="id" dest="all"/>
<copyField source="time" dest="all"/>
<copyField source="enabled" dest="all"/>
<copyField source="content" dest="all"/>

 

 

 

<!--[if !supportLists]-->3、  <!--[endif]-->配置中文分词。

我采用的是 IKAnalyzer 中文分词，中文分词器的配置参考 IKAnalyzer 中文分词的使用手册。中文分词器需安装在 solr web 端

4 、编写客户端程序访问 solr web 服务创建、修改、删除索引和搜索

       Solr 默认提供的 web 服务 api 如下：

       创建、更新、提交、优化索引： http://localhost:8088/solr/update post

       删除索引： http://localhost:8088/solr/update post

       搜索： http://localhost:8088/solr/select get

 

4.1 创建、更新、提交、优化索引（详细的配置信息 tosee Solr wiki ）

创建、更新索引需要向 solr 服务提供如下的格式化信息

 

<add>
  <doc>
    <field name="id">1</field>
    <field name="time">2010-10-10T11:11:11.222S </field>
    <field name="enabled">true</field>
    <field name="content">solr development</field>
  </doc>
  [<doc> ... </doc>[<doc> ... </doc>]]
</add>

 创建或修改完索引，需要提交，这样 solr 才能够检索到

 

提交索引变化的格式化信息如下：

<commit/>

优化索引的格式化信息如下：

< optimize/>

索引的提交或优化也可以以 url 参数的形式体现。如

http://localhost:8088/solr/update?commit=true

 

4.2 删除索引的格式化信息（详细的配置信息 tosee Solr wiki ）

 

<delete>
  <id>1</id>
<id>2</id>
  <query>content:solr</query>
</delete>

 

 

 

4.3 搜索

Solr 的查询语法（详细的配置信息 tosee Solr wiki ）

 

 

参数	描述	示例
q	Solr 中用来搜索的查询。有关该语法的完整描述，分号和已索引且未进行断词的字段（下面会进行解释）的名称来包含排序信息。默认的排序是  score desc ，指按记分降序排序。	q=myField:Java AND otherField:developerWorks; date asc  此查询搜索指定的两个字段并根据一个日期字段对结果进行排序。
q.op	表示 q 中 查询语句的 各条件的逻辑操作 AND( 与 ) OR( 或 )  <!--[if !supportLineBreakNewLine]--> <!--[endif]-->	q.op=AND
start	将初始偏移量指定到结果集中。可用于对结果进行分页。默认值为 0 。	start=15  返回从第 15 个结果开始的结果。
rows	返回文档的最大数目。默认值为 10 。	rows=25
fq	提供一个可选的筛选器查询。查询结果被限制为仅搜索筛选器查询返回的结果。筛选过的查询由 Solr 进行缓存。它们对提高复杂查询的速度非常有用。	任何可以用  q  参数传递的有效查询，排序信息除外。
hl	当  hl=true  时，在查询响应中醒目显示片段。默认为 false 。	hl=true
hl.fl	高亮 field	hl.fl=id,content
hl.simple.pre	高亮前面的格式	hl.simple.pre=<a>
hl.simple.post	高亮后面的格式	hl.simple.post=</a>
fl	作为逗号分隔的列表指定文档结果中应返回的  Field  集。默认为 “*” ，指所有的字段。 “score” 指还应返回记分。	*,score
sort	排序	sort =id asc

 

 

实例

 

//利用httpclient访问solr服务、服务端返回标准的xml格式信息
//需要较好的展示需要自己解析xml格式信息
String keyword = req.getParameter("q");
if(StringUtils.isNotBlank(keyword)){
	String command = "fl=*,score&start=0&rows=10&hl=true&hl.fl=*&q="+URLEncoder.encode(keyword, "UTF-8");
	responseResult = HttpClientUtils.sendGetCommand(command, "http://localhost:8088/solr/select");
	responseResult = escape(responseResult);
}

 

 

 

 

 

有了上述的基本了解，一个最基础的应用就可以跑起来了。具体代码请看附件源码

 

 

供参考的资料：

Solr 的 wiki 地址（内容非常详细，英语好的可直接阅读）：

http://wiki.apache.org/solr/FrontPage

使用 Apache Solr 实现更加灵巧的搜索第 1 部分 : 基本特性和 Solr 模式

http://www.ibm.com/developerworks/cn/java/j-solr1/index.html?ca=drs-

使用 Apache Solr 实现更加灵巧的搜索，第 2 部分 : 用于企业的 Solr

http://www.ibm.com/developerworks/cn/java/j-solr2/index.html?ca=drs-