生命不息,折腾不止。
折腾能遇到很多坑,填坑我理解为成长。
两个月前自己倒腾了一套用开源框架构建的 JavaWeb 后端解决方案。
Spring + SpringMVC + Druid + JPA(Hibernate impl) 给你一个稳妥的后端解决方案
引入到项目组后经过几番打磨,现在也出落的有模有样。
最近将工程中的 Hibernate 换了换 Mybatis 试试,毕竟人都需要新鲜感。
我 Hibernate 接触的要比 MyBatis 早,作为最流行的两 ORM 框架,个人认为其中很多思想都相通。
但 MyBatis 特有的 ResultMap 构想,能进行更为细致的 SQL 调整和优化。
在开发社区、版本更新速度、支持的工具上,Hibernate 比 MyBatis 更胜一筹。
项目 Git 地址:https://git.oschina.net/LanboEx/sdm
1.方案整体一览
由 Controller 层接受前端参数并响应请求,携带数据跳转页面。
Controller 层注入 ServiceInter, ServiceImpl 层组织业务数据。
ServiceImpl 层注入 Mybatis Mapper, Mapper 进行数据的访问。
和 Hibernate 类似整个 dao 层,都可以由工具生成,工程中使用的是 org.mybatis.generator 插件。
2.遇到的坑
浅坑这里就不说了,下面梳理比较深的几个坑。
如果你以前遇到过这些问题,并且有比我还完美的解决方法,请赐教。
a. MapperScannerConfigurer 提前初始化导致 spring 注入配置文件失效
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.rambo.sdm.dao.inter"/>
<property name="sqlSessionFactory " ref="sessionFactory"/>
</bean>
因为希望 Spring 能扫描 Mapper 接口类加载 Mapper.xml 并自动生成实现代理类,注入到相应的 ServiceImpl 中。
刚开始配置如上,但是发现 Spring 无法正常加载配置文件中的信息。
也就是用 ${jdbc.username} 这样之类的表达式,无法获取到 properties 文件里的内容。
几次尝试未果之后,发现 MapperScannerConigurer 实际是在解析加载 bean 定义阶段,这个时候设置 sqlSessionFactory 的话。
会导致提前初始化一些类,PropertyPlaceholderConfigurer 还没来得及替换定义中的变量,导致把表达式当作字符串复制了。
将 sqlSessionFactory 替换为 sqlSessionFactoryBeanName 问题解决,配置如下:
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="basePackage" value="com.rambo.sdm.dao.inter"/>
<property name="sqlSessionFactoryBeanName" value="sessionFactory"/>
</bean>
b. dao 层数据表主键自动生成
在编写工程例子运行后,发现提示错误 UUID 不为 NUll。
自动生成的 mapper.xml 中,对于主键(自增序列/uuid)需要自己配置,这点确实有点 low。
自己配置就自己配置吧,mapper.xml 中 UUID 配置如下:
<selectKey keyProperty="uuid" resultType="String" order="BEFORE">
select replace(uuid(),'-','') UUID
</selectKey>
假设项目推进中,生成数据表配置文件后需要研发手动在 mapper.xml 的新增方法中添加主键生成策略,不仅繁琐而且出问题的概率极大。
试着摸索有没有什么统一配置的地方,发现了一种但还是不够完美。统一配置在 generatorConfig.xml 生成表的地方:
<table tableName="user" domainObjectName="UserPO">
<generatedKey column="uuid" sqlStatement="SELECT REPLACE(UUID(),'-','') UUID FROM DUAL"/>
</table>
主键生成策略使用 SQL 语句这点,就注定 Mybatis 在数据库移植方面无法尽善尽美。
c. maven 编译后未将 xml 文件编译到 class文件夹下
工程中需要输出到编译目录的配置文件有两部分,各数据表 mapper.xml 和 框架之间的各种各种的 .xml/.properties。
编译运行时报错:org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)
说是未绑定? 辗转半天,发现 mapper.xml 没有被编译到对应的文件夹下。
maven build --> resources 节点下新增子 resource 子节点:
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
添加子节点后,mapper.xml 确实编译到对应的文件夹下了,但工程中原 Resources 下的文件没有像以前一样编译到 classes 下。
maven build --> resources 节点下继续新增子 resource 子节点后解决:
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.xml</include>
<include>**/*.properties</include>
</includes>
<filtering>true</filtering>
</resource>
d. jetty 插件启动web 项目时,会同时启动 mybatis 逆向工程插件
当使用 jetty:run 启动 web 项目后,总会有莫名其妙的问题。
报错君是这样的:java.lang.IllegalArgumentException: Result Maps collection already contains value for com.rambo.sdm.dao.inter.UserPOMapper.BaseResultMap
顺着启动日志发现,每次 jetty:run 时,mybatis.generator 插件会先运行,并逆向数据库工程。
逆向生成就逆向生成吧,按道理需要生成的东西已经存在的话,跳过即可。
generator 插件运行机制还是有点问题的,生成的类它跳过,但配置文件会将内容追加进去,所以才有了上述那个报错。
移除 generator 插件 executions --> execution 下 goals 子节点问题得以解决。
<executions>
<execution>
<id>Generate MyBatis Artifacts</id>
</execution>
</executions>
需要逆向工程时,手动启动插件即可。