MyBatis快速入门

用户1216676

发布于 2018-01-24 16:31:18

8450

发布于 2018-01-24 16:31:18

文章被收录于专栏：熊二哥

这部分内容不是很多，主要在于具体的应用，之后会针对痛点持续更新。

概念

相对于全自动映射框架Hibernate，MyBatis是一个半自动映射框架，其需要提供的映射文件需要三部分：SQL、映射规则、POJO，对于一般的项目来说，Hibernate或Spring的SPA更加简单方便，而对于大型项目，MyBatis更为合适，因为大型项目的存续期长，对性能要求更高，简单易维护显得非常重要（快速上手），其核心组件如下所示。

SqlSessionFactoryBuilder：根据配置信息生成SqlSessionFactory。
SqlSessionFactory：依靠工厂来生成SqlSession会话。
SqlSession：是一个既可以发送SQL执行，也可以获取Mapper接口。
SQL Mapper：它由Java接口和XML（或注解）构成，需要给出对应的SQL和映射规则，负责发送SQL去执行，并返回结果。

在Mybatis中，可以使用关键字来组装SQL:if判断语句；choose(when, otherwise)多条件分支语句；trim(where, set)辅助元素；foreach循环语句，用于in语句中。在当前流行的SpringBoot框架中，对MyBatis的整合那就显得更加便捷了，首先添加如下maven配置。

    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>1.3.0</version>
    </dependency>

之后在application.properties文件中，添加如下配置即可

#db
#4 base paras
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/user?characterEncoding=UTF-8
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

#mybatis
#mybatis.mapperLocations=classpath:mappers/*.xml

Tip: 此外，Mybatis还支持插件等功能，更加详细的资料，请参加MyBatis官网。

痛点

MyBatis的查询非常清晰有效，但是否提供update,insert,delete和selectByPK的通用组件？这部分mybatis主要通过mybatis-generator来处理，做好对应配置就好，细节上可以只选择自己需要的模板方法。 mybatis-generator-gui: http://www.cnblogs.com/kankan1218/p/6142819.html
通过查阅网上资料，最推荐的使用方法仍然是xml配置的方法，注解虽然支持但并不推荐，因为当查询复杂时，注解的可读性会严重下降。使用后发现，使用mybatisxml还是比较简单的帅帅哒。
实践整合统一的数据库连接服务。 @Configuration @EnableTransactionManagement @MapperScan("com.bjork.ws.dao") public class DataSourceConfig { @Bean public DataSource dataSource(DalDataSourceFactory factory) throws Exception { return factory.createDataSource("xx_insert_1"); } @Bean public DalDataSourceFactory dataSourceFactory() { return new DalDataSourceFactory(); } }

此外，applicaiton.yml中关于mybatis的配置如下所示

    mybatis:
      mapper-locations: classpath*:com/bjork/ws/dao/mapper/*.xml
      configuration:
        map-underscore-to-camel-case: true
        auto-mapping-unknown-column-behavior: NONE

在发布时，有一个比较大的坑,maven默认不会编译源文件的中.xml代码，一定要再build中添加对应配置。

<resources>  
    <resource>  
        <directory>src/main/java</directory>  
        <includes>  
            <include>**/*.xml</include>  
        </includes>  
        <filtering>true</filtering>  
    </resource>  
</resources>

如果出现mybatis绑定错误： org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)

一般的原因是Mapper interface和xml文件的定义对应不上，需要检查包名，namespace，函数名称等能否对应上，需要比较细致的对比，我经常就是写错了一两个字母搞的很长时间找不到错误按以下步骤一一执行： 1：检查xml文件所在的package名称是否和interface对应的package名称一一对应 2：检查xml文件的namespace是否和xml文件的package名称一一对应 3：检查函数名称能否对应上 4：去掉xml文件中的中文注释 5：随意在xml文件中加一个空格或者空行然后保存一般来说到此就可以排除错误了

参考文献