MyBatis快速入门

时间:2022-04-24
本文章向大家介绍MyBatis快速入门,主要内容包括概念、痛点、基本概念、基础应用、原理机制和需要注意的事项等,并结合实例形式分析了其使用技巧,希望通过本文能帮助到大家理解应用这部分内容。

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

概念

相对于全自动映射框架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文件中加一个空格或者空行然后保存 一般来说到此就可以排除错误了

参考文献

  1. 杨开振. 深入浅出MyBatis[M]. 北京:电子工业出版社, 2016.