前面已经说到,Solr/Solr Cloud 提供的是基于HTTP REST 的API,支持返回XML/JSON格式的响应,所以只要可以发送GET请求就能很容易的使用Solr提供的索引服务。
常见的接入场景有两种
- 直接使用JavaScript AJAX 拼接搜索参数执行HTTP 请求,获得JSON响应,渲染视图。
- Java应用通过使用Solr J,在后端对搜索服务进行封装,将搜索结果转换为Model返回给视图。
本文主要讲解第二种方式,使用Solo J。下面这种方式依赖Maven、Spring Context,Solr 服务选择的是Solr Cloud。
- 第一步,引入Maven依赖
<dependency>
<groupId>org.apache.solr</groupId>
<artifactId>solr-solrj</artifactId>
<version>5.5.2</version>
</dependency>
- 第二步,将Solr Client 托管Spring Context
<bean id="solrClient" class="org.apache.solr.client.solrj.impl.CloudSolrClient" destroy-method="close">
<constructor-arg index="0" value="172.16.1.202:2181"/>
</bean>
- 第三部,创建与Document 对应的Java Bean
public class Blog {
@Field
private String id;
@Field
private String title;
@Field("author")//如果和managed-scheme里面配置的field name不一致需要在注解内指定
private String author;
//省略 getter setter 方法
}
- 第四步,使用Solr Client API
@Resource
private SolrClient solrClient;
@Test
public void query() throws IOException, SolrServerException {
String keyword = "测试";//关键词
//构造查询参数
SolrQuery params = new SolrQuery();
params.setQuery("title:" + keyword);//查询条件 -> 课程标题包含“测试”
params.setStart(0);//分页起始偏移量(非页码)
params.setRows(10);//分页尺寸
params.setHighlight(true);//开启高亮
params.addHighlightField("title");//添加需要高亮的字段
params.setHighlightSimplePre("<span style=\"color:red\">");//高亮文本前缀
params.setHighlightSimplePost("<span/>");//高亮文本刚、后缀
//执行查询,获得响应结果
QueryResponse response = solrClient.query(COLLECTION, params);
//将查询结果转换为Java Bean (Json - > Bean)
List<Blog> blogList = response.getBeans(Blog.class);
Assert.assertTrue(blogList.size() == 10);
}
除了查询当然还有像addBeans()、addBean()、deleteById()、deleteByQuery()等API,基本就是增删改查啦 Solr J已经帮我们封装的极其简单啦,这里就不讲解了后面会给出API文档地址,自行翻阅哈,当然Solr Client也包括操纵Collection、Zookeeper的一些API,这些都是通过Http Client Get 请求对Solr HTTP REST API的封装。
在实际使用场景下,我们使用客户端通常也只是做查询操作,而数据的导入、同步(增量、全量)、Collection的管理、Zookeeper的管理还是使用Shell脚本来比较合理。
下篇文章会讲解,如何使用Solr DIH进行数据的导入及增量同步。
Solr J API文档点我
下篇文章:数据导入/同步&运维
我只是官方文档的搬运工,如果你要使用Solr 强烈建议阅读官方文档,写的非常完善,传送门。