MyBatis 学习（一）入门

Mybatis介绍
MyBatis本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。
MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。

回顾下jdbc编程步骤：
- 加载数据库驱动

创建并获取数据库链接
创建jdbc statement对象
设置sql语句
设置sql语句中的参数(使用preparedStatement)
通过statement执行sql并获取结果
对sql执行结果进行解析处理
释放资源(resultSet、preparedstatement、connection)

jdbc问题总结如下：

数据库连接创建、释放频繁造成系统资源浪费，从而影响系统性能。如果使用数据库连接池可解决此问题。
Sql语句在代码中硬编码，造成代码不易维护，实际应用中sql变化的可能较大，sql变动需要改变java代码。
使用preparedStatement向占有位符号传参数存在硬编码，因为sql语句的where条件不一定，可能多也可能少，修改sql还要修改代码，系统不易维护。
对结果集解析存在硬编码（查询列名），sql变化导致解析代码变化，系统不易维护，如果能将数据库记录封装成pojo/bean对象解析比较方便。

MyBatis架构
这里写图片描述

mybatis配置
SqlMapConfig.xml，此文件作为mybatis的全局配置文件，配置了mybatis的运行环境等信息。
mapper.xml文件即sql映射文件，文件中配置了操作数据库的sql语句。此文件需要在SqlMapConfig.xml中加载。
通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂

由会话工厂创建sqlSession即会话，操作数据库需要通过sqlSession进行。

mybatis底层自定义了Executor执行器接口操作数据库，Executor接口有两个实现，一个是基本执行器、一个是缓存执行器。

Mapped Statement也是mybatis一个底层封装对象，它包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个MappedStatement对象，sql的id即是Mapped statement的id。

MappedStatement对sql执行输入参数进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。

Mappedstatement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。

入门案例（增删改查）

根据id查找用户

表结构如下
CREATE TABLE `user` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(32) NOT NULL COMMENT '用户名称',
  `birthday` date DEFAULT NULL COMMENT '生日',
  `sex` char(1) DEFAULT NULL COMMENT '性别',
  `address` varchar(256) DEFAULT NULL COMMENT '地址',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=27 DEFAULT CHARSET=utf8;

SqlMapConfig.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
   <!--
      environments 环境配置（数据库连接信息）
   和spring整合后 environments配置将废除 -->
   <environments default="development">
      <environment id="development">
         <!-- 使用jdbc事务管理 -->
         <transactionManager type="JDBC" />
         <!-- 数据库连接池 -->
         <dataSource type="POOLED">
            <property name="driver" value="com.mysql.jdbc.Driver" />
            <property name="url"
               value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8" />
            <property name="username" value="root" />
            <property name="password" value="root" />
         </dataSource>
      </environment>
   </environments>

   <!-- 告诉总配置文件  表配置文件在哪儿 -->
   <mappers>
      <mapper resource="sqlmap/User.xml"/>
   </mappers>

</configuration>

bean

public class User implements Serializable {
    /**
     *
     */
    private static final long serialVersionUID = 1L;
    private Integer id;
    private String username;// 用户姓名
    private String sex;// 性别
    private Date birthday;// 生日
    private String address;// 地址


    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getUsername() {
        return username;
    }
    public void setUsername(String username) {
        this.username = username;
    }
    public String getSex() {
        return sex;
    }
    public void setSex(String sex) {
        this.sex = sex;
    }
    public Date getBirthday() {
        return birthday;
    }
    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }
    public String getAddress() {
        return address;
    }
    public void setAddress(String address) {
        this.address = address;
    }
    @Override
    public String toString() {
        return "User [id=" + id + ", username=" + username + ", sex=" + sex
                + ", birthday=" + birthday + ", address=" + address + "]";
    }

}

user.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- namespace：命名空间，用于隔离sql，还有一个很重要的作用，后面会讲 -->
<!-- 写SQL语句 -->
<mapper namespace="test">
   <!-- 通过id查询一个用户
      id：用于识别方法调用时，调用哪个sql语句
      parameterType：参数类型
      resultType：返回结果类型 （包名+类名） 使用此属性要注意bean中属性与数据库中的要一致！
      #{} ：占位符，相当于jdbc的 ？
   -->
   <select id="findUserById" parameterType="Integer" resultType="cn.itcast.bean.User">
      select * from user where id = #{id}

      <!-- #{} 
parameterType是值类型里面随便添点东西，不写会报错 -->
   </select>

</mapper>

测试

package cn.itcast.MyBatis_day02;

import java.io.IOException;
import java.io.InputStream;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;

import cn.itcast.bean.User;
import junit.framework.TestCase;

public class AppTest  extends TestCase
{
   @Test
   public void testName () throws IOException
   {
      //加载核心配置文件
      String resource = "SqlMapConfig.xml" ;
      InputStream in = Resources.getResourceAsStream(resource) ;

      //创建SqlSessionFactory
      SqlSessionFactory ssf = new SqlSessionFactoryBuilder ().build(in) ;

      //创建SqlSession
      SqlSession sqlSession = ssf.openSession() ;

      //执行sql语句
      User user = sqlSession.selectOne("test.findUserById" , 1) ;

      System.out.println(user);

   }
}

根据用户名模糊查询

   <!--
      #{} 占位符 这种写法可以防止sql注入 (推荐第三种)
      ${} 字符串拼接 使用${} 里面只能填value
    -->
   <select id="findUserByName" parameterType="String" resultType="cn.itcast.bean.User">
      <!-- select * from user where username like #{name}  -->
      <!-- select * from user where username like '%${value}%'  -->
       select * from user where username like "%"#{name}"%"
   </select>

   //根据用户名查询用户信息
   @Test
   public void testName () throws Exception

   {
      String resource = "SqlMapConfig.xml" ;
      InputStream in = Resources.getResourceAsStream(resource) ;

      SqlSessionFactory ssf = new SqlSessionFactoryBuilder().build(in) ;

      SqlSession ss =  ssf.openSession() ;

//    User user =  ss.selectOne("test.findUserByName", "%三丰%");
      User user =  ss.selectOne("test.findUserByName", "三丰");

      System.out.println(user);
   }

#{}和${}

#{}表示一个占位符号，通过#{}可以实现preparedStatement向占位符中设置值，自动进行java类型和jdbc类型转换。#{}可以有效防止sql注入。 #{}可以接收简单类型值或pojo属性值。 如果parameterType传输单个简单类型值，#{}括号中可以是value或其它名称。


${}表示拼接sql串，通过${}可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换， ${}可以接收简单类型值或pojo属性值，如果parameterType传输单个简单类型值，${}括号中只能是value。
 parameterType和resultType

parameterType：指定输入参数类型，mybatis通过ognl从输入对象中获取参数值拼接在sql中。
resultType：指定输出结果类型，mybatis将sql查询结果的一行记录数据映射为resultType指定类型的对象。如果有多条数据，则分别进行映射，并把对象放到容器List中

 selectOne和selectList
selectOne查询一条记录，如果使用selectOne查询多条记录则抛出异常：
org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 3
   at org.apache.ibatis.session.defaults.DefaultSqlSession.selectOne(DefaultSqlSession.java:70)
selectList可以查询一条或多条记录。

**插入一条新数据**
-------

//添加
@Test
public void testInsert () throws Exception

{
String resource = “SqlMapConfig.xml” ;
InputStream in = Resources.getResourceAsStream(resource) ;

  SqlSessionFactory ssf = new SqlSessionFactoryBuilder().build(in) ;

  SqlSession ss =  ssf.openSession() ;

  User user = new User () ;
  user.setUsername("哈哈");
  user.setBirthday( new Date ());
  user.setSex("男");
  user.setAddress("d");

  int i = ss.insert("test.insertUser", user) ;

  //提交事务
  ss.commit();

}

<!-- #{username} 此时#{} 作用像是取值，从user对象取出username属性的值  -->
   <insert id="insertUser" parameterType="cn.itcast.bean.User">
      insert into User ( username , birthday , sex , address )values ( #{username} , #{birthday} , #{sex} , #{address} )
   </insert>


在插入新数据后，返回新数据的主键id
------------------

//添加
@Test
public void testInsert () throws Exception

{
String resource = “SqlMapConfig.xml” ;
InputStream in = Resources.getResourceAsStream(resource) ;

  SqlSessionFactory ssf = new SqlSessionFactoryBuilder().build(in) ;

  SqlSession ss =  ssf.openSession() ;

  User user = new User () ;
  user.setUsername("哈哈");
  user.setBirthday( new Date ());
  user.setSex("男");
  user.setAddress("d");

  int i = ss.insert("test.insertUser", user) ;

  //提交事务
  ss.commit();

  System.out.println(user.getId());

}

  <!-- #{username} 此时#{} 作用像是取值，从user对象取出username属性的值  -->
   <insert id="insertUser" parameterType="cn.itcast.bean.User">
      <!-- 获取刚刚插入新数据的主键id （这是一条SQL语句) -->
      <!-- selectKey 标签实现主键返回 -->
      <!-- keyColumn:主键对应的表中的哪一列 -->
      <!-- keyProperty：主键对应的pojo中的哪一个属性 -->
      <!-- order：设置在执行insert语句前执行查询id的sql，还是在执行insert语句之后执行查询id的sql -->
      <!-- resultType：设置返回的id的类型 -->
      <selectKey keyColumn="id" keyProperty="id" order="AFTER" resultType="Integer">
         select LAST_INSERT_ID()
      </selectKey>

      insert into User ( username , birthday , sex , address )values ( #{username} , #{birthday} , #{sex} , #{address} )
   </insert>


使用uuid实现主键
----------

思路：在insert之前执行
select uuid()得到uuid值 返回值填充到bean的id中，然后#{}取出即可

- <insert id="insert" parameterType="com.mawulou.model.Functions" >
-
-     <selectKey keyProperty="pkGlobalId" resultType="String" order="BEFORE">
-         select  uuid()
-     </selectKey>
-
-     insert into tbl_function (id, name, parent_id,
-       sort, url)
-     values (#{id}, #{name}, #{parentId},
-       #{sort}, #{url})
-   </insert>




## 更新数据 ##

<update id="updateUser" parameterType="cn.itcast.bean.User">
      update user set username = #{username} where id = #{id}
   </update>

//更新
      @Test
      public void testUpdate () throws Exception

      {
         String resource = "SqlMapConfig.xml" ;
         InputStream in = Resources.getResourceAsStream(resource) ;

         SqlSessionFactory ssf = new SqlSessionFactoryBuilder().build(in) ;

         SqlSession ss =  ssf.openSession() ;

         User user = new User () ;
         user.setUsername("呵呵");
         user.setId(27);
         ss.update("updateUser", user) ;

         //提交事务
         ss.commit();


         ss.close();
      }


删除数据

<delete id="deleteUser" parameterType="Integer">
      delete from user where id = #{id}
   </delete>


//删除
            @Test
            public void testDelete () throws Exception

            {
               String resource = "SqlMapConfig.xml" ;
               InputStream in = Resources.getResourceAsStream(resource) ;

               SqlSessionFactory ssf = new SqlSessionFactoryBuilder().build(in) ;

               SqlSession ss =  ssf.openSession() ;


               ss.delete("deleteUser", 29) ;

               //提交事务
               ss.commit();


               ss.close();
            }

    1. Mybatis解决jdbc编程的问题

.
数据库连接创建、释放频繁造成系统资源浪费从而影响系统性能，如果使用数据库连接池可解决此问题。
解决：在SqlMapConfig.xml中配置数据连接池，使用连接池管理数据库链接。

Sql语句写在代码中造成代码不易维护，实际应用sql变化的可能较大，sql变动需要改变java代码。
解决：将Sql语句配置在XXXXmapper.xml文件中与java代码分离。

向sql语句传参数麻烦，因为sql语句的where条件不一定，可能多也可能少，占位符需要和参数一一对应。
解决：Mybatis自动将java对象映射至sql语句，通过statement中的parameterType定义输入参数的类型。

对结果集解析麻烦，sql变化导致解析代码变化，且解析前需要遍历，如果能将数据库记录封装成pojo对象解析比较方便。
解决：Mybatis自动将sql执行结果映射至java对象，通过statement中的resultType定义输出结果的类型。

    1. mybatis与hibernate不同

Mybatis和hibernate不同，它不完全是一个ORM框架，因为MyBatis需要程序员自己编写Sql语句。mybatis可以通过XML或注解方式灵活配置要运行的sql语句，并将java对象和sql语句映射生成最终执行的sql，最后将sql执行的结果再映射生成java对象。
Mybatis学习门槛低，简单易学，程序员直接编写原生态sql，可严格控制sql执行性能，灵活度高，非常适合对关系数据模型要求不高的软件开发，例如互联网软件、企业运营类软件等，因为这类软件需求变化频繁，一但需求变化要求成果输出迅速。但是灵活的前提是mybatis无法做到数据库无关性，如果需要实现支持多种数据库的软件则需要自定义多套sql映射文件，工作量大。
Hibernate对象/关系映射能力强，数据库无关性好，对于关系模型要求高的软件（例如需求固定的定制化软件）如果用hibernate开发可以节省很多代码，提高效率。但是Hibernate的学习门槛高，要精通门槛更高，而且怎么设计O/R映射，在性能和对象模型之间如何权衡，以及怎样用好Hibernate需要具有很强的经验和能力才行。
总之，按照用户的需求在有限的资源环境下只要能做出维护性、扩展性良好的软件架构都是好架构，所以框架只有适合才是最好。
“`