碼上歡樂
相關內容    簡體    繁體

mybatis注解詳解

本文轉載自   查看原文   2016-08-28 14:41   13547    mybatis 注解 詳解

http://www.mybatis.org/mybatis-3/zh/sqlmap-xml.html

 

mybatis的原身是ibatis，現在已經脫離了apache基金會，新官網是http://www.mybatis.org/。

mybatis3中增加了使用注解來配置Mapper的新特性，本篇文章主要介紹其中幾個@Provider的使用方式，他們是：@SelectProvider、@UpdateProvider、@InsertProvider和@DeleteProvider。

MyBatis 3 User Guide中的最后一章描述了注解的簡單用法，但是對於這幾個Provider的具體使用方式並沒有說的很清楚，特別是參數傳遞的方式，完全沒有提及，對於初次使用的同學來說，會造成不小的困擾。

經過一些嘗試后，我總結了一些Provider的使用經驗，下面以@SelectProvider為例，依次描述幾種典型的使用場景。

1.使用@SelectProvider
@SelectProvider是聲明在方法基本上的，這個方法定義在Mapper對應的的interface上。
1 public interface UserMapper {
2     @SelectProvider(type = SqlProvider.class, method = "selectUser")
3     @ResultMap("userMap")
4     public User getUser(long userId);
5 }
上例中是個很簡單的Mapper接口，其中定義了一個方法：getUser，這個方法根據提供的用戶id來查詢用戶信息，並返回一個User實體bean。
這是一個很簡單很常用的查詢場景：根據key來查詢記錄並將結果封裝成實體bean。其中：
@SelectProvider注解用於生成查詢用的sql語句，有別於@Select注解，@SelectProvide指定一個Class及其方法，並且通過調用Class上的這個方法來獲得sql語句。在我們這個例子中，獲取查詢sql的方法是SqlProvider.selectUser。
@ResultMap注解用於從查詢結果集RecordSet中取數據然后拼裝實體bean。
 



2.定義拼裝sql的類

@SelectProvide中type參數指定的Class類，必須要能夠通過無參的構造函數來初始化。
@SelectProvide中method參數指定的方法，必須是public的，返回值必須為String，可以為static。
1 public class SqlProvider {
2     public String selectUser(long userId) {
3         return "select * from user where userId=" + userId;
4     }
5 }



3.無參數@SelectProvide方法
在Mapper接口方法上和@SelectProvide指定類方法上，均無參數：
UserMapper.java：

1     @SelectProvider(type = SqlProvider.class, method = "selectAllUser")
2     @ResultMap("userMap")
3     public List<User> getAllUser();
SqlProvider.java：
1     public String selectAllUser() {
2         return "select * from user";
3     }



4.一個參數的@SelectProvide方法
對於只有一個參數的情況，可以直接使用，參見前面的getUser和selectUser。
但是，如果在getUser方法中，對userId方法使用了@Param注解的話，那么相應selectUser方法必須接受Map<String, Object>做為參數：
UserMapper.java：

1     @SelectProvider(type = SqlProvider.class, method = "selectUser2")
2     @ResultMap("userMap")
3     public User getUser2(@Param("userId") long userId);

SqlProvider.java：

1     public String selectUser2(Map<String, Object> para) {
2         return "select * from user where userId=" + para.get("userId");
3     }



5.更多參數的@SelectProvide方法
在超過一個參數的情況下，@SelectProvide方法必須接受Map<String, Object>做為參數，
如果參數使用了@Param注解，那么參數在Map中以@Param的值為key，如下例中的userId；
如果參數沒有使用@Param注解，那么參數在Map中以參數的順序為key，如下例中的password：

UserMapper.java：
1     @SelectProvider(type = SqlProvider.class, method = "selectUserCheck")
2     @ResultMap("userMap")
3     public User getUserCheck(@Param("userId") long userId, String password);
SqlProvider.java：
1     public String selectUserCheck(Map<String, Object> para) {
2         return "select * from user where userId=" + para.get("userId") + " and password='" + para.get("1") + "'";
3     }

6.一些限制
在Mapper接口和@SelectProvide方法類中，不要使用重載，也就是說，不要使用方法名相同參數不同的方法，以避免發生詭異問題。

http://www.blogjava.net/dbstar/archive/2011/08/08/355825.html

最近在總結過去一年所做的項目，由於開發周期或者對需求的把握不是太到位，每個項目隨着所做的項目進度，從需求分析到code階段總或多或少有一些自己感覺不是太完美或沒有盡善盡美的地方，使用開源框架和第三方接口只知道接口調用，對於其內部實現機理總是存在疑惑（這家伙是怎么做的，我怎么沒有想到），雖然各個項目完成后一瘸一拐的還是能滿足當初的開發需求。但是對於追求完美、刨根問底性選手，心中總有根刺，感覺不爽(不知道大家有沒有這種感覺)。下面通過自己的理解使用java原生的注解方式實現 spring aop的運行機理 (還沒看過spring /mybatis的源代碼，過年的時候研究一下大俠們有好的想法可以共享一下，話說獨樂樂不如眾樂樂哦）

先說說spring AOP使用上的一些限制:

1.如果切點函數有重載時，定義的通知類中方法不能實現方法重載

2.spring AOP只支持方法層面的切口定義，當然這個也是spring的基本原則如spring mvc 與struts2的區別之一就是spring mvc是基於方法的設計struts2是基於類的設計；

3.spring aop 不支持參數級的切口定義，如有時候需要對傳入切口的參數進行安全性，規范性、合法性處理的時候是不支持的。當然對參數處理涉及到解析參數類型獲取、參數類型判斷，對於使用反射機制獲取這個是有一定難度滴。

下面通過詳細的代碼，來講解如何通過使用java的annotation自定義切點接口和通過反射機制實現spring AOP機制。

第一步:自定義AOP中需要的注解接口

class層注解定義：

用途：類接口切點注解定義

package com.dbc.yangg.project;

import java.lang.annotation.Documented; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; /** * * @ClassName: MyClassAnnotation * @Description: 類層注解定義 * @author guoyang2011@gmail.com * @date 2014年1月18日 下午11:37:51 * */ @Documented @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE) public @interface MyClassAnnotation {  String value() default "firstAnno"; }


method層advice定義類似於Spring AOP中@Before,@After,@Around,@AfterThrowing,@AfterReturning等

用途：方法切點接口注解定義

package com.dbc.yangg.project;

import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; /** * * @ClassName: MySecondMethodAnnotation * @Description: 方法層注解定義 * @author guoyang2011@gmail.com * @date 2014年1月18日 下午11:44:44 * */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD) public @interface MyPointcutAnnotation {  /**  *  * @Title: className  * @Description: TODO  * @param @return advicer class type  * @return Class<?>  * @throws  */  Class<?> className();  /**  *  * @Title: method  * @Description: TODO  * @param @return advicer method name  * @return String  * @throws  */  String method();// }


method parameters 層advicer定義類似mybatis中@Param注解

功能:參數層面切點接口注解定義

package com.dbc.yangg.project;

import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; /** * * @ClassName: MyParameterAnnotation * @Description: 方法中參數層注解定義 * @author guoyang2011@gmail.com * @date 2014年1月18日 下午11:45:15 * */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.PARAMETER) public @interface MyParameterAnnotation {  /**  *  * @Title: opType  * @Description: method 參數類型檢查  * @param @return  * @return MyAopParameterOPType[]  * @throws  */  MyAopParameterOPType[] opType();  /**  *  * @Title: paraType  * @Description: method 參數類型  * @param @return  * @return Class<?>  * @throws  */  Class<?> paraType(); }


處理MyAopParameterOPType類型定義

功能:定義參數切口定義注解處理的類型

package com.dbc.yangg.project;  
 /** * * @ClassName: MyAopParameterOPType * @Description: TODO * @author guoyang2011@gmail.com * @date 2014年1月18日 下午12:07:25 * */ public enum MyAopParameterOPType {  checkForDB("DB"),//特殊字符處理 ,通用轉碼或者其他處理  checkForSecurity("security"),//參數是否合法等操作  checkDeleteAuthority("DeleteAuthority"),  checkUpdateAuthority("UpdateAuthority");  private String value;  private MyAopParameterOPType(String value){   this.value=value;  }  public String getValue(){   return this.value;  } }

 

第二步:自定義AOP管理模塊

主要功能:自定義AOP處理類，負責解析實際調用切點函數定義的通知

  
package com.dbc.yangg.project;

import java.lang.annotation.Annotation; import java.lang.reflect.InvocationTargetException; import java.lang.reflect.Method; import org.apache.ibatis.annotations.SelectProvider; /** * * @ClassName: MyAOPUtils * @Description: * @author guoyang2011@gmail.com * @date 2014年1月18日 下午12:01:05 * */ public class MyAOPUtils {  /**  *  * @Title: myAopUtilsManager  * @Description: 切點函數參數觸發通知事件,所有通知事件的處理接口  * @param @param advicerManagerClass  * @param @param indexArg  * @param @param paraValues  * @param @param paraTypes  * @param @return  * @return boolean  * @throws  */  private static boolean parameterAdvicerUtils(Annotation advicerManagerClass,int indexArg,Object[] paraValues, Class<?>... paraTypes){   if(advicerManagerClass instanceof MyPointcutAnnotation){    //接口參數驗證通過后執行    //切點通知處理    MyPointcutAnnotation AdvicerClass=(MyPointcutAnnotation)advicerManagerClass;    Class<?> adviceClass=AdvicerClass.className();    try {     Method adviceMethod=adviceClass.getMethod(AdvicerClass.method(),paraTypes);     adviceMethod.invoke(adviceClass.newInstance(), paraValues);    } catch (NoSuchMethodException e) {     // TODO Auto-generated catch block     e.printStackTrace();    } catch (SecurityException e) {     // TODO Auto-generated catch block     e.printStackTrace();    } catch (IllegalAccessException e) {     // TODO Auto-generated catch block     e.printStackTrace();    } catch (IllegalArgumentException e) {     // TODO Auto-generated catch block     e.printStackTrace();    } catch (InvocationTargetException e) {     // TODO Auto-generated catch block     e.printStackTrace();    } catch (InstantiationException e) {     // TODO Auto-generated catch block     e.printStackTrace();    }      }else if(advicerManagerClass instanceof MyParameterAnnotation){    //對輸入的參數做一些通用處理和安全性檢查等等    //一般用在DAO層sql拼裝特殊字符檢查，數據格式合法性檢查，轉碼或對調用者使用定義切點接口使用權限，安全性，等信息進行檢查和確認等場合；當切點參數通過通知類中定義的接口處理后再調用切點方法；如MyBatis中通過注解@SelectProvider方式生成合法的SQL語句需要對拼裝的sql語句傳入的參數進行驗證等，還有就是從安全新考慮對傳入的模塊調用者身份進行檢查，MyBatis通過注解方式定義接口實現動態SQL生成中關鍵就是對數據類型的解析    if(indexArg<0){     return true;    }    MyParameterAnnotation AdvicerClass=(MyParameterAnnotation)advicerManagerClass;    //處理切點方法參數的通知，大概思路如下：    //1.解析參數類型    //2.獲取參數值    //3.調用通知處理接口檢查參數合法性    //4.返回檢查結果 true:false   }   return true;  }  /**  *  * @Title: myAopUtilsManager  * @Description: Pointcut method execute advice interface  * @param @param advicerManagerClass 類型  * @param @param paraValues pointcut傳入參數  * @param @param paraTypes pointcut傳入參數類型  * @return void  * @throws  */  private static boolean methodAdvicerUtils(Annotation advicerManagerClass,Object[] paraValues, Class<?>... paraTypes){   return parameterAdvicerUtils(advicerManagerClass,-1,paraValues,paraTypes);  }  /**  *  * @Title: excuteMethodAdvicers  * @Description: TODO  * @param @param pointJoinMethod  * @param @param paraValues  * @return void  * @throws  */  private static boolean excuteMethodAdvicers(Method pointJoinMethod,Object[] paraValues){   boolean result=true;   Annotation[] methodAnns=pointJoinMethod.getAnnotations();   for(Annotation methodAnn:methodAnns){    result=methodAdvicerUtils(methodAnn, paraValues,pointJoinMethod.getParameterTypes());    if(!result){     break;    }   }   return result;  }  /**  *  * @Title: excuteParameterAdvicers  * @Description: TODO  * @param @param pointJoinMethod  * @param @param paraValues  * @param @return  * @return boolean  * @throws  */  private static boolean excuteParameterAdvicers(Method pointJoinMethod,Object[] paraValues){   boolean result=true;     Annotation[][] parameterAnns=pointJoinMethod.getParameterAnnotations();   if(parameterAnns==null||parameterAnns.length==0){    return result;   }   for(int index=0;index<parameterAnns.length;index++){    if(!result){     break;    }    Annotation[] argAnns=parameterAnns[index];    for(Annotation argAnn:argAnns){     result=parameterAdvicerUtils(argAnn,index, paraValues,pointJoinMethod.getParameterTypes());     if(!result){      break;     }    }   }   return result;  }  /**  *  * @Title: excuteAdvicer  * @Description: TODO  * @param @param pointJoinMethod 切點函數  * @param @param paraValues 切點函數 實參  * @param @param methodResultObj 切點函數 返回類型  * @param @return  * @return boolean  * @throws  */  /**  *  * @Title: excuteAdvicer  * @Description: TODO  * @param @param pointJoinMethod 切點函數  * @param @param paraValues 切點函數  * @return void  * @throws  */  public static boolean excuteAdvicer(Method pointJoinMethod,Object[] paraValues,Object methodResultObj){   boolean result=false;   if(excuteParameterAdvicers(pointJoinMethod,paraValues))//切點函數定義的需要驗證的通知驗證通過后執行   {    result=excuteMethodAdvicers(pointJoinMethod, paraValues);   }   return result;  } }
 

第三步:定義業務測試類

主要功能:實際開發中的業務核心類

  
package com.dbc.yangg.project;
/** * * @ClassName: TestAnnotation * @Description: 測試模塊中核心邏輯處理類,使用AOP實現日志管理、安全管理、事務管理 * @author guoyang2011@gmail.com * @date 2014年1月18日 下午11:41:55 * */ @MyClassAnnotation("TestAnnotation") public class TestAnnotation extends AbstractTestAnnotation{  @MyMethodAnnotation(methodName = "print")  public void print() {   // TODO Auto-generated method stub   System.out.println("pointcut method1 running,method name:print");  }  /**  *  * 定義切點  * 通知類{@link MyTestAdvice}  * 通知方式函數名:doSomeIdleThing  * @param parameter  * @see com.dbc.yangg.project.AbstractTestAnnotation#setParameter(java.lang.String[])  */  @MyPointcutAnnotation(className = MyTestAdvice.class, method = "doSomeIdleThing")  public void setParameter(    @MyParameterAnnotation(      opType = { MyAopParameterOPType.checkForDB,MyAopParameterOPType.checkForSecurity },      paraType = String[].class)    String[] parameter) {   // TODO Auto-generated method stub   System.out.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");   System.out.println("business method running...");   System.out.println("<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<");  } }

第四步:定義業務AOP處理類

功能：當執行核心業務中切點時執行的通知

package com.dbc.yangg.project;
/** * * @ClassName: MyTestAdvice * @Description: spring AOP{@link TestAnnotation}}切點處理類 (同spring AOP 切面類@Aspect) * @author guoyang2011@gmail.com * @date 2014年1月18日 下午11:38:09 * */ public class MyTestAdvice {  /**  *  * @Title: doSomeIdleThing  * @Description: {@link TestAnnotation}中setParameter切點執行時觸發此通知@Before,@After,@Around,@AfterThrowing,@AfterReturning<br>  * @param @param parameter  * @return void  * @throws  */  public void doSomeIdleThing(String[] parameter){   System.out.println(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>");   System.out.println("proxy method start running...");   for(String str:parameter){    System.out.println("advice writer!print point args value:"+str);   }   System.out.println("<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<");  } }

第五步:測試

package com.dbc.yangg.project;  

import java.lang.annotation.Annotation; import java.lang.reflect.InvocationTargetException; import java.lang.reflect.Method; public class Init {  public static void main(String[] args){   try {    String[] arg={"hadoop","hbase","pig","hive","mahout","hdfs","mapreduce","yarn"};    Object[] objs=new Object[1];    objs[0]=arg;    Class busClass=Class.forName(TestAnnotation.class.getName());    Method busMethod=busClass.getMethod("setParameter", String[].class);    busMethod.invoke(busClass.newInstance(), objs);    MyAOPUtils.excuteAdvicer(busMethod,objs);   } catch (ClassNotFoundException e) {    // TODO Auto-generated catch block    e.printStackTrace();   } catch (NoSuchMethodException e) {    // TODO Auto-generated catch block    e.printStackTrace();   } catch (SecurityException e) {    // TODO Auto-generated catch block    e.printStackTrace();   } catch (IllegalAccessException e) {    // TODO Auto-generated catch block    e.printStackTrace();   } catch (IllegalArgumentException e) {    // TODO Auto-generated catch block    e.printStackTrace();   } catch (InvocationTargetException e) {    // TODO Auto-generated catch block    e.printStackTrace();   } catch (InstantiationException e) {    // TODO Auto-generated catch block    e.printStackTrace();   }  } }
測試結果: 
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
business method running... <<<<<<<<<<<<<<<<<<<<<<<<<<<<<< >>>>>>>>>>>>>>>>>>>>>>>>>>>>>> proxy method start running... advice writer:hadoop advice writer:hbase advice writer:pig advice writer:hive advice writer:mahout advice writer:hdfs advice writer:mapreduce advice writer:yarn <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

http://www.tuicool.com/articles/yAvmIb

 

 

 

 

首先當然得下載mybatis-3.0.5.jar和mybatis-spring-1.0.1.jar兩個JAR包，並放在WEB-INF的lib目錄下(如果你使用maven，則jar會根據你的pom配置的依賴自動下載，並存放在你指定的maven本地庫中，默認是~/.m2/repository)，前一個是mybatis核心包，后一個是和spring整合的包。

使用mybatis，必須有個全局配置文件configuration.xml，來配置mybatis的緩存，延遲加載等等一系列屬性，該配置文件示例如下：

Java代碼
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE configuration
  3. PUBLIC "-//ibatis.apache.org//DTD Config 3.0//EN"
  4. "http://ibatis.apache.org/dtd/ibatis-3-config.dtd">
  5. <configuration>
  6. <settings>
  7. <!-- 全局映射器啟用緩存 -->
  8. <setting name="cacheEnabled" value="true" />
  9. <!-- 查詢時，關閉關聯對象即時加載以提高性能 -->
  10. <setting name="lazyLoadingEnabled" value="true" />
  11. <!-- 設置關聯對象加載的形態，此處為按需加載字段(加載字段由SQL指 定)，不會加載關聯表的所有字段，以提高性能 -->
  12. <setting name="aggressiveLazyLoading" value="false" />
  13. <!-- 對於未知的SQL查詢，允許返回不同的結果集以達到通用的效果 -->
  14. <setting name="multipleResultSetsEnabled" value="true" />
  15. <!-- 允許使用列標簽代替列名 -->
  16. <setting name="useColumnLabel" value="true" />
  17. <!-- 允許使用自定義的主鍵值(比如由程序生成的UUID 32位編碼作為鍵值)，數據表的PK生成策略將被覆蓋 -->
  18. <setting name="useGeneratedKeys" value="true" />
  19. <!-- 給予被嵌套的resultMap以字段-屬性的映射支持 -->
  20. <setting name="autoMappingBehavior" value="FULL" />
  21. <!-- 對於批量更新操作緩存SQL以提高性能 -->
  22. <setting name="defaultExecutorType" value="BATCH" />
  23. <!-- 數據庫超過25000秒仍未響應則超時 -->
  24. <setting name="defaultStatementTimeout" value="25000" />
  25. </settings>
  26. <!-- 全局別名設置，在映射文件中只需寫別名，而不必寫出整個類路徑 -->
  27. <typeAliases>
  28. <typeAlias alias="TestBean"
  29. type="com.wotao.taotao.persist.test.dataobject.TestBean" />
  30. </typeAliases>
  31. <!-- 非注解的sql映射文件配置，如果使用mybatis注解，該mapper無需配置，但是如果mybatis注解中包含@resultMap注解，則mapper必須配置，給resultMap注解使用 -->
  32. <mappers>
  33. <mapper resource="persist/test/orm/test.xml" />
  34. </mappers>
  35. </configuration>


該文件放在資源文件的任意classpath目錄下，假設這里就直接放在資源根目錄，等會spring需要引用該文件。

查看ibatis-3-config.dtd發現除了settings和typeAliases還有其他眾多元素，比如properties,objectFactory,environments等等，這些元素基本上都包含着一些環境配置，數據源定義，數據庫事務等等，在單獨使用mybatis的時候非常重要，比如通過以構造參數的形式去實例化一個sqlsessionFactory，就像這樣：

 
Java代碼
  1. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader);
  2. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, properties);
  3. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, properties);


而typeHandlers則用來自定義映射規則，如你可以自定義將Character映射為varchar，plugins元素則放了一些攔截器接口，你可以繼承他們並做一些切面的事情，至於每個元素的細節和使用，你參考mybatis用戶指南即可。

現在我們用的是spring，因此除settings和typeAliases元素之外，其他元素將會失效，故不在此配置，spring會覆蓋這些元素的配置，比如在spring配置文件中指定c3p0數據源定義如下：

Java代碼
  1. <!-- c3p0 connection pool configuration -->
  2. <bean id="testDataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"
  3. destroy-method="close">
  4. <!-- 數據庫驅動 -->
  5. <property name="driverClass" value="${db.driver.class}" />
  6. <!-- 連接URL串 -->
  7. <property name="jdbcUrl" value="${db.url}" />
  8. <!-- 連接用戶名 -->
  9. <property name="user" value="${db.username}" />
  10. <!-- 連接密碼 -->
  11. <property name="password" value="${db.password}" />
  12. <!-- 初始化連接池時連接數量為5個 -->
  13. <property name="initialPoolSize" value="5" />
  14. <!-- 允許最小連接數量為5個 -->
  15. <property name="minPoolSize" value="5" />
  16. <!-- 允許最大連接數量為20個 -->
  17. <property name="maxPoolSize" value="20" />
  18. <!-- 允許連接池最大生成100個PreparedStatement對象 -->
  19. <property name="maxStatements" value="100" />
  20. <!-- 連接有效時間，連接超過3600秒未使用，則該連接丟棄 -->
  21. <property name="maxIdleTime" value="3600" />
  22. <!-- 連接用完時，一次產生的新連接步進值為2 -->
  23. <property name="acquireIncrement" value="2" />
  24. <!-- 獲取連接失敗后再嘗試10次，再失敗則返回DAOException異常 -->
  25. <property name="acquireRetryAttempts" value="10" />
  26. <!-- 獲取下一次連接時最短間隔600毫秒，有助於提高性能 -->
  27. <property name="acquireRetryDelay" value="600" />
  28. <!-- 檢查連接的有效性，此處小弟不是很懂什么意思 -->
  29. <property name="testConnectionOnCheckin" value="true" />
  30. <!-- 每個1200秒檢查連接對象狀態 -->
  31. <property name="idleConnectionTestPeriod" value="1200" />
  32. <!-- 獲取新連接的超時時間為10000毫秒 -->
  33. <property name="checkoutTimeout" value="10000" />
  34. </bean>


配置中的${}都是占位符，在你指定數據庫驅動打war時會自動替換，替換的值在你的父pom中配置，至於c3p0連接池的各種屬性詳細信息和用法，你自行參考c3p0的官方文檔，這里要說明的是checkoutTimeout元素，記得千萬要設大一點，單位是毫秒，假如設置太小，有可能會導致沒等數據庫響應就直接超時了，小弟在這里吃了不少苦頭，還是基本功太差。

數據源配置妥當之后，我們就要開始非常重要的sessionFactory配置了，無論是hibernate還是mybatis，都需要一個sessionFactory來生成session，sessionFactory配置如下：

Java代碼
  1. <bean id="testSqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
  2. <property name="configLocation" value="classpath:configuration.xml" />
  3. <property name="dataSource" ref="testDataSource" />
  4. </bean>


testSqlSessionFactory有兩處注入，一個就是前面提到的mybatis全局設置文件configuration.xml，另一個就是上面定義的數據源了（注：hibernate的sessionFactory只需注入hibernate.cfg.xml，數據源定義已經包含在該文件中），好了，sessionFactory已經產生了，由於我們用的mybatis3的注解，因此spring的sqlSessionTemplate也不用配置了，sqlSessionTemplate也不用注入到我們的BaseDAO中了，相應的，我們需要配置一個映射器接口來對應sqlSessionTemplate，該映射器接口定義了你自己的接口方法，具體實現不用關心，代碼如下：

Java代碼
  1. <!-- data OR mapping interface -->
  2. <bean id="testMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">
  3. <property name="sqlSessionFactory" ref="testSqlSessionFactory" />
  4. <property name="mapperInterface" value="com.wotao.taotao.persist.test.mapper.TestMapper" />
  5. </bean>


對應於sqlSessionTemplate，testMapper同樣需要testSqlSessionFactory注入，另外一個注入就是你自己定義的Mapper接口，該接口定義了操作數據庫的方法和SQL語句以及很多的注解，稍后我會講到。到此，mybatis和spring整合的文件配置就算OK了（注：如果你需要開通spring對普通類的代理功能，那么你需要在spring配置文件中加入<aop:aspectj-autoproxy />），至於其他的如事務配置，AOP切面注解等內容不在本文范圍內，不作累述。

至此，一個完整的myabtis整合spring的配置文件看起來應該如下所示：

Java代碼
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
  4. xmlns:tx="http://www.springframework.org/schema/tx" xmlns:aop="http://www.springframework.org/schema/aop"
  5. xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
  6. http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd
  7. http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd
  8. http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd">
  10. <!-- c3p0 connection pool configuration -->
  11. <bean id="testDataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"
  12. destroy-method="close">
  13. <property name="driverClass" value="${db.driver.class}" />
  14. <property name="jdbcUrl" value="${db.url}" />
  15. <property name="user" value="${db.username}" />
  16. <property name="password" value="${db.password}" />
  17. <property name="initialPoolSize" value="5" />
  18. <property name="minPoolSize" value="5" />
  19. <property name="maxPoolSize" value="20" />
  20. <property name="maxStatements" value="100" />
  21. <property name="maxIdleTime" value="3600" />
  22. <property name="acquireIncrement" value="2" />
  23. <property name="acquireRetryAttempts" value="10" />
  24. <property name="acquireRetryDelay" value="600" />
  25. <property name="testConnectionOnCheckin" value="true" />
  26. <property name="idleConnectionTestPeriod" value="1200" />
  27. <property name="checkoutTimeout" value="10000" />
  28. </bean>
  29. <bean id="testSqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
  30. <property name="configLocation" value="classpath:configuration.xml" />
  31. <property name="dataSource" ref="testDataSource" />
  32. </bean>
  33. <!-- data OR mapping interface -->
  34. <bean id="testMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">
  35. <property name="sqlSessionFactory" ref="testSqlSessionFactory" />
  36. <property name="mapperInterface" value="com.wotao.taotao.persist.test.mapper.TestMapper" />
  37. </bean>
  39. <!-- add your own Mapper here -->
  41. <!-- comment here, using annotation -->
  42. <!-- <bean id="sqlSessionTemplate" class="org.mybatis.spring.SqlSessionTemplate"> -->
  43. <!-- <constructor-arg index="0" ref="sqlSessionFactory" /> -->
  44. <!-- </bean> -->
  45. <!-- base DAO class, for module business, extend this class in DAO -->
  46. <!-- <bean id="testBaseDAO" class="com.test.dao.TestBaseDAO"> -->
  47. <!-- <property name="sqlSessionTemplate" ref="sqlSessionTemplate" /> -->
  48. <!-- </bean> -->
  49. <!-- <bean id="testDAO" class="com.test.dao.impl.TestDAOImpl" /> -->
  51. <!-- you can DI Bean if you don't like use annotation -->
  53. </beans>



到此為止，我們只講了mybatis和spring的整合，還沒有真正觸及mybatis的核心：使用mybatis注解代替映射文件編程（不過官方文檔也說了，如果真正想發揮mybatis功能，還是需要用到映射文件，看來myabtis自己都對mybatis注解沒信心，呵呵），通過上述內容，我們知道配置搞定，但是testMapper還沒有被實現，而注解的使用，全部集中在這個testMapper上，是mybatis注解的核心所在，先來看一下這個testMapper接口是個什么樣的：

Java代碼
  1. /**
  2. * The test Mapper interface.
  3. *
  4. * @author HuangMin <a href="mailto:minhuang@hengtiansoft.com>send email</a>
  5. *
  6. * @since 1.6
  7. * @version 1.0
  8. *
  9. * #~TestMapper.java 2011-9-23 : afternoon 10:51:40
  10. */
  11. @CacheNamespace(size = 512)
  12. public interface TestMapper {
  14. /**
  15. * get test bean by UID.
  16. *
  17. * @param id
  18. * @return
  19. */
  20. @SelectProvider(type = TestSqlProvider.class, method = "getSql")
  21. @Options(useCache = true, flushCache = false, timeout = 10000)
  22. @Results(value = {
  23. @Result(id = true, property = "id", column = "test_id", javaType = String.class, jdbcType = JdbcType.VARCHAR),
  24. @Result(property = "testText", column = "test_text", javaType = String.class, jdbcType = JdbcType.VARCHAR) })
  25. public TestBean get(@Param("id") String id);
  27. /**
  28. * get all tests.
  29. *
  30. * @return
  31. */
  32. @SelectProvider(type = TestSqlProvider.class, method = "getAllSql")
  33. @Options(useCache = true, flushCache = false, timeout = 10000)
  34. @Results(value = {
  35. @Result(id = true, property = "id", column = "test_id", javaType = String.class, jdbcType = JdbcType.VARCHAR),
  36. @Result(property = "testText", column = "test_text", javaType = String.class, jdbcType = JdbcType.VARCHAR) })
  37. public List<TestBean> getAll();
  39. /**
  40. * get tests by test text.
  41. *
  42. * @param testText
  43. * @return
  44. */
  45. @SelectProvider(type = TestSqlProvider.class, method = "getByTestTextSql")
  46. @Options(useCache = true, flushCache = false, timeout = 10000)
  47. @ResultMap(value = "getByTestText")
  48. public List<TestBean> getByTestText(@Param("testText") String testText);
  50. /**
  51. * insert a test bean into database.
  52. *
  53. * @param testBean
  54. */
  55. @InsertProvider(type = TestSqlProvider.class, method = "insertSql")
  56. @Options(flushCache = true, timeout = 20000)
  57. public void insert(@Param("testBean") TestBean testBean);
  59. /**
  60. * update a test bean with database.
  61. *
  62. * @param testBean
  63. */
  64. @UpdateProvider(type = TestSqlProvider.class, method = "updateSql")
  65. @Options(flushCache = true, timeout = 20000)
  66. public void update(@Param("testBean") TestBean testBean);
  68. /**
  69. * delete a test by UID.
  70. *
  71. * @param id
  72. */
  73. @DeleteProvider(type = TestSqlProvider.class, method = "deleteSql")
  74. @Options(flushCache = true, timeout = 20000)
  75. public void delete(@Param("id") String id);
  76. }


下面逐個對里面的注解進行分析：
@CacheNamespace(size = 512) ： 定義在該命名空間內允許使用內置緩存，最大值為512個對象引用，讀寫默認是開啟的，緩存內省刷新時間為默認3600000毫秒，寫策略是拷貝整個對象鏡像到全新堆（如同CopyOnWriteList）因此線程安全。

@SelectProvider(type = TestSqlProvider.class, method = "getSql") ： 提供查詢的SQL語句，如果你不用這個注解，你也可以直接使用@Select("select * from ....")注解，把查詢SQL抽取到一個類里面，方便管理，同時復雜的SQL也容易操作，type = TestSqlProvider.class就是存放SQL語句的類，而method = "getSql"表示get接口方法需要到TestSqlProvider類的getSql方法中獲取SQL語句。

@Options(useCache = true, flushCache = false, timeout = 10000) ： 一些查詢的選項開關，比如useCache = true表示本次查詢結果被緩存以提高下次查詢速度，flushCache = false表示下次查詢時不刷新緩存，timeout = 10000表示查詢結果緩存10000秒。

@Results(value = {
@Result(id = true, property = "id", column = "test_id", javaType = String.class, jdbcType = JdbcType.VARCHAR),
@Result(property = "testText", column = "test_text", javaType = String.class, jdbcType = JdbcType.VARCHAR) }) ： 表示sql查詢返回的結果集，@Results是以@Result為元素的數組，@Result表示單條屬性-字段的映射關系，如：@Result(id = true, property = "id", column = "test_id", javaType = String.class, jdbcType = JdbcType.VARCHAR)可以簡寫為：@Result(id = true, property = "id", column = "test_id")，id = true表示這個test_id字段是個PK，查詢時mybatis會給予必要的優化，應該說數組中所有的@Result組成了單個記錄的映射關系，而@Results則單個記錄的集合。另外還有一個非常重要的注解@ResultMap也和@Results差不多，到時會講到。

@Param("id") ：全局限定別名，定義查詢參數在sql語句中的位置不再是順序下標0,1,2,3....的形式，而是對應名稱，該名稱就在這里定義。

@ResultMap(value = "getByTestText") ：重要的注解，可以解決復雜的映射關系，包括resultMap嵌套，鑒別器discriminator等等。注意一旦你啟用該注解，你將不得不在你的映射文件中配置你的resultMap，而value = "getByTestText"即為映射文件中的resultMap ID(注意此處的value = "getByTestText"，必須是在映射文件中指定命名空間路徑)。@ResultMap在某些簡單場合可以用@Results代替，但是復雜查詢，比如聯合、嵌套查詢@ResultMap就會顯得解耦方便更容易管理。
一個映射文件如下所示：

Java代碼
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE mapper
  3. PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN"
  4. "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd">
  6. <mapper namespace="com.wotao.taotao.persist.test.mapper.TestMapper">
  7. <resultMap id="getByTestText" type="TestBean">
  8. <id property="id" column="test_id" javaType="string" jdbcType="VARCHAR" />
  9. <result property="testText" column="test_text" javaType="string" jdbcType="VARCHAR" />
  10. </resultMap>
  11. </mapper>


注意文件中的namespace路徑必須是使用@resultMap的類路徑，此處是TestMapper，文件中 id="getByTestText"必須和@resultMap中的value = "getByTestText"保持一致。

@InsertProvider(type = TestSqlProvider.class, method = "insertSql") ：用法和含義@SelectProvider一樣，只不過是用來插入數據庫而用的。

@Options(flushCache = true, timeout = 20000) ：對於需要更新數據庫的操作，需要重新刷新緩存flushCache = true使緩存同步。

@UpdateProvider(type = TestSqlProvider.class, method = "updateSql") ：用法和含義@SelectProvider一樣，只不過是用來更新數據庫而用的。

@Param("testBean") ：是一個自定義的對象，指定了sql語句中的表現形式，如果要在sql中引用對象里面的屬性，只要使用testBean.id，testBean.textText即可，mybatis會通過反射找到這些屬性值。

@DeleteProvider(type = TestSqlProvider.class, method = "deleteSql") ：用法和含義@SelectProvider一樣，只不過是用來刪除數據而用的。

現在mybatis注解基本已經講完了，接下來我們就要開始寫SQL語句了，因為我們不再使用映射文件編寫SQL，那么就不得不在java類里面寫，就像上面提到的，我們不得不在TestSqlProvider這個類里面寫SQL，雖然已經把所有sql語句集中到了一個類里面去管理，但聽起來似乎仍然有點惡心，幸好mybatis提供SelectBuilder和SqlBuilder這2個小工具來幫助我們生成SQL語句，SelectBuilder專門用來生成select語句，而SqlBuilder則是一般性的工具，可以生成任何SQL語句，我這里選擇了SqlBuilder來生成，TestSqlProvider代碼如下：

Java代碼
  1. /*
  2. * #~ test-afternoon10:51:40
  3. */
  4. package com.wotao.taotao.persist.test.sqlprovider;
  6. import static org.apache.ibatis.jdbc.SqlBuilder.BEGIN;
  7. import static org.apache.ibatis.jdbc.SqlBuilder.FROM;
  8. import static org.apache.ibatis.jdbc.SqlBuilder.SELECT;
  9. import static org.apache.ibatis.jdbc.SqlBuilder.SQL;
  10. import static org.apache.ibatis.jdbc.SqlBuilder.WHERE;
  11. import static org.apache.ibatis.jdbc.SqlBuilder.DELETE_FROM;
  12. import static org.apache.ibatis.jdbc.SqlBuilder.INSERT_INTO;
  13. import static org.apache.ibatis.jdbc.SqlBuilder.SET;
  14. import static org.apache.ibatis.jdbc.SqlBuilder.UPDATE;
  15. import static org.apache.ibatis.jdbc.SqlBuilder.VALUES;
  17. import java.util.Map;
  19. /**
  20. * The test sql Provider,define the sql script for mapping.
  21. *
  22. * @author HuangMin <a href="mailto:minhuang@hengtiansoft.com>send email</a>
  23. *
  24. * @since 1.6
  25. * @version 1.0
  26. *
  27. * #~TestSqlProvider.java 2011-9-23 : afternoon 10:51:40
  28. */
  29. public class TestSqlProvider {
  31. /** table name, here is test */
  32. private static final String TABLE_NAME = "test";
  34. /**
  35. * get test by id sql script.
  36. *
  37. * @param parameters
  38. * @return
  39. */
  40. public String getSql(Map<String, Object> parameters) {
  41. String uid = (String) parameters.get("id");
  42. BEGIN();
  43. SELECT("test_id, test_text");
  44. FROM(TABLE_NAME);
  45. if (uid != null) {
  46. WHERE("test_id = #{id,javaType=string,jdbcType=VARCHAR}");
  47. }
  48. return SQL();
  49. }
  51. /**
  52. * get all tests sql script.
  53. *
  54. * @return
  55. */
  56. public String getAllSql() {
  57. BEGIN();
  58. SELECT("test_id, test_text");
  59. FROM(TABLE_NAME);
  60. return SQL();
  61. }
  63. /**
  64. * get test by test text sql script.
  65. *
  66. * @param parameters
  67. * @return
  68. */
  69. public String getByTestTextSql(Map<String, Object> parameters) {
  70. String tText = (String) parameters.get("testText");
  71. BEGIN();
  72. SELECT("test_id, test_text");
  73. FROM(TABLE_NAME);
  74. if (tText != null) {
  75. WHERE("test_text like #{testText,javaType=string,jdbcType=VARCHAR}");
  76. }
  77. return SQL();
  78. }
  80. /**
  81. * insert a test sql script.
  82. *
  83. * @return
  84. */
  85. public String insertSql() {
  86. BEGIN();
  87. INSERT_INTO(TABLE_NAME);
  88. VALUES("test_id", "#{testBean.id,javaType=string,jdbcType=VARCHAR}");
  89. VALUES("test_text", "#{testBean.testText,javaType=string,jdbcType=VARCHAR}");
  90. return SQL();
  91. }
  93. /**
  94. * update a test sql script.
  95. *
  96. * @return
  97. */
  98. public String updateSql() {
  99. BEGIN();
  100. UPDATE(TABLE_NAME);
  101. SET("test_text = #{testBean.testText,javaType=string,jdbcType=VARCHAR}");
  102. WHERE("test_id = #{testBean.id,javaType=string,jdbcType=VARCHAR}");
  103. return SQL();
  104. }
  106. /**
  107. * delete a test sql script.
  108. *
  109. * @return
  110. */
  111. public String deleteSql() {
  112. BEGIN();
  113. DELETE_FROM(TABLE_NAME);
  114. WHERE("test_id = #{id,javaType=string,jdbcType=VARCHAR}");
  115. return SQL();
  116. }
  117. }


BEGIN();表示刷新本地線程，某些變量為了線程安全，會先在本地存放變量，此處需要刷新。
SELECT，FROM，WHERE等等都是sqlbuilder定義的公用靜態方法，用來組成你的sql字符串。如果你在testMapper中調用該方法的某個接口方法已經定義了參數@Param()，那么該方法的參數Map<String, Object> parameters即組裝了@Param()定義的參數，比如testMapper接口方法中定義參數為@Param("testId"),@Param("testText")，那么parameters的形態就是：[key="testId",value=object1],[key="testText",value=object2]，如果接口方法沒有定義@Param()，那么parameters的key就是參數的順序小標：[key=0,value=object1],[key=1,value=object2]，SQL()將返回最終append結束的字符串，sql語句中的形如
#{id,javaType=string,jdbcType=VARCHAR}完全可簡寫為#{id}，我只是為了規整如此寫而已。另外，對於復雜查詢還有很多標簽可用，比如：JOIN，INNER_JOIN，GROUP_BY，ORDER_BY等等，具體使用詳情，你可以查看源碼。

最后記得把你的Mapper接口注入到你的DAO類中，在DAO中引用Mapper接口方法即可。我在BaseDAO中的注解注入如下：

Java代碼
  1. ......
  2. @Repository("testBaseDAO")
  3. public class TestBaseDAO {
  4. ......

 

Java代碼
  1. ......
  2. /**
  3. * @param testMapper
  4. * the testMapper to set
  5. */
  6. @Autowired
  7. public void setTestMapper(@Qualifier("testMapper") TestMapper testMapper) {
  8. this.testMapper = testMapper;
  9. }
  10. ......

 

引自：http://wwww.iteye.com/blog/1235996

 

http://www.cnblogs.com/ibook360/archive/2012/07/16/2594056.html

 


免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。



猜您在找 mybatis注解詳解 mybatis注解詳解 mybatis 詳解（三）------入門實例（基於注解） spring mvc 注解詳解（springMvc mybatis spring） 詳解spring boot mybatis全注解化 springboot中使用mybatis注解配置詳解 MyBatis中的@Mapper注解及配套注解使用詳解 MyBatis中的@Mapper注解及配套注解使用詳解（上） Mybatis3詳解（六）----通過注解映射實現Mybatis實例 MyBatis注解
 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM