solr client 简化solr编程

zidong

做solr的开发已经很长时间了，对于官方的solrj还是不是很满意，所以为了广大solrer能更方便的利用solr，个人封装了一些代码，算是一个小小的框架把，欢迎大家拍砖。
目前项目已经开源，地址：http://code.google.com/p/clientforsolr/
目前的功能：
1》对solr的commit，update，delete，optimize等进行了封装，提供了更加方便的操作；
2》对实体类到SolrInputDocument或者SolrDocument到实体类或者SolrDocument到SolrInputDocument提供了简单的转换；
3》提供了SolrServer更加便利的获取方法；
简单介绍，更多详情见http://code.google.com/p/clientforsolr/
例如：



Java代码 http://lianj-lee.javaeye.com/javascripts/syntaxhighlighter/clipboard_new.swf?clipboard=People%20p%20%3D%20new%20People()%3B%0Ap.setId(1)%3B%0Ap.setName(%221987%22)%3B%0Ap.setAge(22)%3B%0ASolrInputDocument%20sid%20%3D%20EntityConvert.entity2SolrInputDocument(p)%3B

• People p = new People();  
  
• p.setId(1);  
  
• p.setName("1987");  
  
• p.setAge(22);  
  
• SolrInputDocument sid = EntityConvert.entity2SolrInputDocument(p);
  

People p = new People(); p.setId(1); p.setName("1987"); p.setAge(22); SolrInputDocument sid = EntityConvert.entity2SolrInputDocument(p);
官方提供的 DocumentObjectBinder，如果实体类没有赋值的话，就可能会报错，但是大部分的时间，实体类的每个属性是不可能赋值的。
对于上述的转换，目前，solr的schema.xml的字段名要与实体类的属性名一致，并且提供setter和getter方法，只要满足以上两点即可转换。



Java代码 http://lianj-lee.javaeye.com/javascripts/syntaxhighlighter/clipboard_new.swf?clipboard=SolrDocument%20sd%20%3D%20new%20SolrDocument()%3B%0Asd.addField(%22id%22%2C%201)%3B%0Asd.addField(%22name%22%2C%20%221987%22)%3B%0Asd.addField(%22age%22%2C%2022)%3B%0APeople%20p%20%3D%20EntityConvert.solrDocument2Entity(sd%2C%20People.class)%3B

• SolrDocument sd = new SolrDocument();  
  
• sd.addField("id", 1);  
  
• sd.addField("name", "1987");  
  
• sd.addField("age", 22);  
  
• People p = EntityConvert.solrDocument2Entity(sd, People.class);  
  

SolrDocument sd = new SolrDocument(); sd.addField("id", 1); sd.addField("name", "1987"); sd.addField("age", 22); People p = EntityConvert.solrDocument2Entity(sd, People.class);
反向转换。
更多请参见api文档！
对于crud，也提供了更加方便的操作，



Java代码 http://lianj-lee.javaeye.com/javascripts/syntaxhighlighter/clipboard_new.swf?clipboard=%2F%2F%20%E5%88%A0%E9%99%A4%E6%89%80%E6%9C%89%E8%AE%B0%E5%BD%95%0Apublic%20void%20deleteAll(SolrServer%20server)%3B%20%0A%2F%2F%20%E5%88%A0%E9%99%A4idArrays%E6%95%B0%E7%BB%84%E4%B8%AD%E7%9A%84%E8%AE%B0%E5%BD%95%EF%BC%8C%E8%AF%A5%E6%95%B0%E7%BB%84%E4%B8%AD%E7%9A%84%E5%85%83%E7%B4%A0%E4%B8%BAdocument%E7%9A%84Id%EF%BC%8CidName%E4%B8%BA%E4%B8%BB%E9%94%AE%E5%90%8D%0Apublic%20void%20deleteById(Object%5B%5D%20idArrays%2C%20String%20idName%2C%20SolrServer%20server)%3B%0A%2F%2F%20%E5%88%A0%E9%99%A4%E5%8D%95%E4%B8%AAid%E8%AE%B0%E5%BD%95%0Apublic%20void%20deleteById(Object%20id%2C%20String%20idName%2C%20SolrServer%20server)%3B%0A%2F%2F%20%E5%88%A0%E9%99%A4%E6%9F%90%E4%B8%AA%E5%AF%B9%E8%B1%A1%EF%BC%8C%E8%AF%A5%E5%AF%B9%E8%B1%A1%E5%BF%85%E9%A1%BB%E6%9C%89id%0Apublic%20void%20deleteByExample(Object%20obj%2C%20String%20idName%2C%20SolrServer%20server)%3B%0A%2F%2F%20%E6%9B%B4%E6%96%B0%E4%B8%80%E4%B8%AA%E5%AF%B9%E8%B1%A1%EF%BC%8C%E4%B8%BB%E9%94%AE%E5%BF%85%E9%A1%BB%E6%8F%90%E4%BE%9B%EF%BC%8C%0Apublic%20void%20update(Object%20obj%2C%20String%20idName%2C%20SolrServer%20server)%3B%0A%2F%2F%20%E6%89%B9%E9%87%8F%E6%9B%B4%E6%96%B0%EF%BC%8CMap%E7%9A%84key%E4%B8%BAid%EF%BC%8Cvalue%E4%B8%BA%E8%A6%81%E6%9B%B4%E6%96%B0%E7%9A%84%E5%AF%B9%E8%B1%A1%0Apublic%20void%20update(Map%3CObject%2C%20Object%3E%20objMap%2C%20String%20idName%2C%20SolrServer%20server)%3B%0A%2F%2F%20%E6%89%B9%E9%87%8F%E6%8F%90%E4%BA%A4%E6%95%B0%E6%8D%AE%0Apublic%20void%20commit(List%3CObject%3E%20objectList%2C%20SolrServer%20server)%3B%0A%2F%2F%20%E6%8F%90%E4%BA%A4%E4%B8%80%E6%9D%A1%E8%AE%B0%E5%BD%95%0Apublic%20void%20commit(Object%20obj%2C%20SolrServer%20server)%3B%0A%2F%2F%20%20%E6%9F%A5%E8%AF%A2%E6%95%B0%E6%8D%AE%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%88%86%E9%A1%B5%E6%94%AF%E6%8C%81%EF%BC%8C%E7%AC%AC%E4%B8%80%E4%B8%AA%E5%8F%82%E6%95%B0%EF%BC%9ASolrParams%E5%B0%81%E8%A3%85%E4%BA%86%E6%9F%A5%E8%AF%A2%E5%8F%82%E6%95%B0%EF%BC%9B%E7%AC%AC%E4%BA%8C%E4%B8%AA%E5%8F%82%E6%95%B0%E8%A6%81%E6%9F%A5%E8%AF%A2%E7%9A%84%E7%B1%BB%EF%BC%9B%E7%AC%AC%E4%B8%89%E4%B8%AA%E5%8F%82%E6%95%B0%E8%B5%B7%E5%A7%8B%E8%AE%B0%E5%BD%95%EF%BC%9B%E7%AC%AC%E5%9B%9B%E4%B8%AA%E5%8F%82%E6%95%B0%E6%9F%A5%E8%AF%A2%E6%95%B0%E6%8D%AE%E9%87%8F%0Apublic%20%3CT%3EPaginationSupport%3CT%3E%20query(SolrParams%20params%2C%20Class%3CT%3E%20cls%2C%20int%20start%2C%20int%20rows%2C%20SolrServer%20server)%3B%0A%2F%2F%20%E6%9F%A5%E8%AF%A2%E6%95%B0%E6%8D%AE%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%88%86%E9%A1%B5%E6%94%AF%E6%8C%81%EF%BC%8C%E7%AC%AC%E4%B8%80%E4%B8%AA%E5%8F%82%E6%95%B0%EF%BC%9A%E6%9F%A5%E8%AF%A2%E7%9A%84%E5%AD%97%E7%AC%A6%E4%B8%B2%EF%BC%9B%E7%AC%AC%E4%BA%8C%E4%B8%AA%E5%8F%82%E6%95%B0%E8%A6%81%E6%9F%A5%E8%AF%A2%E7%9A%84%E7%B1%BB%EF%BC%9B%E7%AC%AC%E4%B8%89%E4%B8%AA%E5%8F%82%E6%95%B0%E8%B5%B7%E5%A7%8B%E8%AE%B0%E5%BD%95%EF%BC%9B%E7%AC%AC%E5%9B%9B%E4%B8%AA%E5%8F%82%E6%95%B0%E6%9F%A5%E8%AF%A2%E6%95%B0%E6%8D%AE%E9%87%8F%0Apublic%20%3CT%3EPaginationSupport%3CT%3E%20query(String%20keyword%2C%20Class%3CT%3E%20cls%2C%20int%20start%2C%20int%20rows%2C%20SolrServer%20server)%3B

• // 删除所有记录  
  
• public void deleteAll(SolrServer server);   
  
• // 删除idArrays数组中的记录，该数组中的元素为document的Id，idName为主键名  
  
• public void deleteById(Object[] idArrays, String idName, SolrServer server);  
  
• // 删除单个id记录  
  
• public void deleteById(Object id, String idName, SolrServer server);  
  
• // 删除某个对象，该对象必须有id  
  
• public void deleteByExample(Object obj, String idName, SolrServer server);  
  
• // 更新一个对象，主键必须提供，  
  
• public void update(Object obj, String idName, SolrServer server);  
  
• // 批量更新，Map的key为id，value为要更新的对象  
  
• public void update(Map objMap, String idName, SolrServer server);  
  
• // 批量提交数据  
  
• public void commit(List objectList, SolrServer server);  
  
• // 提交一条记录  
  
• public void commit(Object obj, SolrServer server);  
  
• //  查询数据，提供分页支持，第一个参数：SolrParams封装了查询参数；第二个参数要查询的类；第三个参数起始记录；第四个参数查询数据量  
  
• public PaginationSupport query(SolrParams params, Class cls, int start, int rows, SolrServer server);  
  
• // 查询数据，提供分页支持，第一个参数：查询的字符串；第二个参数要查询的类；第三个参数起始记录；第四个参数查询数据量  
  
• public PaginationSupport query(String keyword, Class cls, int start, int rows, SolrServer server);  
  

// 删除所有记录 public void deleteAll(SolrServer server);  // 删除idArrays数组中的记录，该数组中的元素为document的Id，idName为主键名 public void deleteById(Object[] idArrays, String idName, SolrServer server); // 删除单个id记录 public void deleteById(Object id, String idName, SolrServer server); // 删除某个对象，该对象必须有id public void deleteByExample(Object obj, String idName, SolrServer server); // 更新一个对象，主键必须提供， public void update(Object obj, String idName, SolrServer server); // 批量更新，Map的key为id，value为要更新的对象 public void update(Map objMap, String idName, SolrServer server); // 批量提交数据 public void commit(List objectList, SolrServer server); // 提交一条记录 public void commit(Object obj, SolrServer server); //  查询数据，提供分页支持，第一个参数：SolrParams封装了查询参数；第二个参数要查询的类；第三个参数起始记录；第四个参数查询数据量 public PaginationSupport query(SolrParams params, Class cls, int start, int rows, SolrServer server); // 查询数据，提供分页支持，第一个参数：查询的字符串；第二个参数要查询的类；第三个参数起始记录；第四个参数查询数据量 public PaginationSupport query(String keyword, Class cls, int start, int rows, SolrServer server);
更有提供了SolrServerFactory，更方便的获取SolrServerFactory，获取方式有两种：一种是通过配置文件中，提供SolrHome；第二种是通过程序中给定。
目前，还处于开发中，后续还有更多强大功能正在筹划中... ...