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.二、lucene-core-6.4.二、lucene-highlighter-6.4.二、lucene-memory-6.4.二、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

 

总结：这次升级，虽然过程有点艰辛，但总算是作到尽善尽美。但愿这次的分享可以给有遇到相关问题的朋友们提供些许的帮助。