1、概述

MyBatis 本是apache的一個開源項目iBatis, 2010年這個項目由apache software foundation 遷移到了google code，而且更名爲MyBatis 。2013年11月遷移到Github。html

MyBatis 是一款優秀的持久層框架，它支持定製化 SQL、存儲過程以及高級映射。MyBatis 避免了幾乎全部的 JDBC 代碼和手動設置參數以及獲取結果集。MyBatis 可使用簡單的 XML 或註解來配置和映射原生信息，將接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java對象)映射成數據庫中的記錄。java

優勢：mysql

1. 簡單易學，自己比較小巧。
2. 不屏蔽SQL語句,咱們能夠根據本身的需求去編寫優化SQL語句。
3. 映射機制十分靈活，支持動態SQL、存儲過程。
4. 映射器建立簡單，只需一個接口和一個XML文件便可。

缺點：
須要手動編寫SQL語句和映射規則，某些狀況下會加大工做量web

官網幫助文檔：http://www.mybatis.org/mybatis-3/zh/index.htmlsql

2、四大核心組件

• SqlSessionFactoryBuilder(構造器)： 根據配置或代碼生成SqlSessionFactory,採用分步構建的Builder模式，建立成功SqlSessionFactory後就失去了做用。
• SqlSessionFactory(工廠接口)：使用它來生成SqlSession接口對象，使用工廠模式。你能夠認爲它是一個數據庫鏈接池，爲了不它被屢次建立，消耗數據庫資源，通常咱們採用單例模式建立，存活於整個mybatis中。
• SqlSession(會話)：便可發送SQL執行返回結果，又可獲取mapper的接口。至關於一個數據庫鏈接對象，能夠在一個事務裏面執行多條SQL，經過commit、rollback進行提交或回滾事務。存活於一個業務邏輯中，處完成後爲避免消耗數據庫資源，可使用try…catch…finally確保將其關閉，
• SQL Mapper(映射器)：由一個Java接口和XML文件（或註解）構成。根據編寫的SQL和映射規則，實現對數據庫的訪問，並返回結果。存活於一個請求中，一但請求完畢後，就會廢棄。

一、SqlSessionFactory的建立

SqlSessionFactory能夠經過兩種方式進行建立，一種是java代碼生成，一種是讀取XML配置文件生成。通常你們都使用XML模式進行建立，由於修改時比較方便，方便往後的管理，其次看起來也比較直觀。數據庫

XML文件建立：

這是一個簡單mybatis的配置文件，只配置了數據庫。通常都是以mybatis-config.xml命名apache

<?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>
    <!--數據庫環境 -->
    <properties resource="jdbc.properties"/>
   <environments default="development">
       <environment id="decelopment">
           <transactionManager type="JDBC" />
           <dataSource type="POOLED">
               <property name="driver" value="com.mysql.jdbc.Driver"/>
               <property name="url" value="jdbc:mysql://localhost:3306/mybatis_studydb"/>
               <property name="username" value="root"/>
               <property name="password" value=""/>
           </dataSource>
       </environment>
   </environments>
</configuration>

有了數據庫環境，咱們就能夠簡單生成SqlSessionFactory了數組

// 配置文件放到了resources文件夾中
// 若是你放到了一個包中，你能夠這樣找到它 com/lzx/config/mybatis-config.xml
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);//讀取配置文件
MySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

java代碼建立

// 配置數據庫
PooledDataSource dataSource = new PooledDataSource();
dataSource.setDriver("com.mysql.jdbc.Driver");
dataSource.setUrl("jdbc:mysql://localhost:3306/mybatis_studydb");
dataSource.setUsername("root");
dataSource.setPassword("");
// 關閉事務的自動提交
dataSource.setDefaultAutoCommit(false);
// 採用Mybatis的JDBC的事務方式
TransactionFactory transactionFactory = new JdbcTransactionFactory();
Environment environment = new Environment("development", transactionFactory, dataSource);
Configuration configuration = new Configuration(environment);
// 加入映射器
configuration.addMapper(BlogMapper.class);
// 建立SqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration)

二、掌握SqlSession的使用

mybatis中SqlSession是它的核心接口，有兩個實現類：DefaultSqlSession和SqlSessionManager,其中DefaultSqlSession是在單線程中使用的，SqlSessionManager是在多線程中使用的。緩存

SqlSession共有一下三個做用:服務器

1. 獲取Mapper接口

2. 發送SQL給數據庫

3. 控制數據庫事務

   //這裏的sqlSessionFactory是上面SqlSessionFactory建立出來的·
    SqlSession session =  sqlSessionFactory.openSession();
    try {
        // do work
        sqlSessionFactory.commit();
    } catch (Exception e){
        sqlSessionFactory.rollback();  
    } finally {
        session.close();
    }

三、瞭解映射器

映射器是MyBtis中最爲重要、最複雜的組件。能夠經過XML文件和註解的形式去實現。能夠用來配置如下內容：

• 描述映射規則
• 編寫SQL語句，能夠配置參數類型、返回類型、緩存刷新等信息。
• 支持動態SQL
• 配置緩存

這裏咱們暫時先了解一下它，由於它最爲重要，咱們之後會單獨去學習掌握。

映射器接口：

@Repository
public interface BillingInfoDAO {
    BillingInfoEntity queryById(int id);
}

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="com.lzx.dao.BillingInfoDAO">
    <select id="queryById" resultType="com.lzx.entity.BillingInfoEntity">
      select invoice_id,billing_address,billing_city,billing_state,
      billing_country,billing_postalcode from invoice where invoice_id=#{id}
    </select>
</mapper>

註解實現映射器：

public interface BillingInfoDAO {
	//這裏不推薦使用，較爲複雜的sql語句不便於管理
	@select(select invoice_id,billing_address,billing_city,billing_state,
      billing_country,billing_postalcode from invoice where invoice_id=#{id})
    BillingInfoEntity queryById(int id);
}

3、掌握MyBatis配置文件

瞭解MyBatis配置文件的全部元素

<?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>
    <properties /> <!--屬性-->
    <settings /> <!--設置-->	        
    <typeAliases /> <!--類型別名-->
    <typeHandlers /> <!--類型處理器-->
    <objectFactory /> <!--對象工廠-->
    <environments > <!--配置環境-->
        <environment > <!--環境配置-->
            <transactionManager ></transactionManager> <!--事務管理器-->
            <dataSource></dataSource> <!--數據源-->
        </environment>
    </environments> 
    <databaseIdProvider /> <!--數據庫廠商-->
    <mappers /> <!--映射器-->
</configuration>

接下來咱們開始掌握這些元素的使用,接下來的全部配置都是在configuration裏面完成的,注意這些元素的順序必定要按照上面的順序，不可隨意放置， MyBatis的配置文件通常以mybatis-config.xml來命名，放置到類的加載路徑下。

一、porperties屬性

<!-- 經過porpert的子元素來進行數據庫鏈接的相關配置-->
<properties>
    <property name="jdbc.driver" value="com.mysql.jdbc.Driver" />
    <property name="jdbc.url" value="jdbc:mysql://localhost:3306/mybatis_studydb" />
    <property name="jdbc.username" value="root" />
    <property name="jdbc.password" value="123456" />
</properties>

<environments default="development">
    <environment id="decelopment">
        <transactionManager type="JDBC" />
        <dataSource type="POOLED">
            <property name="driver" value="${jdbc.driver}"/>
            <property name="url" value="${jdbc.url}"/>
            <property name="username" value="${jdbc.username}"/>
            <property name="password" value="${jdbc.password}"/>
        </dataSource>
    </environment>
</environments>

爲了方便管理，咱們通常使用properties文件進行數據庫的鏈接配置。建立jdbc.properties文件，放置classpath路徑下。方便咱們配置數據庫。

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis_studydb
jdbc.username=root
jdbc.password=123456

接下來咱們就能夠把properties和它的子元素進行替換便可

<properties resource="jdbc.properties"/>

二、settings設置

settings是 MyBatis 中極爲重要的調整設置，它們會改變 MyBatis 的運行時行爲。大部分狀況下保持默認值運行便可。

一個配置完整的 settings 元素的示例以下：

<settings>
  <setting name="cacheEnabled" value="true"/>
  <setting name="lazyLoadingEnabled" value="true"/>
  <setting name="multipleResultSetsEnabled" value="true"/>
  <setting name="useColumnLabel" value="true"/>
  <setting name="useGeneratedKeys" value="false"/>
  <setting name="autoMappingBehavior" value="PARTIAL"/>
  <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
  <setting name="defaultExecutorType" value="SIMPLE"/>
  <setting name="defaultStatementTimeout" value="25"/>
  <setting name="defaultFetchSize" value="100"/>
  <setting name="safeRowBoundsEnabled" value="false"/>
  <setting name="mapUnderscoreToCamelCase" value="false"/>
  <setting name="localCacheScope" value="SESSION"/>
  <setting name="jdbcTypeForNull" value="OTHER"/>
  <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>

下面是settings配置項的詳細說明：

三、typeAlias別名

因爲類的徹底限定名稱比較長，大量使用時十分不方便。MyBatis經過別名的方式來表明它，在MyBatis中別名是不區分大小寫。別名又分爲系統定義別名和自定義別名。

配置自定義別名：

<typeAliases>
    <!--全寫-->
    <typeAlias type="com.lzx.entity.Author" alias="author" />
    <typeAlias type="com.lzx.entity.Blog" alias="blog" />
    <!--簡寫，MyBatis自動掃描這個包下面的全部類，把第一字母變成小寫做爲別名-->
    <package name="com.lzx.entity" />
</typeAliases>

使用註解配置別名：

@Alias("blog")
public class Blog {
	...
}

系統自定義別名:

四、typeHandler類型轉換器

在JDBC中，須要在PreparedStatement中處理預編譯的SQL語句中的參數，執行完畢SQL後，經過ResultSet對象得到數據庫中的數據，這些數據類型在MyBatis中經過typeHandler實現。在typeHandler中分爲jdbcType和javaType。jdbcType定義數據庫類型，javaType定義java類型。typeHandler的做用是承擔jdbcType和javaType之間的相互轉換。通常來講，系統定義的typeHandler就足夠咱們使用，咱們還能夠自定義typeHandler來處理咱們須要知足的轉換規則。

系統定義的typeHandler:

自定義typeHandler須要實現TypeHandler接口

public class MyTypeHandler implements TypeHandler<Integer> {
    // ...重寫方法
}

配置自定義typeHandler:

<typeHandlers>
    <typeHandler handler="com.lzx.element.MyTypeHandler" 
		javaType="string" jdbcType="VARCHAR" />

	<!--掃描包配置typeHandler-->
    <package name="com.lzx.mytypehandler" />
</typeHandlers>

使用包掃描和註解註冊typeHandler

@MappedTypes(Integer.class)
@MappedJdbcTypes(jdbcType.VARCHAR)
public class MyTypeHandler implements TypeHandler<Integer> {
    // ...重寫方法	  
}

使用自定義typeHandler

<!--使用方式一-->
<resultMap id="authorMapper" type="author">
    <id property="id" column="id"/>
    <result property="name" column="name" typeHandler="com.lzx.element.MyTypeHandler"/>
</resultMap>

  <!--使用方式二-->
<select id="queryByName" >
    select `id`,`name` from author
      where `name` = #{name, typeHandler=com.lzx.element.MyTypeHandler}
</select>

枚舉typeHandler

大多數狀況下，typeHandler由於枚舉而使用，MyBatis定義了兩個類做爲枚舉類型地支持，由於不經常使用，因此咱們瞭解一下便可。分別是EnumOrdinalTypeHandler和EnumTypeHandler。其中，EnumOrdinalTypeHandler是按照MyBatis根據數組下標索引的方式進行匹配的，它要求數據庫返回一個整數做爲其下標，它會根據下標找到對應的枚舉類型。 EnumTypeHandler會把使用的名稱轉換爲對應的枚舉，好比它根據數據庫返回的字符串「MALE」進行Enum.valueOf(SexEnum.class,「MALE」)轉換。

文件操做

MyBatis對數據的Blob的字段進行了支持，提供了一個BlobTypeHandler，還有ByteArrayTypeHanddler,只不過不太經常使用。由於一次性把大批量的數據加載到JVM中，會對服務器形成很大的壓力，應該考慮採用文件流的形式。由於性能不佳，大型互聯網網站會採用文件服務器的形式，可以對文件進行更爲告訴的操做。

五、ObjectFactory(對象工廠)

MyBatis 每次建立結果對象的新實例時，它都會使用一個對象工廠（ObjectFactory）實例來完成。MyBatis容許自定義ObjectFactory，能夠繼承ObjectFactory來實現，可是因爲裏面的自定義返回規則比較複雜且易出錯，因此咱們繼承系統實現好的ObjectFactory便可。

public class MyObjectFactory extends DefaultObjectFactory {
// .....重寫方法
}

XML配置：

<objectFactory type="com.lzx.element.MyObjectFactory">
    <property name="properties" value="properties_value"/>
</objectFactory>

六、插件（plugin）

插件是MyBatis中最爲強大和靈活的組件，也是最爲複雜、最難使用的組件。由於它覆蓋了MyBatis底層對象的核心方法和屬性，若是不熟悉MyBatis底層的構建和運行原理，請不要隨意自定義使用。

MyBatis 容許使用插件來攔截的方法調用包括：

• Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
• ParameterHandler (getParameterObject, setParameters)
• ResultSetHandler (handleResultSets, handleOutputParameters)
• StatementHandler (prepare, parameterize, batch, update, query)

自定義插件：

@Intercepts({@Signature(
    type= Executor.class,
    method = "update",
    args = {MappedStatement.class,Object.class})})
public class MyPlugin implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        return null;
    }

    @Override
    public Object plugin(Object o) {
        return null;
    }

    @Override
    public void setProperties(Properties properties) {

    }
}

XML配置：

<plugins>
    <plugin interceptor="com.lzx.element.MyPlugin">
        <property name="someProperty" value="100"/>
    </plugin>
</plugins>

七、environment(運行環境)

運行環境主要用來配置數據庫信息，能夠配置多個數據庫。主要分爲兩個配置元素transactionManager(事務管理器)和dataSource(數據庫)。

<environments default="development">
    <environment id="decelopment">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="${jdbc.driver}"/>
            <property name="url" value="${jdbc.url}"/>
            <property name="username" value="${jdbc.username}"/>
            <property name="password" value="${jdbc.password}"/>
        </dataSource>
    </environment>
</environments>

在 MyBatis 中有兩種類型的事務管理器（也就是 type=」[JDBC|MANAGED]」）：

• JDBC – 這個配置就是直接使用了 JDBC 的提交和回滾設置，它依賴於從數據源獲得的鏈接來管理事務做用域。

• MANAGED – 這個配置幾乎沒作什麼。它歷來不提交或回滾一個鏈接，而是讓容器來管理事務的整個生命週期（好比 JEE 應用服務器的上下文）。 默認狀況下它會關閉鏈接，然而一些容器並不但願這樣，所以須要將 closeConnection 屬性設置爲 false 來阻止它默認的關閉行爲。

  <transactionManager type="MANAGED">
     <property name="closeConnection" value="false"/>
   </transactionManager>

dataSource三種數據源及其屬性：

• UNPOOLED
• POOLED
• JNDI

八、databaseIdProvider數據庫廠商標識

MyBatis 能夠根據不一樣的數據庫廠商執行不一樣的語句，這種多廠商的支持是基於映射語句中的 databaseId 屬性。 MyBatis 會加載不帶 databaseId 屬性和帶有匹配當前數據庫 databaseId 屬性的全部語句。 若是同時找到帶有 databaseId 和不帶 databaseId 的相同語句，則後者會被捨棄。

<databaseIdProvider type="DB_VENDOR">
  <property name="SQL Server" value="sqlserver"/>
  <property name="DB2" value="db2"/>        
  <property name="Oracle" value="oracle" />
</databaseIdProvider>

使用時，須要在映射器中加上databaseId

<select id="queryByName" resultType="com.lzx.entity.Author" databaseId="oracle">
    select * from author where name = #{name}
</select>

九、引入映射器

前面咱們知道實現映射器經常使用的實現方式是聲明一個接口並配合xml文件使用。映射器中的定義命名空間（namespace）,命名空間對應的是一個接口的全路徑。

在配置文件中咱們要引入映射器，共有如下幾種實現方式：

1. 使用相對於類路徑的資源引用

2. 使用徹底限定資源定位符（URL）

3. 使用映射器接口實現類的徹底限定類名

4. 將包內的映射器接口實現所有註冊爲映射器

<!--方式一-->
<mappers>
    <mapper resource="mapper/AuthorMapper.xml"/>
    <mapper resource="mapper/BlogMapper.xml"/>
</mappers>
<!--方式二-->
<mappers>
    <mapper url="file:///var/mapper/AuthorMapper.xml"/>
    <mapper url="file:///var/mapper/BlogMapper.xml"/>
</mappers>
<!--方式三-->
<mappers>
    <mapper class="mapper.AuthorMapper"/>
    <mapper class="mapper.BlogMapper"/>
</mappers>
<!--方式四-->
<mappers>
    <package name="mapper"/>
</mappers>