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

生命不息，折腾不止。

折腾能遇到很多坑，填坑我理解为成长。

两个月前自己倒腾了一套用开源框架构建的 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>

需要逆向工程时，手动启动插件即可。