Spring + SpringMVC + Druid + MyBatis 给你一个灵活的后端解决方案

micromax

　　   生命不息，折腾不止。
　　   折腾能遇到很多坑，填坑我理解为成长。
　　   两个月前自己倒腾了一套用开源框架构建的 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 插件。


web.xml

pom.xml
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>
　　  需要逆向工程时，手动启动插件即可。