5 typeHandler類型處理器

MyBatis在預(yù)處理語(yǔ)句（PreparedStatement）中設(shè)置一個(gè)參數(shù)或者從結(jié)果集（ResultSet）中取出一個(gè)值時(shí)，都會(huì)用注冊(cè)了的typeHandler進(jìn)行處理。typeHandler常用的配置為Java類型（javaType）、JDBC類型（jdbcType）。typeHandler的作用就是將參數(shù)從javaType轉(zhuǎn)化為 jdbcType，或者從數(shù)據(jù)庫(kù)取出結(jié)果時(shí)把jdbcType轉(zhuǎn)化為javaType。

5.1 系統(tǒng)定義的typeHandler

在org.apache.ibatis.type.TypeHandlerRegistry中MyBatis定義了很多系統(tǒng)內(nèi)部的typeHader，主要是基本類型、字符串、時(shí)間類型、枚舉類型的處理。

5.2 自定義typeHandler

繼承BaseTypeHandler或?qū)崿F(xiàn)TypeHandler

對(duì)于自定義typeHandler的要求是必須實(shí)現(xiàn)接口org.apache.ibatis.type.TypeHandler，更簡(jiǎn)單的方式是繼承已經(jīng)實(shí)現(xiàn)了該接口的實(shí)現(xiàn)類org. apache.ibatis.type.BaseTypeHandler。

確定攔截類型

可以在自定義typeHandler里用注解配置@MappedTypes和@MappedJdbcTypes，也可以在<typeHandler>元素中指定。

• @MappedTypes定義的是JavaType類型，可以指定哪些Java類型被攔截；
• @MappedJdbcTypes定義的是JdbcType類型，取值范圍在枚舉類org.apache.ibatis.type.JdbcType中找到。

@MappedTypes(String.class)
@MappedJdbcTypes(JdbcType.VARCHAR)
public class MyStringTypeHandler implements TypeHandler<String> {
    @Override
    public void setParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException {
        System.out.println("MyStringTypeHandler#setParameter");
        ps.setString(i, parameter);
    }

    @Override
    public String getResult(ResultSet rs, String columnName) throws SQLException {
        System.out.println("MyStringTypeHandler#getResult 1");
        return rs.getString(columnName);
    }

    @Override
    public String getResult(ResultSet rs, int columnIndex) throws SQLException {
        System.out.println("MyStringTypeHandler#getResult 2");
        return rs.getString(columnIndex);
    }

    @Override
    public String getResult(CallableStatement cs, int columnIndex) throws SQLException {
        System.out.println("MyStringTypeHandler#getResult 3");
        return cs.getString(columnIndex);
    }
}

啟用自定義的typeHander

• 可以在mybatis-config.xml里面配置，可以選擇配置一個(gè)類或者一個(gè)包。
• 在Mapper.xml的<resultMap>直接指定typeHandler。
• 在Mapper.xml的參數(shù)中指定typeHandler。

    <!-- 1. 在mybatis-config.xml中配置 -->
    <typeHandlers>
        <typeHandler handler="com.ankeetc.spring.type.MyStringTypeHandler"/>
    </typeHandlers>

    <!-- 2. 在Mapper.xml中resultMap元素中配置-->
    <resultMap id="BaseResultMap" type="com.ankeetc.spring.domain.UserDomain">
        <result column="name" property="name" javaType="java.lang.String" jdbcType="VARCHAR" typeHandler="com.ankeetc.spring.type.MyStringTypeHandler"/>
    </resultMap>
    <!-- 注意必須使用上面的resultMap -->
    <select id="select" resultMap="BaseResultMap" parameterType="java.lang.Long">
        SELECT * FROM tb_name WHERE id = #{id}
    </select>

    <!-- 3. 在Mapper.xml參數(shù)中配置-->
    <insert id="insert" parameterType="com.ankeetc.spring.domain.UserDomain">
        INSERT INTO tb_name (name) VALUES (#{name, jdbcType=VARCHAR, javaType=String, typeHandler=com.ankeetc.spring.type.MyStringTypeHandler})
    </insert>

5.3 枚舉類型typeHandler

MyBatis中枚舉類型的typeHandler則有自己特殊的規(guī)則，MyBatis內(nèi)部提供了兩個(gè)轉(zhuǎn)化枚舉類型的typeHandler給我們使用。

• org.apache.ibatis.type.EnumTypeHandler：使用枚舉字符串名稱作為參數(shù)傳遞的
• org.apache.ibatis.type.EnumOrdinalTypeHandler：使用整數(shù)下標(biāo)作為參數(shù)傳遞的

6 objectFactory對(duì)象工廠

當(dāng)MyBatis在構(gòu)建一個(gè)結(jié)果返回的時(shí)候，都會(huì)使用ObjectFactory（對(duì)象工廠）去構(gòu)建POJO，我們可以定制自己的對(duì)象工廠。MyBatis中默認(rèn)的ObjectFactory是由org.apache.ibatis.reflection.factory.DefaultObjectFactory來(lái)提供服務(wù)的。

自定義objectFactory

1. 實(shí)現(xiàn)ObjectFactory接口，也可以通過(guò)繼承DefaultObjectFactory擴(kuò)展功能。
2. 在mybatis-config.xml中使用<objectFactory>元素。

7 environments環(huán)境變量

配置環(huán)境可以注冊(cè)多個(gè)環(huán)境，每一個(gè)環(huán)境分為兩大部分：一個(gè)是數(shù)據(jù)庫(kù)源（dataSource）的配置，另外一個(gè)是數(shù)據(jù)庫(kù)事務(wù)（transactionManager）的配置。

7.1 概述

    <environments default="dev">
        <environment id="dev">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
            </dataSource>
        </environment>
    </environments>

1. default：表示默認(rèn)使用哪個(gè)數(shù)據(jù)源
2. id：表示數(shù)據(jù)源的名稱
3. transactionManager的事務(wù)類型type一共有三種：JDBC，采用JDBC方式管理事務(wù)，獨(dú)立編碼中我們常常使用；MANAGED，采用容器方式管理事務(wù)，在JNDI數(shù)據(jù)源中常用；自定義，由使用者自定義數(shù)據(jù)庫(kù)事務(wù)管理辦法，適用于特殊應(yīng)用。
4. property元素配置數(shù)據(jù)源的各類屬性
5. dataSource的type屬性是提供我們對(duì)數(shù)據(jù)厙連接方式的配置：UNPOOLED（非連接池?cái)?shù)據(jù)庫(kù)）、POOLED（連接池?cái)?shù)據(jù)庫(kù)）、JNDI（JNDI數(shù)據(jù)源）、自定義數(shù)據(jù)源。

7.2 數(shù)據(jù)庫(kù)事務(wù)

數(shù)據(jù)庫(kù)事務(wù)是交由SqlSession去控制的，我們可以通過(guò)SqlSession提交或者回滾。在大部分的工作環(huán)境下，我們都會(huì)使用 Spring框架來(lái)控制它。

7.3 數(shù)據(jù)源

MyBatis內(nèi)部為我們提供了3種數(shù)據(jù)源的實(shí)現(xiàn)方式：

• UNPOOLED，使用org.apache.ibatis.datasource.unpooled.UnpooledDataSource實(shí)現(xiàn)。
• POOLED，使用org.apache.ibatis.datasource.pooled.PooledDataSource實(shí)現(xiàn)。
• JNDI，使用org.apache.ibatis.datasource.jndi.JndiDataSourceFactory實(shí)現(xiàn)。

7.4 自定義數(shù)據(jù)源

使用自定義數(shù)據(jù)源，它必須實(shí)現(xiàn)org.apache.ibatis.datasource.DataSourceFactory接口。然后在<dataSource>中type屬性指定對(duì)應(yīng)的全限定類名。

public class MyDataSourceFactory implements DataSourceFactory {

    DataSource dataSource;

    public MyDataSourceFactory() {
        DruidDataSource druidDataSource = new DruidDataSource();
        druidDataSource.setDriverClassName("com.mysql.jdbc.Driver");
        druidDataSource.setUrl("jdbc:mysql://localhost:3306/test");
        druidDataSource.setUsername("root");
        dataSource = druidDataSource;
    }

    private Properties properties;

    @Override
    public void setProperties(Properties props) {
        this.properties = props;
    }

    @Override
    public DataSource getDataSource() {
        return dataSource;
    }
}

    <dataSource type="com.ankeetc.spring.config.MyDataSourceFactory"/>

8 databaseIdProvider數(shù)據(jù)庫(kù)廠商標(biāo)識(shí)

在相同數(shù)據(jù)庫(kù)廠商的環(huán)境下，數(shù)據(jù)庫(kù)廠商標(biāo)識(shí)沒有什么意義，在實(shí)際的應(yīng)用中使用得比較少，因?yàn)槭褂貌煌瑥S商數(shù)據(jù)庫(kù)的系統(tǒng)還是比較少的。 MyBatis可能會(huì)運(yùn)行在不同廠商的數(shù)據(jù)庫(kù)中，它為此提供一個(gè)數(shù)據(jù)庫(kù)標(biāo)識(shí)，作用在于指定SQL到對(duì)應(yīng)的數(shù)據(jù)庫(kù)廠商提供的數(shù)據(jù)庫(kù)中運(yùn)行。

8.1 系統(tǒng)默認(rèn)規(guī)則

系統(tǒng)默認(rèn)規(guī)則

獲得數(shù)據(jù)庫(kù)的Id

可以用下面的代碼來(lái)獲得數(shù)據(jù)庫(kù)的Id：sqlSessionFactory. getConfiguration(). getDatabaseId()

指定數(shù)據(jù)庫(kù)廠商

可以指定SQL在哪個(gè)數(shù)據(jù)庫(kù)廠商執(zhí)行，需要在Mapper.XML中通過(guò)指定。

    <insert id="insert" parameterType="com.ankeetc.spring.domain.UserDomain" databaseId="mysql">
        INSERT INTO tb_name (name) VALUES (#{name, typeHandler=com.ankeetc.spring.type.MyStringTypeHandler})
    </insert>

8.2 自定義規(guī)則

1. 實(shí)現(xiàn)org.apache.ibatis.mapping.DatabaseIdProvider接口
2. 配置<databaseIdProvider>標(biāo)簽。

public class MyDatabaseIdProvider implements DatabaseIdProvider {
    private Properties properties;

    @Override
    public void setProperties(Properties p) {
        this.properties = p;
    }

    @Override
    public String getDatabaseId(DataSource dataSource) throws SQLException {
        String dbName = dataSource.getConnection().getMetaData().getDatabaseProductName();
        return this.properties.getProperty(dbName);
    }
}

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