myBatis入门

1. mybatis

---

  1.1 mybatis本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation迁移到了google code，并且改名为MyBatis。2013年11月迁移到Github。
      mybatis是一个基于Java的持久层框架(半自动)，主要包括SQL Maps和Data Access Objects（DAO）
  1.2 MyBatis是支持普通SQL查询，存储过程和高级映射的优秀持久层框架。MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。
      MyBatis使用简单的 XML或注解用于配置和原始映射，将接口和 Java 的POJOs（Plain Old Java Objects，普通的 Java对象）映射成数据库中的记录。

     ORM(Object Relational Mapping):对象关系映射
     理解为：Java对象与数据库表的映射管理框架
 
  1.3 每个MyBatis应用程序主要都是使用SqlSessionFactory实例的，一个SqlSessionFactory实例可以通过SqlSessionFactoryBuilder获得。
      SqlSessionFactoryBuilder可以从一个xml配置文件或者一个预定义的配置类的实例获得。 
    
    mybatis：ORM框架，持久层框架
    mybatis.xml（定义了mybatis的基本配置和连接数据库的配置信息）
    SqlSessionFactoryBuilder完成mybatis.xml配置文件的加载操作
    SqlSessionFactoryBuilder --> SqlSessionFactory实例
    SqlSessionFactory --> SqlSession
    SqlSession -> 数据库层面增删改查操作

mybatis与hibernate的区别

---

   两者均为ORM框架，但也有一些不同
   mybatis                              hibernate
   轻量级                               重量级
   半自动化                             全自动化
   sql                                  hql(但也可以使用sql，但违背了hibernate的初衷)
   扩展性、迁移性比较差                 无缝移植

如何在项目中添加mybatis支持

---

 1 使用maven创建项目，并添加web支持

 2 添加相关依赖
      junit 4.12
      javax.servlet-api 4.0.0
      mybatis 3.4.5
      mysql-connector-java 5.1.44

  3 添加Mybatis插件“mybatis plugins”
      以离线方式安装“mybatis plugins”

  4 mybatis核心文件配置
      mybatis.cfg.xml(使用mybatis plugins插件创建)
      jdbc.properties
      
  5 mybatis日志配置(log4j2)
      log for java
      Mybatis内置的日志工厂提供日志功能，具体的日志实现有以下几种工具：
      SLF4J 
      Apache Commons Logging 
      Log4j 2 
      Log4j 
      JDK logging

      本案例使用log4j2
      1. 添加log4j2相关依赖
         log4j2.pom.txt

      2. 将log4j2.xml复制到resources目录下

      3. 修改mybatis.cfg.xml文件的日志配置
         <setting name="logImpl" value="LOG4J2"/>

      4. web项目还需要修改web.xml文件添加日志开关
         <!-- 禁止自动初始化log4j2 -->
     <context-param>
        <param-name>isLog4jAutoInitializationDisabled</param-name>
        <param-value>false</param-value>
     </context-param>

6 运行工具类MybatisSessionFactoryUtils进行测试

ssm与ssh2开发对比

---

   ssh2/自定义MVC                    ssm       
   action                         controller
   biz                            service
   dao                            mapper
     IXxxDAO.java(接口)             XxxMapper.java(接口) 
     XxxDAOImpl.java(实现类)        XxxMapper.xml
   entity                         model
     Xxx.java                       Xxx.java
                                    
   
                                  注1：自动生成持久层代码
                                  注2：接口中的方法必须与XxxMapper.xml中标签中的id属性匹配
                                  注3：XxxMapper.java(接口)中的方法只允许一个参数
                                  注4：利用OGNL表达式来传递参数
                                  注5：resultMap==>result mapping
                                  注6：resultMap id
                                       result property
                                       resultMap="row"
                                  注7：Selective，已存在，动态sql

使用MyBatis-generator自动生成MyBatis代码

---

   Xxx.java
   XxxMapper.java
   XxxMapper.xml

 1 MAVEN中使用mybatis-generator-maven-plugin插件
      因为IntelliJ中没有mybatis-generato对应的插件，所以需要在MAVEN中使用 mybatis-generator-maven-plugin插件来完成功能
      添加mybatis-generator-maven-plugin插件相关依赖：mybatis-generator-maven-plugin.pom.txt

 2 配置generatorConfig.xml
      resources下建generatorConfig.xml,作为mybatis-generator-maven-plugin插件的执行目标

3 在Intellij IDEA添加一个“Run运行”选项，使用maven运行mybatis-generator-maven-plugin插件
      命令：mybatis-generator:generate -e
      
  注1：XxxMapper.xml中的ID要与XxxMapper.java接口中的方法一致  
  注2：XxxMapper.java接口的方法，均只能定义一个参数
  注3：使用Mybatis-generator时出现以下错误：“ Column name pattern can not be NULL or empty”
       错误产生的原因是因为使用了高版本的mysql驱动，请使用较低版本的mysql驱动
  注4：IDEA配置使用Mybatis出现 “Could not find resource”
       问题：在编译后的target文件夹下，发现只有mapper的class文件，而没有xml文件，
       将对应的xml文件放到这个文件夹下运行就不会出现下面的错误。说明出现这个错误的原因是maven编译时没有将xml文件放进去。
       解决方法：在pom.xml中添加如下代码
      
  注5：resource jdbc.properties does not exist
       问题：在编译后的target文件夹下，而没有jdbc.properties文件，但同时不能少了*.xml
     
   

6. 业务层代码编号(Biz/Service)

7. junit4单元测试
   SqlSession.getMapper(BookMapper.class);
   sqlSession.commit();//mybatis默认也是手动事务