客户端开发 Solrjhtml
Solr是搭建好的lucene服务器 固然不可能彻底知足通常的业务需求 可能 要针对各类的架构和业务调整 这里就须要用到Solrj了java
Solrj是Solr提供的api库 能够进行Solr 的二次开发。web
主要实现原理 服务端利用httpClient发送Solr格式的HTTP请求 到Solr服务器 而后服务器根据请求去找索引（ 固然你要先针对数据源建立索引）最后返回SolrDocument. 而后你再进一步处理 高亮 排序 等功能。数据库
1. 建立链接apache
HttpSolrServer solrServer = SolrServiceConfiger.getInstance().getServer();api
//这里建立的一个HTTP请求 用的4.1的JAR Solr3.6以前用的CommonHttpSolrServer.新版改为这个类了 建立一个单例服务。服务器
2. 建立索引架构
/***socket
* 建立Solr索引 经过指定的实体ide
*/
public void create(T t) {
SolrEntityBinder binder = new SolrEntityBinder();//这里这个类是源码DocumentObjectBinder处理类 这里为了实体转换改写了里面一些判断后面会讲到 剩下没改过
SolrInputDocument doc = binder.toSolrInputDocument(t); //把你的实体对象转换成Solr输入文档对象
try {
solrServer.add(doc);//添加文档
solrServer.commit();//提交请求
} catch (SolrServerException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
3 .删除索引
/**
* 删除指定ID的索引
*/
public void delete(PK id) {
try {
solrServer.deleteById((String)id );//直接根据ID删除 solrServer.deleteByQuery("*:*");删除全部
solrServer.commit();
} catch (SolrServerException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
4.修改索引
直接先删除后建立
5.查询索引
public Page<Demo> luceneSearch(String content,Page<Demo> page) {
String id = null;
try {
HttpSolrServer server = SolrServiceConfiger.getInstance().getServer();// 建立服务 */
SolrQuery sQuery = new SolrQuery(); // 建立solr查询对象
String para="";
if(StringUtils.isNotEmpty(content)){ // 拼接solr查询条件
para ="company:"+content;
}
if(!StringUtils.isNotEmpty(para)){
para="*:*";
}
sQuery.setQuery(para)
.setStart((page.getPageNo()-1)*page.getPageSize())
.setRows(page.getPageSize());
//设置高亮
sQuery.setHighlight(true); // 开启高亮组件
sQuery.addHighlightField("company");// 高亮字段
sQuery.setHighlightSimplePre("<font color='red'>");//标记，高亮关键字前缀
sQuery.setHighlightSimplePost("</font>");//后缀
sQuery.setHighlightSnippets(2);//结果分片数，默认为1
sQuery.setHighlightFragsize(1000);//每一个分片的最大长度，默认为100
sQuery.setFacet(true).setFacetMinCount(1)
.setFacetLimit(5)//段
.addFacetField("company");//分片字段
//返回结果
QueryResponse response = server.query(sQuery);
//获得文档列表
SolrDocumentList list = response.getResults();
//获得总数 设置
Integer counts=(int) list.getNumFound();
page.setTotalCount(counts);
//获得高亮数据
Map<String,Map<String,List<String>>> highlightMap=response.getHighlighting(); //获得高亮集合
//建立对象转换对象
DocumentObjectBinder binder = new DocumentObjectBinder();
//转换对象
List<Demo> demoList= binder.getBeans(Demo.class, list);
//设置高亮结果
for(Demo d :demoList){
id = d.getId();
List<String> companyList = highlightMap.get(id).get("company");
if(companyList!=null&&companyList.size()>0){
d.setCompany(companyList.get(0));
}
}
//返回结果
page.setResult(demoList);
} catch (Exception e) {
e.printStackTrace();
}
return page;
}
常见问题
1. org.apache.solr.client.solrj.SolrServerException:
Timeout occured while waiting response from server at: http://localhost/solr请求超时
解决方法：设置setConnectionTimeout和setSoTimeout为1分钟
2. org.apache.solr.common.SolrException: undefined field text
解决方法： 设置solrConfig.xml <str name="df">id</str> 默认是text
3. org.apache.solr.common.SolrException: Invalid Date String时间格式化问题
主要是Solr使用的是标准的格林威治（GMT）时间 这种（yyyy-MM-dd'T'HH:mm:ss.SSS'Z'）北京在东八区 默认时间会-8小时
因此为了知足他这个减8 个人作法是在建立索引格式化日期类型的时候 判断下 把它时间+8 。
因此从新建立一个SolrEntityBinder类 此类是彻底copy的DocumentObjectBinder. 只修改了一处。
修改了类中toSolrInputDocument方法
//判断是不是日期-------------///
if(field.type==Date.class){
Date d = (Date)field.get(obj);
Calendar cal = Calendar.getInstance();
cal.setTimeInMillis(d.getTime());
cal.add(Calendar.HOUR, 8);
d = cal.getTime();
doc.setField(field.name,d,1.0f);
}else{
doc.setField(field.name, field.get(obj), 1.0f);
}
--------------------------------------------
(solrj)初次使用solr的开发人员老是很郁闷，不知道如何去操做solr索引库，觉得只能用《五分钟solr4.5教程（搭建、运行）》中讲到的用xml文件的形式提交数据到索引库，其实没有那么麻烦，solr配套有好多的客户端用于操做索引库，下面咱们来说如何用solrj去操做solr索引库。
1、认识solrj
solrj是solr的java客户端，用于访问solr索引库。它提供了添加、删除、查询、优化等功能。
2、下载
百度、google如下solrj下载，你会发现根本就没有，那么咱们该到哪儿下载呢？其实，它是集成到solr压缩包里的，解压文件后，有个目录/dist/solrj-lib，里面就存放了solrj所用到的jar，你把这些jar都添加到你的classpath就ok。
若是你是使用Maven来构建项目，添加如下代码到你的pom.xml配置文件中：
<dependency> <artifactId>solr-solrj</artifactId> <groupId>org.apache.solr</groupId> <version>1.4.0</version> <type>jar</type> <scope>compile</scope> </dependency>
<dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-simple</artifactId> <version>1.5.6</version> </dependency>
3、建立SolrServer
一、HttpSolrServer
solrj是采用http请求的方式去访问solr索引库的，首先咱们得先建立一个HttpSolrServer，以下：
String url = "http://localhost:8983/solr";//8983是web服务器的端口号，须要根据状况进行调整 SolrServer server = new HttpSolrServer( url );
以上使用默认的方式建立server，你也能够配置其余的链接参数：
String url = "http://localhost:8983/solr" ; HttpSolrServer server = new HttpSolrServer( url ); server.setMaxRetries(1); // defaults to 0. > 1 not recommended. server.setConnectionTimeout(5000); // 5 seconds to establish TCP // Setting the XML response parser is only required for cross // version compatibility and only when one side is 1.4.1 or // earlier and the other side is 3.1 or later. server.setParser(new XMLResponseParser()); // binary parser is used by default // The following settings are provided here for completeness. // They will not normally be required, and should only be used // after consulting javadocs to know whether they are truly required. server.setSoTimeout(1000); // socket read timeout server.setDefaultMaxConnectionsPerHost(100); server.setMaxTotalConnections(100); server.setFollowRedirects(false); // defaults to false // allowCompression defaults to false. // Server side must support gzip or deflate for this to have any effect. server.setAllowCompression(true);
二、EmbeddedSolrServer
EmbeddedSolrServer提供了和HttpSolrServer同样的接口，区别是EmbeddedSolrServer没有经过http链接。
//Note that the following property could be set through JVM level arguments too
System.setProperty("solr.solr.home", "d:/solr_home/solr"); //此处配置solr home，根据本身的状况修改
CoreContainer.Initializer initializer = new CoreContainer.Initializer();
CoreContainer coreContainer = initializer.initialize();
EmbeddedSolrServer server = new EmbeddedSolrServer(coreContainer, "");
固然实际中可能不止一个core，那么采用以下方式：
File home = new File( "d:/solr_home/solr" );//此处配置solr home，根据本身的状况修改
File f = new File( home, "solr.xml" );
CoreContainer container = new CoreContainer();
container.load( "d:/solr_home/solr", f );
EmbeddedSolrServer server = new EmbeddedSolrServer( container, "core name as defined in solr.xml" );//双引号配置你的core名字 ...
在嵌入式的应用中使用solr，推荐使用EmbeddedSolrServer。
注意：EmbeddedSolrServer使用有个前提条件，须要在solrconfig.xml配置相对应的RequestHandler，如：/update对应更新操做。
四：solrj的使用
建立好server之后，咱们就能够开始solrj操做索引库了！！
首先建立一个server，最好的方式是采用单例模式，不要重复去建立。
SolrServer server = new HttpSolrServer("http://HOST:8983/solr/");
一、添加文档到索引库
//建立一个文档
SolrInputDocument doc1 = new SolrInputDocument(); doc1.addField( "id", "id1", 1.0f ); doc1.addField( "name", "doc1", 1.0f ); doc1.addField( "price", 10 );
//再建立一个文档
SolrInputDocument doc2 = new SolrInputDocument(); doc2.addField( "id", "id2", 1.0f ); doc2.addField( "name", "doc2", 1.0f ); doc2.addField( "price", 20 );
//建立一个collection，把以上两个文档添加进去
Collection<SolrInputDocument> docs = new ArrayList<SolrInputDocument>(); docs.add( doc1 ); docs.add( doc2 );
//把文档添加到server中
server.add( docs );
//提交文档
server.commit();//此处只是提交到索引中，不会出如今搜索结果中；若是想立马搜索，请使用commit(boolean waitFlush, boolean waitSearcher)方法
若是你想添加到server后想快速提交（commit），能够采用以下方式：
UpdateRequest req = new UpdateRequest(); req.setAction( UpdateRequest.ACTION.COMMIT, false, false ); req.add( docs ); UpdateResponse rsp = req.process( server );
二、添加pojo到索引库
除了经过文档的形式提交之外，solrj还能够经过pojo的方式提交。使用注解@Field映射到schema.xml中定义的字段中
建立一个javaBean：
import org.apache.solr.client.solrj.beans.Field;
public class Item {
@Field
String id;
@Field("cat")//自定义字段名
String[] categories;
@Field
List<String> features;
public void setId(String id) {
this.id = id;
}
public void getId() {
return this.id;
}
//其余get、set方法
}
建立JavaBean的实例：
Item item = new Item();
item.id = "one";
item.categories = new String[] { "aaa", "bbb", "ccc" };
添加到server中：
server.addBean(item);
提交到索引：
server.commit();
还能够同时添加多个javaBean：
List<Item> beans ;
//add Item objects to the list
server.addBeans(beans);
三、删除索引
server.deleteById(String id); 或者 deleteById(List<String> ids);
四、更新索引
solr索引库不一样于数据库，没有更新的功能。若是想更新，先经过id删除对应的文档，再天新的文档。
五、查询索引
SolrQuery query = new SolrQuery(); query.setQuery( "*:*" ); query.addSortField( "price", SolrQuery.ORDER.asc ); QueryResponse rsp = server.query( query );
//文档方式读取
SolrDocumentList docs = rsp.getResults();//实际项目中若是业务比较复杂，采用这种方式显得比较灵活
//使用javaBean的方式读取
List<Item> beans = rsp.getBeans(Item.class);
六、高级使用
SolrServer server = getSolrServer();
SolrQuery solrQuery = new SolrQuery()
. setQuery("ipod")
. setFacet(true)
. setFacetMinCount(1)
. setFacetLimit(8)
. addFacetField("category")
. addFacetField("inStock");
QueryResponse rsp = server.query(solrQuery);
七、高亮显示
SolrQuery query = new SolrQuery(); query.setQuery("foo");
query.setHighlight(true).setHighlightSnippets(1);
//set other params as needed
query.setParam("hl.fl", "content");
QueryResponse queryResponse = getSolrServer().query(query);
处理高亮显示结果：
Iterator<SolrDocument> iter = queryResponse.getResults().iterator();
while (iter.hasNext()) {
SolrDocument resultDoc = iter.next();
String content = (String) resultDoc.getFieldValue("content");
String id = (String) resultDoc.getFieldValue("id"); //id is the uniqueKey field
if (queryResponse.getHighlighting().get(id) != null) {
List<String> highlightSnippets = queryResponse.getHighlighting().get(id).get("content");
}
}
本文出自 luoshengsha.com，转载时请注明出处及相应连接。