前言：前文提到一個入門的demo，從這裏開始，會了解深入 MyBatis 的配置，本文講解 MyBatis 的配置文件的用法。

目錄

1、properties 元素

2、設置（settings）

3、別名（typeAliases）

配置 XML 文件的層次結構

<?xml version="1.0" encoding="UTF-8"?>
<configuration><!--配置-->
    <properties/><!--屬性-->
    <settions/><!--設置-->
    <typeAliases
 
/><!--類型命名，不區分大小寫-->
    <typeHandlers/><!--類型處理器-->
    <objectFactory/><!--對象工廠-->
    <plugins/><!--插件-->
    <environments><!--配置環境-->
        <environment>
            <transactionManager/><!--事務管理器-->
            <dataSource
 
/><!--數據源-->
        </environment>
    </environments>
    <databaseIdProvider/><!--數據庫廠商標識-->
    <mappers/><!--映射器-->
</configuration>

　　註意：MyBatis 配置 XML 文件的層次結構。這些層次是不能夠顛倒順序的，如果顛倒順序，MyBatis 在解析 XML 文件的時候就會出現異常。

xml 為什麽不能顛倒順序

　　至於為什麽不能顛倒順序，是由於 MyBatis3 是使用 dtd 文件作為 xml 文件的格式校驗的，而在 xml 規範中，dtd 是有嚴格校驗順序的。

　　在 idea 中，如果顛倒順序，idea 會提示下圖信息：

　　查看源碼可以得知，在 org/apache/ibatis/builder/xml/mybatis-3-config.dtd 文件中，有明確定義該順序：

1、properties 元素

　　properties 是一個配置屬性的元素，讓我們能夠在配置文件的上下文中（其他配置屬性裏面，比如環境配置）使用它。

　　我們可以有 3 種配置方式：property 子元素、properties 配置文件、程序的參數傳遞。

1.1、property 子元素

　　dtd 的規則

　　配置好後在數據庫環境配置裏使用

    <!--屬性，property 子元素-->
    <properties>
        <property name="driver" value="oracle.jdbc.OracleDriver"/>
        <property name="datasourceurl" value="jdbc:oracle:thin:@localhost:1521:ORCL"/>
        <property name="username" value="testdev"/>
        <property name="password" value="test1234"/>
    </properties>

    <!--配置環境-->
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${datasourceurl}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>

1.2 properties 配置文件

　　經常，我們都喜歡使用 properties 配置文件來配置屬性值，方便我們在多個配置文件中重復使用，更是為了方便系統上線後的維護和修改。

　　dtd 的規則

　　建一個 db.properties 文件

driver=oracle.jdbc.OracleDriver
datasourceurl=jdbc:oracle:thin:@localhost:1521:ORCL
username=testdev
password=test1234

　　配置文件

    <properties resource="config/system/db.properties"/>

    <!--配置環境-->
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${datasourceurl}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>

1.3 程序參數傳遞

　　有時，我們的數據庫名和密碼不對開發公布，而是由運維人員配置的，所以這是數據庫名和密碼可以加密配置在 db.properties 文件中，然後由程序去 decode，創建 sqlSessionFactory 時采用 SqlSessionFactoryBuilder 的 public SqlSessionFactory build(Reader reader, Properties roperties) 方法。

　　程序部分代碼如下

　　/**
     * 初始化sqlSessionFactory，針對數據庫的密碼和用戶名加密的情況
     * @throws IOException
     */
    public void initSqlSessionFactoryForEncodeDbInfo() throws IOException {
        //讀入配置文件流
        InputStream inputStream = Resources.getResourceAsStream("configuration.xml");
        Reader reader = new InputStreamReader(inputStream);
        //讀入屬性文件
        Reader propertiesReader = new InputStreamReader(Resources.getResourceAsStream("config/system/db.properties"));
        Properties properties = new Properties();
        properties.load(propertiesReader);
        //解密
        properties.setProperty("username", decode(properties.get("username")));
        properties.setProperty("password", decode(properties.get("password")));
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader, properties);
    }

1.4 優先級

　　方法參數傳遞的屬性優先級最高，次之是 resource/url 屬性中的配置，最後是 property 中的屬性。

　　但是在實際中最好使用 properties 文件的配置方式。

2、設置（settings）

　　settings 比較復雜，也很重要，它會改變 MyBatis 運行時的行文。不配置 settings，MyBatis也可以正常工作。

　　大部分情況下，我們都可以不去配置 settings，或者只需修改幾個配置即可。

3、別名（typeAliases）

　　 別名是一個指代的名稱。可以在 MyBatis 的上下文中使用。

　　在 MyBatis 中別名是不分大小寫的。

　　一個 typeAliases 的實例是在解析配置文件時（源碼在 XMLConfigBuilder 中）生成的，然後長期保存在 Configuration 對象中，當我們使用它時，再把它拿出來，這樣就沒有必要運行時再次生成它的實例了。

　　別名分為系統定義別名和自定義別名。

3.1 為什麽 MyBatis 中別名是部分大小寫的

　　因為源碼 org.apache.ibatis.type.TypeAliasRegistry 如下：

    public void registerAlias(String alias, Class<?> value) {
        if(alias == null) {
            throw new TypeException("The parameter alias cannot be null");
        } else {
            String key = alias.toLowerCase(Locale.ENGLISH);
            if(this.TYPE_ALIASES.containsKey(key) && this.TYPE_ALIASES.get(key) != null && !((Class)this.TYPE_ALIASES.get(key)).equals(value)) {
                throw new TypeException("The alias ‘" + alias + "‘ is already mapped to the value ‘" + ((Class)this.TYPE_ALIASES.get(key)).getName() + "‘.");
            } else {
                this.TYPE_ALIASES.put(key, value);
            }
        }
    }

3.2 系統定義別名

　　MyBatis 自己有定義一些常用的別名，我們可以直接使用它們，不用自己定義，也不要再使用時重復定義把它們給覆蓋了。

　　支持數組類型的只要加“[]”即可。比如 Integer 數組，則別名為 int[]。

　　源碼 org.apache.ibatis.type.TypeAliasRegistry 中可以看出其自定義註冊的信息，源碼如下：

public TypeAliasRegistry() {
        this.registerAlias("string", String.class);
        this.registerAlias("byte", Byte.class);
        this.registerAlias("long", Long.class);
        this.registerAlias("short", Short.class);
        this.registerAlias("int", Integer.class);
        this.registerAlias("integer", Integer.class);
        this.registerAlias("double", Double.class);
        this.registerAlias("float", Float.class);
        this.registerAlias("boolean", Boolean.class);
        this.registerAlias("byte[]", Byte[].class);
        this.registerAlias("long[]", Long[].class);
        this.registerAlias("short[]", Short[].class);
        this.registerAlias("int[]", Integer[].class);
        this.registerAlias("integer[]", Integer[].class);
        this.registerAlias("double[]", Double[].class);
        this.registerAlias("float[]", Float[].class);
        this.registerAlias("boolean[]", Boolean[].class);
        this.registerAlias("_byte", Byte.TYPE);
        this.registerAlias("_long", Long.TYPE);
        this.registerAlias("_short", Short.TYPE);
        this.registerAlias("_int", Integer.TYPE);
        this.registerAlias("_integer", Integer.TYPE);
        this.registerAlias("_double", Double.TYPE);
        this.registerAlias("_float", Float.TYPE);
        this.registerAlias("_boolean", Boolean.TYPE);
        this.registerAlias("_byte[]", byte[].class);
        this.registerAlias("_long[]", long[].class);
        this.registerAlias("_short[]", short[].class);
        this.registerAlias("_int[]", int[].class);
        this.registerAlias("_integer[]", int[].class);
        this.registerAlias("_double[]", double[].class);
        this.registerAlias("_float[]", float[].class);
        this.registerAlias("_boolean[]", boolean[].class);
        this.registerAlias("date", Date.class);
        this.registerAlias("decimal", BigDecimal.class);
        this.registerAlias("bigdecimal", BigDecimal.class);
        this.registerAlias("biginteger", BigInteger.class);
        this.registerAlias("object", Object.class);
        this.registerAlias("date[]", Date[].class);
        this.registerAlias("decimal[]", BigDecimal[].class);
        this.registerAlias("bigdecimal[]", BigDecimal[].class);
        this.registerAlias("biginteger[]", BigInteger[].class);
        this.registerAlias("object[]", Object[].class);
        this.registerAlias("map", Map.class);
        this.registerAlias("hashmap", HashMap.class);
        this.registerAlias("list", List.class);
        this.registerAlias("arraylist", ArrayList.class);
        this.registerAlias("collection", Collection.class);
        this.registerAlias("iterator", Iterator.class);
        this.registerAlias("ResultSet", ResultSet.class);
    }

3.3 自定義別名

　　（1）在配置文件中寫法如下

    <!--定義別名-->
    <typeAliases>
        <typeAlias type="com.yule.user.entity.User" alias="user"/>
    </typeAliases>

　　（2）或者當實體類較多的時候，使用自動掃描的形式自定義別名

    <!--定義別名-->
    <typeAliases>        
        <package name="com.yule.user.entity"/>
    </typeAliases>

　　同時也可以在實體類上使用註解 @Alias

@Alias("user")
public class User {
    //do somethings
}

　　註意：如果配置了包掃描的路徑，那麽沒有在實體上加註解 @Alias 的類也在裝載在 MyBatis 的上下文中，只是 MyBatis 將類名的第一個字母變為小寫，作為 MyBatis 上下文中的別名，所以要特別註意避免重名的情況，建議使用部分包名+類名的限定。

深入理解MyBatis的原理（三）：配置文件上