mybatis語(yǔ)法和介紹,詳細(xì).doc

一、MyBatis簡(jiǎn)介與配置MyBatis+Spring+MySql1.1MyBatis簡(jiǎn)介 MyBatis 是一個(gè)可以自定義SQL、存儲(chǔ)過程和高級(jí)映射的持久層框架。MyBatis 摒除了大部分的JDBC代碼、手工設(shè)置參數(shù)和結(jié)果集重獲。MyBatis 只使用簡(jiǎn)單的XML 和注解來配置和映射基本數(shù)據(jù)類型、Map 接口和POJO 到數(shù)據(jù)庫(kù)記錄。相對(duì)Hibernate和Apache OJB等“一站式”O(jiān)RM解決方案而言，Mybatis 是一種“半自動(dòng)化”的ORM實(shí)現(xiàn)。需要使用的Jar包：mybatis-3.0.2.jar（mybatis核心包）。mybatis-spring-1.0.0.jar(與Spring結(jié)合包)。下載地址：/tools/ibator/p/mybatis/1.2MyBatis+Spring+MySql簡(jiǎn)單配置1.2.1搭建Spring環(huán)境1,建立maven的web項(xiàng)目；2,加入Spring框架、配置文件；3,在pom.xml中加入所需要的jar包（spring框架的、mybatis、mybatis-spring、junit等）；4,更改web.xml和spring的配置文件；5,添加一個(gè)jsp頁(yè)面和對(duì)應(yīng)的Controller；6,測(cè)試?？蓞⒄眨?blog/830409。使用Eclipse的Maven構(gòu)建SpringMVC項(xiàng)目1.2.2建立MySql數(shù)據(jù)庫(kù)建立一個(gè)學(xué)生選課管理數(shù)據(jù)庫(kù)。表：學(xué)生表、班級(jí)表、教師表、課程表、學(xué)生選課表。邏輯關(guān)系：每個(gè)學(xué)生有一個(gè)班級(jí)；每個(gè)班級(jí)對(duì)應(yīng)一個(gè)班主任教師；每個(gè)教師只能當(dāng)一個(gè)班的班主任；使用下面的sql進(jìn)行建數(shù)據(jù)庫(kù)，先建立學(xué)生表，插入數(shù)據(jù)（2條以上）。更多sql請(qǐng)下載項(xiàng)目源文件，在resource/sql中。Sql代碼1. /*建立數(shù)據(jù)庫(kù)*/2. CREATEDATABASESTUDENT_MANAGER;3. USESTUDENT_MANAGER;4. 5. /*建立student表*/6. CREATETABLESTUDENT_TBL7. (8. STUDENT_IDVARCHAR(255)PRIMARYKEY,9. STUDENT_NAMEVARCHAR(10)NOTNULL,10. STUDENT_SEXVARCHAR(10),11. STUDENT_BIRTHDAYDATE,12. CLASS_IDVARCHAR(255)13. );14. 15. /*插入學(xué)生數(shù)據(jù)*/16. INSERTINTOSTUDENT_TBL(STUDENT_ID,17. STUDENT_NAME,18. STUDENT_SEX,19. STUDENT_BIRTHDAY,20. CLASS_ID)21. VALUES(123456,22. 某某某,23. 女,24. 1980-08-01,25. 12154626. )創(chuàng)建連接MySql使用的配置文件perties。Mperties代碼1. jdbc.driverClassName=com.mysql.jdbc.Driver2. jdbc.url=jdbc:mysql:/localhost:3306/student_manager?user=root&password=limingnihao&useUnicode=true&characterEncoding=UTF-81.2.3搭建MyBatis環(huán)境順序隨便，現(xiàn)在的順序是因?yàn)榭梢员M量的少的修改寫好的文件。創(chuàng)建實(shí)體類: StudentEntityJava代碼1. publicclassStudentEntityimplementsSerializable2. 3. privatestaticfinallongserialVersionUID=3096154202413606831L;4. privateClassEntityclassEntity;5. privateDatestudentBirthday;6. privateStringstudentID;7. privateStringstudentName;8. privateStringstudentSex;9. 10. publicClassEntitygetClassEntity()11. returnclassEntity;12. 13. 14. publicDategetStudentBirthday()15. returnstudentBirthday;16. 17. 18. publicStringgetStudentID()19. returnstudentID;20. 21. 22. publicStringgetStudentName()23. returnstudentName;24. 25. 26. publicStringgetStudentSex()27. returnstudentSex;28. 29. 30. publicvoidsetClassEntity(ClassEntityclassEntity)31. this.classEntity=classEntity;32. 33. 34. publicvoidsetStudentBirthday(DatestudentBirthday)35. this.studentBirthday=studentBirthday;36. 37. 38. publicvoidsetStudentID(StringstudentID)39. this.studentID=studentID;40. 41. 42. publicvoidsetStudentName(StringstudentName)43. this.studentName=studentName;44. 45. 46. publicvoidsetStudentSex(StringstudentSex)47. this.studentSex=studentSex;48. 49. 創(chuàng)建數(shù)據(jù)訪問接口Student類對(duì)應(yīng)的dao接口：StudentMapper。Java代碼1. publicinterfaceStudentMapper2. 3. publicStudentEntitygetStudent(StringstudentID);4. 5. publicStudentEntitygetStudentAndClass(StringstudentID);6. 7. publicListgetStudentAll();8. 9. publicvoidinsertStudent(StudentEntityentity);10. 11. publicvoiddeleteStudent(StudentEntityentity);12. 13. publicvoidupdateStudent(StudentEntityentity);14. 創(chuàng)建SQL映射語(yǔ)句文件Student類的sql語(yǔ)句文件StudentMapper.xmlresultMap標(biāo)簽：表字段與屬性的映射。Select標(biāo)簽：查詢sql。Xml代碼1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 18. 19. 20. 21. 22. 25. 26. 27. 創(chuàng)建MyBatis的mapper配置文件在src/main/resource中創(chuàng)建MyBatis配置文件：mybatis-config.xml。typeAliases標(biāo)簽：給類起一個(gè)別名。com.manager.data.model.StudentEntity類，可以使用StudentEntity代替。Mappers標(biāo)簽：加載MyBatis中實(shí)體類的SQL映射語(yǔ)句文件。Xml代碼1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 修改Spring 的配置文件主要是添加SqlSession的制作工廠類的bean：SqlSessionFactoryBean，（在mybatis.spring包中）。需要指定配置文件位置和dataSource。和數(shù)據(jù)訪問接口對(duì)應(yīng)的實(shí)現(xiàn)bean。通過MapperFactoryBean創(chuàng)建出來。需要執(zhí)行接口類全稱和SqlSession工廠bean的引用。Xml代碼1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 也可以不定義mapper的bean，使用注解：將StudentMapper加入注解Java代碼1. Repository2. Transactional3. publicinterfaceStudentMapper4. 對(duì)應(yīng)的需要在dispatcher-servlet.xml中加入掃描：Xml代碼1. 2. 3. 4. 5. 1.2.4測(cè)試StudentMapper使用SpringMVC測(cè)試，創(chuàng)建一個(gè)TestController，配置tomcat，訪問index.do頁(yè)面進(jìn)行測(cè)試：Java代碼1. Controller2. publicclassTestController3. 4. Autowired5. privateStudentMapperstudentMapper;6. 7. RequestMapping(value=index.do)8. publicvoidindexPage()9. StudentEntityentity=studentMapper.getStudent(10000013);10. System.out.println(name：+entity.getStudentName();11. 12. 使用Junit測(cè)試：Java代碼1. 使用Junit測(cè)試：2. Java代碼3. RunWith(value=SpringJUnit4ClassRunner.class)4. ContextConfiguration(value=test-servlet.xml)5. publicclassStudentMapperTest6. 7. Autowired8. privateClassMapperclassMapper;9. 10. Autowired11. privateStudentMapperstudentMapper;12. 13. Transactional14. publicvoidgetStudentTest()15. StudentEntityentity=studentMapper.getStudent(10000013);16. System.out.println(+entity.getStudentID()+entity.getStudentName();17. 18. ListstudentList=studentMapper.getStudentAll();19. for(StudentEntityentityTemp:studentList)20. System.out.println(entityTemp.getStudentName();21. 22. 23. 24. 有些時(shí)候，sql語(yǔ)句where條件中，需要一些安全判斷，例如按某一條件查詢時(shí)如果傳入的參數(shù)是空，此時(shí)查詢出的結(jié)果很可能是空的，也許我們需要參數(shù)為空時(shí)，是查出全部的信息。使用Oracle的序列、mysql的函數(shù)生成Id。這時(shí)我們可以使用動(dòng)態(tài)sql。下文均采用mysql語(yǔ)法和函數(shù)（例如字符串鏈接函數(shù)CONCAT）。二、SQL語(yǔ)句映射文件(1)resultMapSQL 映射XML 文件是所有sql語(yǔ)句放置的地方。需要定義一個(gè)workspace，一般定義為對(duì)應(yīng)的接口類的路徑。寫好SQL語(yǔ)句映射文件后，需要在MyBAtis配置文件mappers標(biāo)簽中引用，例如：Xml代碼1. 2. 3. 4. 5. 6. 當(dāng)Java接口與XML文件在一個(gè)相對(duì)路徑下時(shí)，可以不在myBatis配置文件的mappers中聲明。SQL 映射XML 文件一些初級(jí)的元素：1.cache 配置給定模式的緩存2.cache-ref 從別的模式中引用一個(gè)緩存3.resultMap 這是最復(fù)雜而卻強(qiáng)大的一個(gè)元素了，它描述如何從結(jié)果集中加載對(duì)象4.sql 一個(gè)可以被其他語(yǔ)句復(fù)用的SQL 塊5.insert 映射INSERT 語(yǔ)句6.update 映射UPDATE 語(yǔ)句7.delete 映射DELEETE 語(yǔ)句8.select - 映射SELECT語(yǔ)句2.1 resultMap resultMap 是MyBatis 中最重要最強(qiáng)大的元素了。你可以讓你比使用JDBC 調(diào)用結(jié)果集省掉90%的代碼，也可以讓你做許多JDBC 不支持的事?，F(xiàn)實(shí)上，要寫一個(gè)等同類似于交互的映射這樣的復(fù)雜語(yǔ)句，可能要上千行的代碼。ResultMaps 的目的，就是這樣簡(jiǎn)單的語(yǔ)句而不需要多余的結(jié)果映射，更多復(fù)雜的語(yǔ)句，除了只要一些絕對(duì)必須的語(yǔ)句描述關(guān)系以外，再也不需要其它的。resultMap屬性：type為java實(shí)體類；id為此resultMap的標(biāo)識(shí)。resultMap可以設(shè)置的映射：1.constructor 用來將結(jié)果反射給一個(gè)實(shí)例化好的類的構(gòu)造器a)idArg ID 參數(shù)；將結(jié)果集標(biāo)記為ID，以方便全局調(diào)用b)arg 反射到構(gòu)造器的通常結(jié)果2.id ID 結(jié)果，將結(jié)果集標(biāo)記為ID，以方便全局調(diào)用3.result 反射到JavaBean 屬性的普通結(jié)果4.association 復(fù)雜類型的結(jié)合；多個(gè)結(jié)果合成的類型a)nested result mappings 幾resultMap 自身嵌套關(guān)聯(lián)，也可以引用到一個(gè)其它上5.collection 復(fù)雜類型集合a collection of complex types6.nested result mappings resultMap 的集合，也可以引用到一個(gè)其它上7.discriminator 使用一個(gè)結(jié)果值以決定使用哪個(gè)resultMapa)case 基本一些值的結(jié)果映射的case 情形i.nested result mappings 一個(gè)case 情形本身就是一個(gè)結(jié)果映射，因此也可以包括一些相同的元素，也可以引用一個(gè)外部resultMap。2.1.1 id、resultid、result是最簡(jiǎn)單的映射，id為主鍵映射；result其他基本數(shù)據(jù)庫(kù)表字段到實(shí)體類屬性的映射。最簡(jiǎn)單的例子：Xml代碼1. 2. 3. 4. 5. 6. 7. id、result語(yǔ)句屬性配置細(xì)節(jié)：屬性描述property需要映射到JavaBean的屬性名稱。column數(shù)據(jù)表的列名或者標(biāo)簽別名。javaType一個(gè)完整的類名，或者是一個(gè)類型別名。如果你匹配的是一個(gè)JavaBean，那MyBatis通常會(huì)自行檢測(cè)到。然后，如果你是要映射到一個(gè)HashMap，那你需要指定javaType要達(dá)到的目的。jdbcType數(shù)據(jù)表支持的類型列表。這個(gè)屬性只在insert,update或delete的時(shí)候針對(duì)允許空的列有用。JDBC需要這項(xiàng)，但MyBatis不需要。如果你是直接針對(duì)JDBC編碼，且有允許空的列，而你要指定這項(xiàng)。typeHandler使用這個(gè)屬性可以覆寫類型處理器。這項(xiàng)值可以是一個(gè)完整的類名，也可以是一個(gè)類型別名。支持的JDBC類型 為了將來的引用，MyBatis 支持下列JDBC 類型，通過JdbcType 枚舉：BIT，F(xiàn)LOAT，CHAR，TIMESTAMP，OTHER，UNDEFINED，TINYINT，REAL，VARCHAR，BINARY，BLOB，NVARCHAR，SMALLINT，DOUBLE，LONGVARCHAR，VARBINARY，CLOB，NCHAR，INTEGER，NUMERIC，DATE，LONGVARBINARY，BOOLEAN，NCLOB，BIGINT，DECIMAL，TIME，NULL，CURSOR2.1.2 constructor 我們使用id、result時(shí)候，需要定義java實(shí)體類的屬性映射到數(shù)據(jù)庫(kù)表的字段上。這個(gè)時(shí)候是使用JavaBean實(shí)現(xiàn)的。當(dāng)然我們也可以使用實(shí)體類的構(gòu)造方法來實(shí)現(xiàn)值的映射，這個(gè)時(shí)候是通過構(gòu)造方法參數(shù)的書寫的順序來進(jìn)行賦值的。 使用construcotr功能有限（例如使用collection級(jí)聯(lián)查詢）。 上面使用id、result實(shí)現(xiàn)的功能就可以改為：Xml代碼1. 2. 3. 4. 5. 6. 7. 8. 當(dāng)然，我們需要定義StudentEntity實(shí)體類的構(gòu)造方法：Java代碼1. publicStudentEntity(StringstudentID,StringstudentName,StringstudentSex,DatestudentBirthday)2. this.studentID=studentID;3. this.studentName=studentName;4. this.studentSex=studentSex;5. this.studentBirthday=studentBirthday;6. 2.1.3 association聯(lián)合聯(lián)合元素用來處理“一對(duì)一”的關(guān)系。需要指定映射的Java實(shí)體類的屬性，屬性的javaType（通常MyBatis 自己會(huì)識(shí)別）。對(duì)應(yīng)的數(shù)據(jù)庫(kù)表的列名稱。如果想覆寫的話返回結(jié)果的值，需要指定typeHandler。不同情況需要告訴MyBatis 如何加載一個(gè)聯(lián)合。MyBatis 可以用兩種方式加載：1.select: 執(zhí)行一個(gè)其它映射的SQL 語(yǔ)句返回一個(gè)Java實(shí)體類型。較靈活；2.resultsMap: 使用一個(gè)嵌套的結(jié)果映射來處理通過join查詢結(jié)果集，映射成Java實(shí)體類型。例如，一個(gè)班級(jí)對(duì)應(yīng)一個(gè)班主任。首先定義好班級(jí)中的班主任屬性：Java代碼1. privateTeacherEntityteacherEntity;使用select實(shí)現(xiàn)聯(lián)合例：班級(jí)實(shí)體類中有班主任的屬性，通過聯(lián)合在得到一個(gè)班級(jí)實(shí)體時(shí)，同時(shí)映射出班主任實(shí)體。這樣可以直接復(fù)用在TeacherMapper.xml文件中定義好的查詢teacher根據(jù)其ID的select語(yǔ)句。而且不需要修改寫好的SQL語(yǔ)句，只需要直接修改resultMap即可。ClassMapper.xml文件部分內(nèi)容：Xml代碼1. 2. 3. 4. 5. 6. 7. 8. 9. SELECT*FROMCLASS_TBLCT10. WHERECT.CLASS_ID=#classID;11. TeacherMapper.xml文件部分內(nèi)容：Xml代碼1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. SELECT*12. FROMTEACHER_TBLTT13. WHERETT.TEACHER_ID=#teacherID14. 使用resultMap實(shí)現(xiàn)聯(lián)合與上面同樣的功能，查詢班級(jí)，同時(shí)查詢器班主任。需在association中添加resultMap（在teacher的xml文件中定義好的），新寫sql（查詢班級(jí)表left join教師表），不需要teacher的select。修改ClassMapper.xml文件部分內(nèi)容：Xml代碼1. 2. 3. 4. 5. 6. 7. 8. 9. SELECT*10. FROMCLASS_TBLCTLEFTJOINTEACHER_TBLTTONCT.TEACHER_ID=TT.TEACHER_ID11. WHERECT.CLASS_ID=#classID;12. 其中的teacherResultMap請(qǐng)見上面TeacherMapper.xml文件部分內(nèi)容中。2.1.4 collection聚集聚集元素用來處理“一對(duì)多”的關(guān)系。需要指定映射的Java實(shí)體類的屬性，屬性的javaType（一般為ArrayList）；列表中對(duì)象的類型ofType（Java實(shí)體類）；對(duì)應(yīng)的數(shù)據(jù)庫(kù)表的列名稱；不同情況需要告訴MyBatis 如何加載一個(gè)聚集。MyBatis 可以用兩種方式加載：1.select: 執(zhí)行一個(gè)其它映射的SQL 語(yǔ)句返回一個(gè)Java實(shí)體類型。較靈活；2.resultsMap: 使用一個(gè)嵌套的結(jié)果映射來處理通過join查詢結(jié)果集，映射成Java實(shí)體類型。例如，一個(gè)班級(jí)有多個(gè)學(xué)生。首先定義班級(jí)中的學(xué)生列表屬性：Java代碼1. privateListstudentList;使用select實(shí)現(xiàn)聚集用法和聯(lián)合很類似，區(qū)別在于，這是一對(duì)多，所以一般映