solr6.4.2之webservice兼容升级

摘要:这次solr底层升级是一次比较大的升级。从底层搜索引擎 solr4.8 升级到 solr6.4.2,由于solr底层从6.x开始以来的jdk必须指定为1.8,而且很多内部实现类都已经废弃或者干脆被砍掉了,这样就导致了很多实现类都需要进行兼容性的处理,第三方依赖的库也需要跟着进行升级改造。例如IK词库加载,就需要手动编译修改源代码,具体可以参考我的另外一篇博客:http://www.cnblogs.com/liang1101/articles/6395016.html 本篇主要是从应用实现、兼容修改以及项目发布遇到的问题和对应解决办法进行详细的讲解。
应用项目:公司内部自己搭建的一套对外提供webservice服务,提供相应的接口为各个项目组调用使用。该webservice服务底层使用spring容器管理、hibernate数据库连接管理的方式,结合 solr、lucene 相关依赖包所实现的系统。
起始背景:原始版本使用:eclipse4.3 + JDK1.7 + solr-solrj-4.8.0 + lucene-core-4.8.0 + spring-core2.5.6 等主要相关依赖包。当然还有相应的 lucene-queryparser、lucene-highlighter、lucene-memory、hibernate-core-4.3.0 以及 spring 很多相关包等等。
开始升级:
1. eclipse4.6.2,即下载的2017年1月最新eclipse版本,因为 eclipse4.6 开始才能支持 jdk1.8 的编译。具体下载地址可以到我的百度云盘上下载:http://pan.baidu.com/s/1hsJs2De
  当然,目前很多人已经使用了IntelliJ IDEA,目前我们也使用了该编辑器,这里提供我使用的版本 idea-15.0.6 下载地址: http://pan.baidu.com/s/1o7Ceyeu
2. jdk1.8.0_112,因为solr和lucene升级到当前6.4.0最高版本其底层依赖必须指定为jdk1.8,故需下载2017年1月最新jdk1.8稳定版本,具体下载地址可以到我的百度云盘上下载:
  服务器版本的jdk下载地址: http://pan.baidu.com/s/1boOCea7
  windows之64位系统的jdk下载地址: http://pan.baidu.com/s/1jIJoz4a
3. 用solr-solrj-6.4.2、lucene-core-6.4.2、lucene-highlighter-6.4.2、lucene-memory-6.4.2、lucene-queryparser-6.4.2,如果调用到solr核心类,则还需要引入:solr-core-6.4.2 这些包替换原有的 4.8.0 的包
4. 修改底层用到的方法新旧不兼容的代码(注意:这里只是我用到的方法和类,一定会有我没有遇到的,但是方法是相同的,查看对应的api都可以很easy的解决掉)
1. org.apache.solr.client.solrj.impl.HttpSolrServer 修改为:org.apache.solr.client.solrj.impl.HttpSolrClient

2. SolrClient solrClient = new CloudSolrClient(zkHost);
   new方式在新版已经被废弃,采用新版链式赋值法进行创建对象
   SolrClient solrClient = new CloudSolrClient.Builder().withZkHost(Arrays.asList(zkHost.split(","))).build();

3. solrClient = new ConcurrentUpdateSolrClient(url, queueSize, threadCount);
   采用链式赋值法
   solrClient = new ConcurrentUpdateSolrClient.Builder(url).withQueueSize(queueSize).withThreadCount(threadCount).build();

4. solrClient = new HttpSolrClient(baseURL);
   采用链式赋值法
   solrClient = new HttpSolrClient.Builder(baseURL).build();

5. ClusterState clusterState = zkStateReader.getClusterState();
   Map<String, Slice> map = clusterState.getActiveSlicesMap(collection);
   api已经将getActiveSlicesMap废弃
   map = clusterState.getCollection(collection).getActiveSlicesMap();

6. List<String> collections = zkStateReader.getAllCollections();
   api已经将getAllCollections()废弃掉
   Map<String, DocCollection> map = zkStateReader.getClusterState().getCollectionsMap();

7. Collection<Slice> slices = clusterState.getSlices(Collection);
   api已经将getSlices(collection)废弃,采用更加方便、安全的中间类DocCollection
   DocCollection docCollection = clusterState.getCollection(collection);
   Collection<Slice> slices = docCollection.getActiveSlices();

8. CollectionAdminRequest.Create req = new CollectionAdminRequest.Create();
   req.setCollectionName(name);
   req.setNumShards(numShards);
   req.setConfigName(cluster);
   req.setCreateNodeSet(getNodeSet(cluster));
   req.setReplicationFactor(numReplicas);
   修改为链式赋值法
   CollectionAdminRequest.Create req = CollectionAdminRequest.createCollection(name, cluster, numShards, numReplicas);

9. CollectionAdminRequest.Delete req = new CollectionAdminRequest.Delete();
   api已将这种创建方式废弃
   CollectionAdminRequest.Delete req = CollectionAdminRequest.deleteCollection(name);

10. CollectionAdminRequest.CreateAlias req = new CollectionAdminRequest.CreateAlias();
   api已经将这种创建方式废弃
   CollectionAdminRequest.CreateAlias req = CollectionAdminRequest.createAlias(name, collections);

11. CollectionAdminRequest.DeleteAlias req = new CollectionAdminRequest.deleteAlias();
   api已经将这种创建方式废弃
   CollectionAdminRequest.DeleteAlias req = CollectionAdminRequest.deleteAlias(name);

12. SolrInputDocument inputDocument = ClientUtils.toSolrInputDocument(solrDocument);
   将SolrDocument 转换为 SolrInputDocument 的方法从ClientUtils中移除了.从solr-5.5之后就将此方法移除,代码中要想使用此类似功能,需要自己添加方法实现
   /**
     * 将SolrDocument转换为SolrInputDocument,原底层提供的方法从solr5.5之后被废弃掉了
     * add by liangyongxing
     * @param solrDocument
     * @createTime 2017-02-21
     * @return
     */
    public static SolrInputDocument toSolrInputDocument(SolrDocument solrDocument) {
        SolrInputDocument doc = new SolrInputDocument();
        for (String name : solrDocument.getFieldNames()) {
            doc.addField(name, solrDocument.getFieldValue(name));
        }
        return doc;
    }
<1. 以上步骤做完,都会认为万事大吉了,因为此时整个工程没有报任何错误了,包括自己在本地可能运行和测试也是OK的。那么,此时我们按照正常的逻辑打包发布到线上环境启动,会发现起不起来,报错内容可能大致如下:
Unsupported major.minor version 52.0

以上这个错误对于有点经验的程序员来说都是很easy的问题,就是服务器上的jdk和咱们打包程序所使用的jdk版本不一致,很明显,本地使用的是jdk1.8而服务器上的是jdk1.7,具体可以通过命令:java -version 进行查看jdk版本。那么就好办了,直接下载或者拷贝都可以,将当前环境的jdk升级为18的即可,这个是很easy的我就不在这里啰嗦了。

<2. 做好之后再进行重启服务,发现怎么还不好使,大概报错如下所示:
具体的错误我就不粘贴了,省得有些同学会对号入座。翻译后大致意思为:容器初始化的时候不能够初始化我们所需要的对象,其中的关键字为:org.springframework.init......
看到这个错误,很明显是spring加载的问题,自然而然想到我们引用的spring是否是版本的问题,我的第一反应可能就是jdk1.8和spring2.5.6不兼容了,之后通过google、stakoverflow等相关网站查看发现还真是这个问题,在jdk1.8之后的spring建议最好使用spring-core-3.x的包,建议先不要使用4.x的包,因为4.x的包还需要jdk1.8不同版本的要求(需要有针对性的要求),开始我偏不信,尝试了4.x的包,最后发现似乎还真是有问题(补充一下,当时可能和我操作顺序有关,后来3.x没有问题了我就没有再尝试一次,稳妥起见建议还是3.x),我引入的spring的包具体如下:

spring-aop-3.2.13-RELEASE.jar、spring-beans-3.2.13-RELEASE.jar、spring-context-3.2.13-RELEASE.jar、spring-context-support-3.2.13-RELEASE.jar、spring-core-3.2.13-RELEASE.jar、spring-jdbc-3.2.13-RELEASE.jar、spring-orm-3.2.13-RELEASE.jar、spring-tx-3.2.13-RELEASE.jar、spring-web-3.2.13-RELEASE.jar等

<3. 以上两小步做完之后,再在Linux中重启tomcat服务,我了个天啊,怎么还有问题,我都要快奔溃了,之后硬着头皮继续google,发现是服务器的tomcat版本太低导致的。oh my god!!!,一个jdk1.8的升级怎么会引入这么多问题呢?但是没有办法,继续解决吧,上面可能会抛出一下这样大致的错误:
unable to process jar entry [......] from Jar[......] for annotations.
先介绍一下如何在Linux中查看当前tomcat的版本,到对应tomcat的安装目录下,执行 sh ./bin/version.sh 命令,会打印出当前tomcat对应的版本是多少。而上面的这个错误的原因是因为服务器的tomcat版本低于 apache-tomcat-7.0.59建议用户升级到 tomcat-7.0.61 以上(因为没有 tomcat-7.0.60 这个版本,当然 tomcat-7.0.59 开始就是好使的,如果你非要用 tomcat-7.0.59 也是可以的)。 最后升级为tomcat后重新启动服务,我的天啊,服务终于正常启动了。至此,这次搜索引擎底层webservice服务兼容升级完成
<4. 这里需要补充一点,当windows系统中spring包由2.5.6 —> 3.2.13版本后,对应的jdk版本由1.7升级到1.8后,对应ecllipse设置选项卡project Facets 右侧 Dynamic Web Module 级别默认会由原先的2.5自动升级到3.1了,如下图所示:
  
那么此时要求tomcat版本至少需要8.x,即需要从网上下载tomcat8.x版本方可在本地发布项目测试使用。或者使用我的百度云盘下载,下载tomcat-8.5.11地址为:http://pan.baidu.com/s/1pKBw23x
 
总结:此次升级,虽然过程有点艰辛,但总算是做到尽善尽美。希望此次的分享能够给有遇到相关问题的朋友们提供些许的帮助。
 
posted @ 2017-03-06 23:36  星火燎原智勇  阅读(878)  评论(1编辑  收藏