Mybatis學習總結（一）——入門基礎

一、Mybatis介紹

1.MyBatis是什么？

 　 MyBatis 本是apache的一個開源項目iBatis, 2010年這個項目由apache software foundation 遷移到了google code，並且改名為MyBatis，實質上Mybatis對ibatis進行一些改進。

　　MyBatis是一個優秀的持久層框架，它對jdbc的操作數據庫的過程進行封裝，使開發者只需要關注 SQL 本身，而不需要花費精力去處理例如注冊驅動、創建connection、創建statement、手動設置參數、結果集檢索等jdbc繁雜的過程代碼。

　　Mybatis通過xml或注解的方式將要執行的各種statement（statement、preparedStatemnt、CallableStatement）配置起來，並通過java對象和statement中的sql進行映射生成最終執行的sql語句，最后由mybatis框架執行sql並將結果映射成java對象並返回。

      MyBatis是一個支持普通SQL查詢，存儲過程和高級映射的優秀持久層框架。MyBatis消除了幾乎所有的JDBC代碼和參數的手工設置以及對結果集的檢索封裝。MyBatis可以使用簡單的XML或注解用於配置和原始映射，將接口和Java的POJO（Plain Old Java Objects，普通的Java對象）映射成數據庫中的記錄。

2.Mybatis框架圖

(1)、mybatis配置

SqlMapConfig.xml，此文件作為mybatis的全局配置文件，配置了mybatis的運行環境等信息。

mapper.xml文件即sql映射文件，文件中配置了操作數據庫的sql語句。此文件需要在SqlMapConfig.xml中加載。

(2)、通過mybatis環境等配置信息構造SqlSessionFactory即會話工廠。

(3)、由會話工廠創建sqlSession即會話，操作數據庫需要通過sqlSession進行。

(4)、mybatis底層自定義了Executor執行器接口操作數據庫，Executor接口有兩個實現，一個是基本執行器、一個是緩存執行器。

(5)、Mapped Statement也是mybatis一個底層封裝對象，它包裝了mybatis配置信息及sql映射信息等。mapper.xml文件中一個sql對應一個Mapped Statement對象，sql的id即是Mapped statement的id。

(6)、Mapped Statement對sql執行輸入參數進行定義，包括HashMap、基本類型、pojo，Executor通過Mapped Statement在執行sql前將輸入的java對象映射至sql中，輸入參數映射就是jdbc編程中對preparedStatement設置參數。

(7)、Mapped Statement對sql執行輸出結果進行定義，包括HashMap、基本類型、pojo，Executor通過Mapped Statement在執行sql后將輸出結果映射至java對象中，輸出結果映射過程相當於jdbc編程中對結果的解析處理過程。

二、Mybatis入門程序

1.需求：(1).根據用戶id（主鍵）查詢用戶信息 (2).根據用戶名稱模糊查詢用戶信息(3).添加用戶 4).刪除用戶(5).更新用戶

2.環境：java環境：JDK1.6，eclipse,Mysql5.1

3.工程目錄結構

4.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>
    <!-- 和spring整合后 environments配置將廢除-->
    <environments default="development">
        <environment id="development">
        <!-- 使用jdbc事務管理,事務控制由mybatis管理-->
            <transactionManager type="JDBC" />
        <!-- 數據庫連接池,由mybatis管理-->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/test?characterEncoding=utf-8" />
                <property name="username" value="root" />
                <property name="password" value="root" />
            </dataSource>
        </environment>
    </environments>
<!-- 加載映射文件 -->
    <mappers>
        <mapper resource="com/mybatis/mapping/User.xml"/>
    </mappers>
</configuration>

5.實體User.java內容

package com.mybatis.entity;

import java.util.Date;

/**
 * @ClassName: User
 * @Description: TODO(用戶實體)
 * @author lixiaoxi
 * @date 2015-6-27 下午1:56:02
 * 
 */
public class User {
    // 屬性名稱和數據庫字段名稱保持一致
    private Integer id;
    // 姓名
    private String username;
    // 性別
    private String sex;
    // 地址
    private String address;
    // 生日
    private Date birthday;

    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 String getAddress() {
        return address;
    }

    public void setAddress(String address) {
        this.address = address;
    }

    public Date getBirthday() {
        return birthday;
    }

    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }

    @Override
    public String toString() {
        return "User [id=" + id + ", username=" + username + ", sex=" + sex
                + ", address=" + address + ", birthday=" + birthday + "]";
    }

}

6.映射文件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">
<!-- 為這個mapper指定一個唯一的namespace，namespace的值習慣上設置成包名+sql映射文件名，這樣就能夠保證namespace的值是唯一的
例如namespace="com.mybatis.mapping.User"就是com.mybatis.mapping(包名)+User(User.xml文件去除后綴)
 -->
 <!-- namespace命名空間,作用就是對sql進行分類化的管理,理解為sql隔離
    注意:使用mapper代理開發時，namespace有特殊作用
 -->
<mapper namespace="com.mybatis.mapping.User">
    <!-- 在映射文件中配置很多sql語句 -->
    <!-- 需求：通過Id查詢用戶表的記錄 -->
    <!-- 通過SELECT執行數據庫查詢 
        id:標識映射文件中的sql，稱為statement的id;
            將sql語句封裝在mapperStatement的對象中，所以Id稱為Statement的id;
        parameterType:指定輸入參數的類型,這里指定int型
        #{}:表示一個占位符;
        #{id}:其中Id表示接收輸入的參數，參數名稱就是Id,如果輸入參數是簡單類型，#{}中的參數名可以任意，可以是value或者其它名稱;
        resultType:指定sql輸出結果所映射的java對象類型,select指定resultType表示將單條記錄映射成java對象。
    -->
    <select id="findUserById" parameterType="int" resultType="com.mybatis.entity.User">
        select username,DATE_FORMAT(birthday,'%Y-%m-%d')birthday,sex,address from t_user where id=#{id}
    </select>
    
    <!-- 根據用戶名稱模糊查詢用戶信息,可能返回多條數據
        resultType:指定的就是單條記錄所映射的java類型;
        ${}:表示拼接sql字符串，將接收到的參數內容不加任何修飾拼接在sql中.
            使用${}拼接sql，可能會引起sql注入
        ${value}:接收輸入參數的內容，如果傳入的是簡單類型,${}中只能使用value
     -->
    <select id="findUserByName" parameterType="java.lang.String" resultType="com.mybatis.entity.User" >
        select * from t_user where username LIKE '%${value}%'
    </select>

     <!-- 查詢所有用戶 -->
    <select id="getUserList" resultType="com.mybatis.entity.User">
        select username,birthday,sex,address from t_user 
    </select>
    
    <!-- 添加用戶 
      parameterType:指定輸入的參數類型是pojo(包括用戶信息);
      #{}中指定pojo的屬性名稱，接收到pojo對象的屬性值    ,mybatis通過OGNL(類似struts2的OGNL)獲取對象的屬性值
    -->
    <insert id="insertUser" parameterType="com.mybatis.entity.User">
       <!-- 
              將insert插入的數據的主鍵返回到User對象中;
           select last_insert_id():得到剛insert進去記錄的主鍵值，只適用於自增主鍵;
           keyProperty:將查詢到的主鍵值，設置到parameterType指定的對象的那個屬性
           order:select last_insert_id()執行順序，相對於insert語句來說它的執行順序。
           resultType:指定select last_insert_id()的結果類型;
       -->
       <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
           select last_insert_id()
       </selectKey>
       <!-- 
            使用mysql的uuid()，實現非自增主鍵的返回。
            執行過程:通過uuid()得到主鍵，將主鍵設置到user對象的Id的屬性中，其次，在insert執行時，從user對象中取出Id屬性值;
          <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">
              select uuid()
          </selectKey>
          insert into t_user (id,username,birthday,sex,address) values(#{id},#{username},#{birthday},#{sex},#{address})
       -->
       insert into t_user(username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address})
    </insert>
    
    <!-- 更新用戶 
        需要傳入用戶的Id和用戶的更新信息
        parameterType:指定User對象，包括Id和用戶的更新信息,注意：Id是必須存在的
        #{id}:從輸入的User對象中獲取Id的屬性值
    -->
    <update id="updateUser" parameterType="com.mybatis.entity.User">
        update t_user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address} 
        where id=#{id}
    </update>
    
    <!-- 刪除用戶 
        根據ID刪除用戶,需要輸入Id值
    -->
    <delete id="deleteUser" parameterType="java.lang.Integer">
        delete from t_user where id=#{id}
    </delete>
</mapper>

7.測試程序MybatisTest.java代碼

package com.mybatis.test;

import java.io.IOException;
import java.io.InputStream;
import java.util.Date;
import java.util.List;

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 com.mybatis.entity.User;

public class MybatisTest {
    
    // 根據Id查詢用戶信息，得到一條記錄結果
    @Test
    public void findUserByIdTest(){
        // mybatis的配置文件
        String resource = "SqlMapConfig.xml";
        InputStream inputStream = null;
        SqlSession sqlSession = null;
        try{
            inputStream = Resources.getResourceAsStream(resource);
             // 1.創建會話工場,傳入mybatis的配置文件信息
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            
             // 2.通過工廠得到SqlSession
            sqlSession = sqlSessionFactory.openSession();
            
            // 3.通過sqlSession操作數據庫
            // 第一個參數：映射文件中的statement的Id,等於namespace + "." + statement的id;
            // 第二個參數:指定和映射文件中所匹配的parameterType類型的參數;
            // sqlSession.selectOne結果是與映射文件所匹配的resultType類型的對象;
            // selectOne：查詢一條結果
            User user = sqlSession.selectOne("com.mybatis.mapping.User.findUserById",1);
            System.out.println(user.toString());
        }catch(IOException e){
            e.printStackTrace();
        }finally{
            if(sqlSession != null){
                sqlSession.close();
            }
            if(inputStream != null){
                try{
                    inputStream.close();
                }catch(IOException e){
                    e.printStackTrace();
                }
            }
        }
    }
    
    // 根據姓名模糊查詢用戶信息，得到一條或多條記錄結果
    @Test
    public void findUserByNameTest(){
        // mybatis的配置文件
        String resource = "SqlMapConfig.xml";
        InputStream inputStream = null;
        SqlSession sqlSession = null;
        try{
            inputStream = Resources.getResourceAsStream(resource);
             // 1.創建會話工場,傳入mybatis的配置文件信息
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            
             // 2.通過工廠得到SqlSession
            sqlSession = sqlSessionFactory.openSession();
            
            // 3.通過sqlSession操作數據庫
            // 第一個參數：映射文件中的statement的Id,等於namespace + "." + statement的id;
            // 第二個參數:指定和映射文件中所匹配的parameterType類型的參數;
            // sqlSession.selectList結果是與映射文件所匹配的resultType類型的對象;
            // list中的user和resultType類型一致
            List<User> list = sqlSession.selectList("com.mybatis.mapping.User.findUserByName","小");
            System.out.println(list);
        }catch(IOException e){
            e.printStackTrace();
        }finally{
            if(sqlSession != null){
                sqlSession.close();
            }
            if(inputStream != null){
                try{
                    inputStream.close();
                }catch(IOException e){
                    e.printStackTrace();
                }
            }
        }
    }
    
    // 添加用戶
    @Test
    public void insertUserTest(){
        // mybatis的配置文件
        String resource = "SqlMapConfig.xml";
        InputStream inputStream = null;
        SqlSession sqlSession = null;
        try{
            inputStream = Resources.getResourceAsStream(resource);
             // 1.創建會話工場,傳入mybatis的配置文件信息
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            
             // 2.通過工廠得到SqlSession
            sqlSession = sqlSessionFactory.openSession();
            //插入用戶的對象
            User user = new User();
            user.setUsername("小紅");
            user.setSex("1");
            user.setBirthday(new Date());
            user.setAddress("北京");
            // 3.通過sqlSession操作數據庫
            // 第一個參數：映射文件中的statement的Id,等於namespace + "." + statement的id;
            // 第二個參數:指定和映射文件中所匹配的parameterType類型的參數;
            sqlSession.insert("com.mybatis.mapping.User.insertUser",user);
            // 執行提交事務
            sqlSession.commit();
            //項目中經常需要 獲取新增的用戶的主鍵
            System.out.println(user.getId());
        }catch(IOException e){
            e.printStackTrace();
        }finally{
            if(sqlSession != null){
                sqlSession.close();
            }
            if(inputStream != null){
                try{
                    inputStream.close();
                }catch(IOException e){
                    e.printStackTrace();
                }
            }
        }
    }
    
    // 根據Id更新用戶信息
    @Test
    public void updateUserTest(){
        // mybatis的配置文件
        String resource = "SqlMapConfig.xml";
        InputStream inputStream = null;
        SqlSession sqlSession = null;
        try{
            inputStream = Resources.getResourceAsStream(resource);
             // 1.創建會話工場,傳入mybatis的配置文件信息
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            
             // 2.通過工廠得到SqlSession
            sqlSession = sqlSessionFactory.openSession();
            //更新用戶的信息
            User user = new User();
            user.setId(2);
            user.setUsername("小黑");
            user.setSex("2");
            user.setBirthday(new Date());
            user.setAddress("上海");
            // 3.通過sqlSession操作數據庫
            // 第一個參數：映射文件中的statement的Id,等於namespace + "." + statement的id;
            // 第二個參數:指定和映射文件中所匹配的parameterType類型的參數;
            sqlSession.update("com.mybatis.mapping.User.updateUser",user);
            // 執行提交事務
            sqlSession.commit();
        }catch(IOException e){
            e.printStackTrace();
        }finally{
            if(sqlSession != null){
                sqlSession.close();
            }
            if(inputStream != null){
                try{
                    inputStream.close();
                }catch(IOException e){
                    e.printStackTrace();
                }
            }
        }
    }
    
    // 根據Id刪除用戶
    @Test
    public void deleteUserTest(){
        // mybatis的配置文件
        String resource = "SqlMapConfig.xml";
        InputStream inputStream = null;
        SqlSession sqlSession = null;
        try{
            inputStream = Resources.getResourceAsStream(resource);
             // 1.創建會話工場,傳入mybatis的配置文件信息
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            
             // 2.通過工廠得到SqlSession
            sqlSession = sqlSessionFactory.openSession();

            // 3.通過sqlSession操作數據庫
            // 第一個參數：映射文件中的statement的Id,等於namespace + "." + statement的id;
            // 第二個參數:指定和映射文件中所匹配的parameterType類型的參數;
            //傳入Id，刪除用戶
            sqlSession.delete("com.mybatis.mapping.User.deleteUser",6);
            // 執行提交事務
            sqlSession.commit();
        }catch(IOException e){
            e.printStackTrace();
        }finally{
            if(sqlSession != null){
                sqlSession.close();
            }
            if(inputStream != null){
                try{
                    inputStream.close();
                }catch(IOException e){
                    e.printStackTrace();
                }
            }
        }
        
    }
}

8.數據庫所用sql腳本

CREATE TABLE t_user (
  id INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
  username VARCHAR(30) NOT NULL COMMENT '用戶名稱',
  birthday DATE DEFAULT NULL COMMENT '生日',
  sex CHAR(2) DEFAULT NULL COMMENT '性別',
  address VARCHAR(256) DEFAULT NULL COMMENT '地址'
);
INSERT INTO t_user (username,birthday,sex,address)
                                VALUES
                   ('小A','2015-06-27','2','北京'),
                   ('小B','2015-06-27','2','北京'),
                   ('小C','2015-06-27','1','北京'),
                   ('小D','2015-06-27','2','北京');

三、mybatis和Hibernate的本質區別與應用場景

hibernate：是一個標准ORM框架（對象關系映射），入門門檻較高的，不需要程序寫sql，sql語句自動生成了，對sql語句進行優化、修改比較困難的。

應用場景：

     適用與需求變化不多的中小型項目，比如：后台管理系統，erp、orm、oa。

mybatis：專注是sql本身，需要程序員自己編寫sql語句，sql修改、優化比較方便。mybatis是一個不完全的ORM框架，雖然程序員自己寫sql，mybatis 也可以實現映射（輸入映射、輸出映射）。

應用場景：

     適用與需求變化較多的項目，比如：互聯網項目。

四、小結

1.parameterType和resultType

parameterType:在映射文件中通過parameterType指定輸入參數的類型。

resultType:在映射文件中通過resultType指定輸出結果的類型

2.#{}和${}

#{}表示一個占位符號，#{}接收輸入參數，類型可以是簡單類型，pojo、hashmap;

如果接收簡單類型，#{}中可以寫成value或其它名稱;

#{}接收pojo對象值，通過OGNL讀取對象中的屬性值，通過屬性.屬性.屬性...的方式獲取對象屬性值。

 

${}表示一個拼接符號，會引用sql注入，所以不建議使用 表示一個拼接符號，會引用sql注入，所以不建議使用{}；

${}接收輸入參數，類型可以是簡單類型，pojo、hashmap;

如果接收簡單類型，${}中只能寫成value;

${}接收pojo對象值，通過OGNL讀取對象中的屬性值，通過屬性.屬性.屬性...的方式獲取對象屬性值。

3.selectOne()和selectList()

selectOne表示查詢出一條記錄進行映射。如果使用selectOne可以實現，那么使用selectList也可以實現（list中只有一個對象）。

selectList表示查詢出一個列表（多條記錄）進行映射。如果使用selectList查詢多條記錄，不能使用selectOne。如果使用selectOne會報錯。