1. 程式人生 > 實用技巧 >XML之MyBatis配置

XML之MyBatis配置

1、log4j簡單配置

 1 <?xml version="1.0" encoding="UTF-8" ?>
 2 <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
 3 
 4 <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
 5   <appender name="console" class="org.apache.log4j.ConsoleAppender"> 
 6     <param name="Target"
value="System.out"/> 7 <layout class="org.apache.log4j.PatternLayout"> 8 <param name="ConversionPattern" value="%-5p %c{1} - %m%n"/> 9 </layout> 10 </appender> 11 12 <root> 13 <priority value ="debug" /> 14 <appender-ref ref="console"
/> 15 </root> 16 17 </log4j:configuration>

2、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>
    <!--
        1、mybatis可以使用properties來引入外部properties配置檔案的內容;
        resource:引入類路徑下的資源
        url:引入網路路徑或者磁碟路徑下的資源
      
--> <properties resource="dbconfig.properties"></properties> <!-- 2、settings包含很多重要的設定項 setting:用來設定每一個設定項 name:設定項名 value:設定項取值 --> <settings> <setting name="mapUnderscoreToCamelCase" value="true"/> </settings> <!-- 3、typeAliases:別名處理器:可以為我們的java型別起別名 別名不區分大小寫 --> <typeAliases> <!-- 1、typeAlias:為某個java型別起別名 type:指定要起別名的型別全類名;預設別名就是類名小寫;employee alias:指定新的別名 --> <!-- <typeAlias type="com.atguigu.mybatis.bean.Employee" alias="emp"/> --> <!-- 2、package:為某個包下的所有類批量起別名 name:指定包名(為當前包以及下面所有的後代包的每一個類都起一個預設別名(類名小寫),) --> <package name="com.atguigu.mybatis.bean"/> <!-- 3、批量起別名的情況下,使用@Alias註解為某個型別指定新的別名 --> </typeAliases> <!-- 4、environments:環境們,mybatis可以配置多種環境 ,default指定使用某種環境。可以達到快速切換環境。 environment:配置一個具體的環境資訊;必須有兩個標籤;id代表當前環境的唯一標識 transactionManager:事務管理器; type:事務管理器的型別;JDBC(JdbcTransactionFactory)|MANAGED(ManagedTransactionFactory) 自定義事務管理器:實現TransactionFactory介面.type指定為全類名 dataSource:資料來源; type:資料來源型別;UNPOOLED(UnpooledDataSourceFactory) |POOLED(PooledDataSourceFactory) |JNDI(JndiDataSourceFactory) 自定義資料來源:實現DataSourceFactory介面,type是全類名 --> <environments default="dev_mysql"> <environment id="dev_mysql"> <transactionManager type="JDBC"></transactionManager> <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> <environment id="dev_oracle"> <transactionManager type="JDBC" /> <dataSource type="POOLED"> <property name="driver" value="${orcl.driver}" /> <property name="url" value="${orcl.url}" /> <property name="username" value="${orcl.username}" /> <property name="password" value="${orcl.password}" /> </dataSource> </environment> </environments> <!-- 5、databaseIdProvider:支援多資料庫廠商的; type="DB_VENDOR":VendorDatabaseIdProvider 作用就是得到資料庫廠商的標識(驅動getDatabaseProductName()),mybatis就能根據資料庫廠商標識來執行不同的sql; MySQL,Oracle,SQL Server,xxxx --> <databaseIdProvider type="DB_VENDOR"> <!-- 為不同的資料庫廠商起別名 --> <property name="MySQL" value="mysql"/> <property name="Oracle" value="oracle"/> <property name="SQL Server" value="sqlserver"/> </databaseIdProvider> <!-- 將我們寫好的sql對映檔案(EmployeeMapper.xml)一定要註冊到全域性配置檔案(mybatis-config.xml)中 --> <!-- 6、mappers:將sql對映註冊到全域性配置中 --> <mappers> <!-- mapper:註冊一個sql對映 註冊配置檔案 resource:引用類路徑下的sql對映檔案 mybatis/mapper/EmployeeMapper.xml url:引用網路路徑或者磁碟路徑下的sql對映檔案 file:///var/mappers/AuthorMapper.xml 註冊介面 class:引用(註冊)介面, 1、有sql對映檔案,對映檔名必須和介面同名,並且放在與介面同一目錄下; 2、沒有sql對映檔案,所有的sql都是利用註解寫在介面上; 推薦: 比較重要的,複雜的Dao介面我們來寫sql對映檔案 不重要,簡單的Dao介面為了開發快速可以使用註解; --> <!-- <mapper resource="mybatis/mapper/EmployeeMapper.xml"/> --> <!-- <mapper class="com.atguigu.mybatis.dao.EmployeeMapperAnnotation"/> --> <!-- 批量註冊: --> <package name="com.atguigu.mybatis.dao"/> </mappers> </configuration>

3、MyBatis引數處理

單個引數:mybatis不會做特殊處理,
    #{引數名/任意名}:取出引數值。
    
多個引數:mybatis會做特殊處理。
    多個引數會被封裝成 一個map,
        key:param1...paramN,或者引數的索引也可以
        value:傳入的引數值
    #{}就是從map中獲取指定的key的值;
    
    異常:
    org.apache.ibatis.binding.BindingException: 
    Parameter 'id' not found. 
    Available parameters are [1, 0, param1, param2]
    操作:
        方法:public Employee getEmpByIdAndLastName(Integer id,String lastName);
        取值:#{id},#{lastName}

【命名引數】:明確指定封裝引數時map的key;@Param("id")
    多個引數會被封裝成 一個map,
        key:使用@Param註解指定的值
        value:引數值
    #{指定的key}取出對應的引數值


POJO:
如果多個引數正好是我們業務邏輯的資料模型,我們就可以直接傳入pojo;
    #{屬性名}:取出傳入的pojo的屬性值    

Map:
如果多個引數不是業務模型中的資料,沒有對應的pojo,不經常使用,為了方便,我們也可以傳入map
    #{key}:取出map中對應的值

TO:
如果多個引數不是業務模型中的資料,但是經常要使用,推薦來編寫一個TO(Transfer Object)資料傳輸物件
Page{
    int index;
    int size;
}

========================思考================================    
public Employee getEmp(@Param("id")Integer id,String lastName);
    取值:id==>#{id/param1}   lastName==>#{param2}

public Employee getEmp(Integer id,@Param("e")Employee emp);
    取值:id==>#{param1}    lastName===>#{param2.lastName/e.lastName}

##特別注意:如果是Collection(List、Set)型別或者是陣列,
         也會特殊處理。也是把傳入的list或者陣列封裝在map中。
            key:Collection(collection),如果是List還可以使用這個key(list)
                陣列(array)
public Employee getEmpById(List<Integer> ids);
    取值:取出第一個id的值:   #{list[0]}
    
========================結合原始碼,mybatis怎麼處理引數==========================
總結:引數多時會封裝map,為了不混亂,我們可以使用@Param來指定封裝時使用的key;
#{key}就可以取出map中的值;

(@Param("id")Integer id,@Param("lastName")String lastName);
ParamNameResolver解析引數封裝map的;
//1、names:{0=id, 1=lastName};構造器的時候就確定好了

    確定流程:
    1.獲取每個標了param註解的引數的@Param的值:id,lastName;  賦值給name;
    2.每次解析一個引數給map中儲存資訊:(key:引數索引,value:name的值)
        name的值:
            標註了param註解:註解的值
            沒有標註:
                1.全域性配置:useActualParamName(jdk1.8):name=引數名
                2.name=map.size();相當於當前元素的索引
    {0=id, 1=lastName,2=2}
                

args【1,"Tom",'hello'】:

public Object getNamedParams(Object[] args) {
    final int paramCount = names.size();
    //1、引數為null直接返回
    if (args == null || paramCount == 0) {
      return null;
     
    //2、如果只有一個元素,並且沒有Param註解;args[0]:單個引數直接返回
    } else if (!hasParamAnnotation && paramCount == 1) {
      return args[names.firstKey()];
      
    //3、多個元素或者有Param標註
    } else {
      final Map<String, Object> param = new ParamMap<Object>();
      int i = 0;
      
      //4、遍歷names集合;{0=id, 1=lastName,2=2}
      for (Map.Entry<Integer, String> entry : names.entrySet()) {
      
          //names集合的value作為key;  names集合的key又作為取值的參考args[0]:args【1,"Tom"】:
          //eg:{id=args[0]:1,lastName=args[1]:Tom,2=args[2]}
        param.put(entry.getValue(), args[entry.getKey()]);
        
        
        // add generic param names (param1, param2, ...)param
        //額外的將每一個引數也儲存到map中,使用新的key:param1...paramN
        //效果:有Param註解可以#{指定的key},或者#{param1}
        final String genericParamName = GENERIC_NAME_PREFIX + String.valueOf(i + 1);
        // ensure not to overwrite parameter named with @Param
        if (!names.containsValue(genericParamName)) {
          param.put(genericParamName, args[entry.getKey()]);
        }
        i++;
      }
      return param;
    }
  }
}
===========================引數值的獲取======================================
#{}:可以獲取map中的值或者pojo物件屬性的值;
${}:可以獲取map中的值或者pojo物件屬性的值;


select * from tbl_employee where id=${id} and last_name=#{lastName}
Preparing: select * from tbl_employee where id=2 and last_name=?
    區別:
        #{}:是以預編譯的形式,將引數設定到sql語句中;PreparedStatement;防止sql注入
        ${}:取出的值直接拼裝在sql語句中;會有安全問題;
        大多情況下,我們去引數的值都應該去使用#{};
        
        原生jdbc不支援佔位符的地方我們就可以使用${}進行取值
        比如分表、排序。。。;按照年份分表拆分
            select * from ${year}_salary where xxx;
            select * from tbl_employee order by ${f_name} ${order}

#{}:更豐富的用法:
    規定引數的一些規則:
    javaType、 jdbcType、 mode(儲存過程)、 numericScale、
    resultMap、 typeHandler、 jdbcTypeName、 expression(未來準備支援的功能);

    jdbcType通常需要在某種特定的條件下被設定:
        在我們資料為null的時候,有些資料庫可能不能識別mybatis對null的預設處理。比如Oracle(報錯);
        
        JdbcType OTHER:無效的型別;因為mybatis對所有的null都對映的是原生Jdbc的OTHER型別,oracle不能正確處理;
        
        由於全域性配置中:jdbcTypeForNull=OTHER;oracle不支援;兩種辦法
        1、#{email,jdbcType=OTHER};
        2、jdbcTypeForNull=NULL
            <setting name="jdbcTypeForNull" value="NULL"/>

(持續更新中......)