最近在做的一个项目因为需要用到JDK1.8的一些组件所以需要对旧项目升级并转化为springboot的web项目分为以下几个步骤
1. maven依赖升级 对于大部分业务代码service和dao层spring是可以做到无缝兼容的,直接升级对面的依赖版本的就可以了 2. xml文件中bean的问题 在spring boot出现之前java web开发一般都是在webapp/WEB-INF下配置一个xml文件在里面定义各种bean和bean的依赖关系,如数据库连接配置信息,数据库连接池bean,mybatis的SqlSessionFactory等bean的依赖关系. 如何轻松复用xml文件中定义的bean呢?很简单 (1)xml文件放在resource目录下 (2)在springboot启动的类上添加注解@ImportResource({“classpath:XMLBeans.xml”"}),就可以轻松将xml中的bean托管到spring中 (3)检查各个配置项是否正确,项目能正常启动运行,如果成功启动,试试你的接口应该就能正常调用了,恭喜 但是还是一个问题没有解决,而且很难发现,只会在运行时期暴露出来,对于部分mybatis查询会报 Parameter '×××' not found. Available parameters are [0, 1, param1, param2]这个异常信息 3. mybatis高版本的兼容性问题 对于低版本的mybatis中极有可能存在通过#{0} #{1}的方式取参数,在spring boot支持的mybatis版本中 是不推荐,也不支持这种写法的,所以就给我们的迁移工作带来了巨大的困难,笔者经过分析源码得到关键点在(3.4.6t版本)的类org.apache.ibatis.reflection.ParamNameResolver#ParamNameResolver的第74行关键代码
// @Param was not specified. //74 if (config.isUseActualParamName()) { name = getActualParamName(method, paramIndex); }原来只需要把configuration的useActualParamName配置成false就支持#{0} #{1}取参数了 于是信心满满的在主配置文件中配置了mybatis.configuration.use-actual-param-name=false 但是一运行发现还是依旧报错,很奇怪.于是追踪了org.apache.ibatis.session.Configuration的构造过程 发现springboot在启动也确实将构造的Configuration的useActualParamName设置成了false,但是在 调用时上文中74行依旧是true为什么还是不生效呢?然后笔者又追踪了mybati接口调用过程中的org.apache.ibatis.binding.MapperProxy,发现其中的configuration对象和之前那个configuration对象的 hashCode居然不一致,我恍然大悟原来是因为xml中的configuration对象的useActualParamName依旧是 true,所以解决的方式就是在xml中配置上bean
<!--spring boot 会根据properties文件创建一个configuration,和xml中定义的configuration是两个对象 所以properties中的 mybatis.configuration.use-actual-param-name对xml中的不会生效所以需要手动指定--> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dynamicDataSource"/> <property name="configuration" ref="conf"/> </bean> <bean id="conf" class="org.apache.ibatis.session.Configuration"> <property name="useActualParamName" value="false"/><!--false是才能在高版本的mybatis中兼容旧代码中的#{0}写法--> </bean>编译,运行,调用ok,完美升级旧的项目,不改业务代码完成迁移 后记 在带个追踪过程中,网上可参考的资料也没什么太大价值,主要还是通过debug源码来分析追踪,所以对 源码体系的掌握对解决一些其他人没有遇到过的问题是很有帮助了,如果不阅读源码这个问题是没办法找到解决的方案的
