詳解Java的MyBatis框架中SQL語(yǔ)句映射部分的編寫(xiě)
1.resultMap
SQL 映射XML 文件是所有sql語(yǔ)句放置的地方。需要定義一個(gè)workspace，一般定義為對(duì)應(yīng)的接口類(lèi)的路徑。寫(xiě)好SQL語(yǔ)句映射文件后，需要在MyBAtis配置文件mappers標(biāo)簽中引用，例如：
<mappers> <mapper resource="com/liming/manager/data/mappers/UserMapper.xml" /> <mapper resource="com/liming/manager/data/mappers/StudentMapper.xml" /> <mapper resource="com/liming/manager/data/mappers/ClassMapper.xml" /> <mapper resource="com/liming/manager/data/mappers/TeacherMapper.xml" /> </mappers>
當(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ǔ)句
1.1 resultMap
resultMap 是MyBatis 中最重要最強(qiáng)大的元素了。你可以讓你比使用JDBC 調(diào)用結(jié)果集省掉90%的代碼，也可以讓你做許多JDBC 不支持的事?，F(xiàn)實(shí)上，要寫(xiě)一個(gè)等同類(lèi)似于交互的映射這樣的復(fù)雜語(yǔ)句，可能要上千行的代碼。ResultMaps的目的，就是這樣簡(jiǎn)單的語(yǔ)句而不需要多余的結(jié)果映射，更多復(fù)雜的語(yǔ)句，除了只要一些絕對(duì)必須的語(yǔ)句描述關(guān)系以外，再也不需要其它的。
resultMap屬性：type為java實(shí)體類(lèi)；id為此resultMap的標(biāo)識(shí)。
resultMap可以設(shè)置的映射：
（1）. constructor – 用來(lái)將結(jié)果反射給一個(gè)實(shí)例化好的類(lèi)的構(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ù)雜類(lèi)型的結(jié)合；多個(gè)結(jié)果合成的類(lèi)型
a) nested result mappings – 幾resultMap 自身嵌套關(guān)聯(lián)，也可以引用到一個(gè)其它上
（5）. collection –復(fù)雜類(lèi)型集合a collection of complex types
（6）. nested result mappings – resultMap 的集合，也可以引用到一個(gè)其它上
（7）. discriminator – 使用一個(gè)結(jié)果值以決定使用哪個(gè)resultMap
a) case – 基本一些值的結(jié)果映射的case 情形
i. nested result mappings –一個(gè)case 情形本身就是一個(gè)結(jié)果映射，因此也可以包括一些相同的元素，也可以引用一個(gè)外部resultMap。
1.1.1 id、result
id、result是最簡(jiǎn)單的映射，id為主鍵映射；result其他基本數(shù)據(jù)庫(kù)表字段到實(shí)體類(lèi)屬性的映射。
最簡(jiǎn)單的例子：
<resultMap type="liming.student.manager.data.model.StudentEntity" id="studentResultMap"> <id property="studentId" column="STUDENT_ID" javaType="String" jdbcType="VARCHAR"/> <result property="studentName" column="STUDENT_NAME" javaType="String" jdbcType="VARCHAR"/> <result property="studentSex" column="STUDENT_SEX" javaType="int" jdbcType="INTEGER"/> <result property="studentBirthday" column="STUDENT_BIRTHDAY" javaType="Date" jdbcType="DATE"/> <result property="studentPhoto" column="STUDENT_PHOTO" javaType="byte[]" jdbcType="BLOB" typeHandler="org.apache.ibatis.type.BlobTypeHandler" /> </resultMap>
id、result語(yǔ)句屬性配置細(xì)節(jié)：
|
屬性 |
描述 |
|
|
property |
需要映射到JavaBean 的屬性名稱(chēng)。 |
|
|
column |
數(shù)據(jù)表的列名或者標(biāo)簽別名。 |
|
|
javaType |
一個(gè)完整的類(lèi)名，或者是一個(gè)類(lèi)型別名。如果你匹配的是一個(gè)JavaBean，那MyBatis 通常會(huì)自行檢測(cè)到。然后，如果你是要映射到一個(gè)HashMap，那你需要指定javaType 要達(dá)到的目的。 |
|
|
jdbcType |
數(shù)據(jù)表支持的類(lèi)型列表。這個(gè)屬性只在insert,update 或delete 的時(shí)候針對(duì)允許空的列有用。JDBC 需要這項(xiàng)，但MyBatis 不需要。如果你是直接針對(duì)JDBC 編碼，且有允許空的列，而你要指定這項(xiàng)。 |
|
|
typeHandler |
使用這個(gè)屬性可以覆寫(xiě)類(lèi)型處理器。這項(xiàng)值可以是一個(gè)完整的類(lèi)名，也可以是一個(gè)類(lèi)型別名。 |
支持的JDBC類(lèi)型
為了將來(lái)的引用，MyBatis 支持下列JDBC 類(lèi)型，通過(guò)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，CURSOR
1.1.2 constructor
我們使用id、result時(shí)候，需要定義java實(shí)體類(lèi)的屬性映射到數(shù)據(jù)庫(kù)表的字段上。這個(gè)時(shí)候是使用JavaBean實(shí)現(xiàn)的。當(dāng)然我們也可以使用實(shí)體類(lèi)的構(gòu)造方法來(lái)實(shí)現(xiàn)值的映射，這個(gè)時(shí)候是通過(guò)構(gòu)造方法參數(shù)的書(shū)寫(xiě)的順序來(lái)進(jìn)行賦值的。使用construcotr功能有限（例如使用collection級(jí)聯(lián)查詢(xún)）。上面使用id、result實(shí)現(xiàn)的功能就可以改為：
<resultMap type="StudentEntity" id="studentResultMap" >
<constructor>
<idArg javaType="String" column="STUDENT_ID"/>
<arg javaType="String" column="STUDENT_NAME"/>
<arg javaType="String" column="STUDENT_SEX"/>
<arg javaType="Date" column="STUDENT_BIRTHDAY"/>
</constructor>
</resultMap>
當(dāng)然，我們需要定義StudentEntity實(shí)體類(lèi)的構(gòu)造方法：
public StudentEntity(String studentID, String studentName, String studentSex, Date studentBirthday){
this.studentID = studentID;
this.studentName = studentName;
this.studentSex = studentSex;
this.studentBirthday = studentBirthday;
}
1.1.3 association聯(lián)合
聯(lián)合元素用來(lái)處理“一對(duì)一”的關(guān)系。需要指定映射的Java實(shí)體類(lèi)的屬性，屬性的javaType（通常MyBatis 自己會(huì)識(shí)別）。對(duì)應(yīng)的數(shù)據(jù)庫(kù)表的列名稱(chēng)。如果想覆寫(xiě)的話(huà)返回結(jié)果的值，需要指定typeHandler。
不同情況需要告訴MyBatis 如何加載一個(gè)聯(lián)合。MyBatis 可以用兩種方式加載：
（1）. select: 執(zhí)行一個(gè)其它映射的SQL 語(yǔ)句返回一個(gè)Java實(shí)體類(lèi)型。較靈活；
（2）. resultsMap: 使用一個(gè)嵌套的結(jié)果映射來(lái)處理通過(guò)join查詢(xún)結(jié)果集，映射成Java實(shí)體類(lèi)型。
例如，一個(gè)班級(jí)對(duì)應(yīng)一個(gè)班主任。
首先定義好班級(jí)中的班主任屬性：
private TeacherEntity teacherEntity;
1.1.3.1使用select實(shí)現(xiàn)聯(lián)合
例：班級(jí)實(shí)體類(lèi)中有班主任的屬性，通過(guò)聯(lián)合在得到一個(gè)班級(jí)實(shí)體時(shí)，同時(shí)映射出班主任實(shí)體。
這樣可以直接復(fù)用在TeacherMapper.xml文件中定義好的查詢(xún)teacher根據(jù)其ID的select語(yǔ)句。而且不需要修改寫(xiě)好的SQL語(yǔ)句，只需要直接修改resultMap即可。
ClassMapper.xml文件部分內(nèi)容：
<resultMap type="ClassEntity" id="classResultMap">
<id property="classID" column="CLASS_ID" />
<result property="className" column="CLASS_NAME" />
<result property="classYear" column="CLASS_YEAR" />
<association property="teacherEntity" column="TEACHER_ID" select="getTeacher"/>
</resultMap>
<select id="getClassByID" parameterType="String" resultMap="classResultMap">
SELECT * FROM CLASS_TBL CT
WHERE CT.CLASS_ID = #{classID};
</select>
TeacherMapper.xml文件部分內(nèi)容：
<resultMap type="TeacherEntity" id="teacherResultMap">
<id property="teacherID" column="TEACHER_ID" />
<result property="teacherName" column="TEACHER_NAME" />
<result property="teacherSex" column="TEACHER_SEX" />
<result property="teacherBirthday" column="TEACHER_BIRTHDAY"/>
<result property="workDate" column="WORK_DATE"/>
<result property="professional" column="PROFESSIONAL"/>
</resultMap>
<select id="getTeacher" parameterType="String" resultMap="teacherResultMap">
SELECT *
FROM TEACHER_TBL TT
WHERE TT.TEACHER_ID = #{teacherID}
</select>
1.1.3.2使用resultMap實(shí)現(xiàn)聯(lián)合
與上面同樣的功能，查詢(xún)班級(jí)，同時(shí)查詢(xún)器班主任。需在association中添加resultMap（在teacher的xml文件中定義好的），新寫(xiě)sql（查詢(xún)班級(jí)表left join教師表），不需要teacher的select。
修改ClassMapper.xml文件部分內(nèi)容：
<resultMap type="ClassEntity" id="classResultMap">
<id property="classID" column="CLASS_ID" />
<result property="className" column="CLASS_NAME" />
<result property="classYear" column="CLASS_YEAR" />
<association property="teacherEntity" column="TEACHER_ID" resultMap="teacherResultMap"/>
</resultMap>
<select id="getClassAndTeacher" parameterType="String" resultMap="classResultMap">
SELECT *
FROM CLASS_TBL CT LEFT JOIN TEACHER_TBL TT ON CT.TEACHER_ID = TT.TEACHER_ID
WHERE CT.CLASS_ID = #{classID};
</select>
其中的teacherResultMap請(qǐng)見(jiàn)上面TeacherMapper.xml文件部分內(nèi)容中。
1.1.4 collection聚集
聚集元素用來(lái)處理“一對(duì)多”的關(guān)系。需要指定映射的Java實(shí)體類(lèi)的屬性，屬性的javaType（一般為ArrayList）；列表中對(duì)象的類(lèi)型ofType（Java實(shí)體類(lèi)）；對(duì)應(yīng)的數(shù)據(jù)庫(kù)表的列名稱(chēng)；
不同情況需要告訴MyBatis 如何加載一個(gè)聚集。MyBatis 可以用兩種方式加載：
（1）. select: 執(zhí)行一個(gè)其它映射的SQL 語(yǔ)句返回一個(gè)Java實(shí)體類(lèi)型。較靈活；
（2）. resultsMap: 使用一個(gè)嵌套的結(jié)果映射來(lái)處理通過(guò)join查詢(xún)結(jié)果集，映射成Java實(shí)體類(lèi)型。
例如，一個(gè)班級(jí)有多個(gè)學(xué)生。
首先定義班級(jí)中的學(xué)生列表屬性：
private List<StudentEntity> studentList;
1.1.4.1使用select實(shí)現(xiàn)聚集
用法和聯(lián)合很類(lèi)似，區(qū)別在于，這是一對(duì)多，所以一般映射過(guò)來(lái)的都是列表。所以這里需要定義javaType為ArrayList，還需要定義列表中對(duì)象的類(lèi)型ofType，以及必須設(shè)置的select的語(yǔ)句名稱(chēng)（需要注意的是，這里的查詢(xún)student的select語(yǔ)句條件必須是外鍵classID）。
ClassMapper.xml文件部分內(nèi)容：
<resultMap type="ClassEntity" id="classResultMap">
<id property="classID" column="CLASS_ID" />
<result property="className" column="CLASS_NAME" />
<result property="classYear" column="CLASS_YEAR" />
<association property="teacherEntity" column="TEACHER_ID" select="getTeacher"/>
<collection property="studentList" column="CLASS_ID" javaType="ArrayList" ofType="StudentEntity" select="getStudentByClassID"/>
</resultMap>
<select id="getClassByID" parameterType="String" resultMap="classResultMap">
SELECT * FROM CLASS_TBL CT
WHERE CT.CLASS_ID = #{classID};
</select>
StudentMapper.xml文件部分內(nèi)容：
<!-- java屬性，數(shù)據(jù)庫(kù)表字段之間的映射定義 -->
<resultMap type="StudentEntity" id="studentResultMap">
<id property="studentID" column="STUDENT_ID" />
<result property="studentName" column="STUDENT_NAME" />
<result property="studentSex" column="STUDENT_SEX" />
<result property="studentBirthday" column="STUDENT_BIRTHDAY" />
</resultMap>
<!-- 查詢(xún)學(xué)生list，根據(jù)班級(jí)id -->
<select id="getStudentByClassID" parameterType="String" resultMap="studentResultMap">
<include refid="selectStudentAll" />
WHERE ST.CLASS_ID = #{classID}
</select>
1.1.4.2使用resultMap實(shí)現(xiàn)聚集
使用resultMap，就需要重寫(xiě)一個(gè)sql，left join學(xué)生表。
<resultMap type="ClassEntity" id="classResultMap">
<id property="classID" column="CLASS_ID" />
<result property="className" column="CLASS_NAME" />
<result property="classYear" column="CLASS_YEAR" />
<association property="teacherEntity" column="TEACHER_ID" resultMap="teacherResultMap"/>
<collection property="studentList" column="CLASS_ID" javaType="ArrayList" ofType="StudentEntity" resultMap="studentResultMap"/>
</resultMap>
<select id="getClassAndTeacherStudent" parameterType="String" resultMap="classResultMap">
SELECT *
FROM CLASS_TBL CT
LEFT JOIN STUDENT_TBL ST
ON CT.CLASS_ID = ST.CLASS_ID
LEFT JOIN TEACHER_TBL TT
ON CT.TEACHER_ID = TT.TEACHER_ID
WHERE CT.CLASS_ID = #{classID};
</select>
其中的teacherResultMap請(qǐng)見(jiàn)上面TeacherMapper.xml文件部分內(nèi)容中。studentResultMap請(qǐng)見(jiàn)上面StudentMapper.xml文件部分內(nèi)容中。
1.1.5discriminator鑒別器
有時(shí)一個(gè)單獨(dú)的數(shù)據(jù)庫(kù)查詢(xún)也許返回很多不同（但是希望有些關(guān)聯(lián)）數(shù)據(jù)類(lèi)型的結(jié)果集。鑒別器元素就是被設(shè)計(jì)來(lái)處理這個(gè)情況的，還有包括類(lèi)的繼承層次結(jié)構(gòu)。鑒別器非常容易理解，因?yàn)樗谋憩F(xiàn)很像Java語(yǔ)言中的switch語(yǔ)句。
定義鑒別器指定了column和javaType屬性。列是MyBatis查找比較值的地方。JavaType是需要被用來(lái)保證等價(jià)測(cè)試的合適類(lèi)型（盡管字符串在很多情形下都會(huì)有用）。
下面這個(gè)例子為，當(dāng)classId為20000001時(shí)，才映射classId屬性。
<resultMap type="liming.student.manager.data.model.StudentEntity" id="resultMap_studentEntity_discriminator">
<id property="studentId" column="STUDENT_ID" javaType="String" jdbcType="VARCHAR"/>
<result property="studentName" column="STUDENT_NAME" javaType="String" jdbcType="VARCHAR"/>
<result property="studentSex" column="STUDENT_SEX" javaType="int" jdbcType="INTEGER"/>
<result property="studentBirthday" column="STUDENT_BIRTHDAY" javaType="Date" jdbcType="DATE"/>
<result property="studentPhoto" column="STUDENT_PHOTO" javaType="byte[]" jdbcType="BLOB" typeHandler="org.apache.ibatis.type.BlobTypeHandler" />
<result property="placeId" column="PLACE_ID" javaType="String" jdbcType="VARCHAR"/>
<discriminator column="CLASS_ID" javaType="String" jdbcType="VARCHAR">
<case value="20000001" resultType="liming.student.manager.data.model.StudentEntity" >
<result property="classId" column="CLASS_ID" javaType="String" jdbcType="VARCHAR"/>
</case>
</discriminator>
</resultMap>
2.增刪改查、參數(shù)、緩存
2.1 select
一個(gè)select 元素非常簡(jiǎn)單。例如：
<!-- 查詢(xún)學(xué)生，根據(jù)id -->
<select id="getStudent" parameterType="String" resultMap="studentResultMap">
SELECT ST.STUDENT_ID,
ST.STUDENT_NAME,
ST.STUDENT_SEX,
ST.STUDENT_BIRTHDAY,
ST.CLASS_ID
FROM STUDENT_TBL ST
WHERE ST.STUDENT_ID = #{studentID}
</select>
這條語(yǔ)句就叫做‘getStudent，有一個(gè)String參數(shù)，并返回一個(gè)StudentEntity類(lèi)型的對(duì)象。
注意參數(shù)的標(biāo)識(shí)是：#{studentID}。
select 語(yǔ)句屬性配置細(xì)節(jié)：
| 屬性 | 描述 | 取值 | 默認(rèn) |
| id | 在這個(gè)模式下唯一的標(biāo)識(shí)符，可被其它語(yǔ)句引用 | ||
| parameterType | 傳給此語(yǔ)句的參數(shù)的完整類(lèi)名或別名 | ||
| resultType | 語(yǔ)句返回值類(lèi)型的整類(lèi)名或別名。注意，如果是集合，那么這里填寫(xiě)的是集合的項(xiàng)的整類(lèi)名或別名，而不是集合本身的類(lèi)名。（resultType 與resultMap 不能并用） | ||
| resultMap | 引用的外部resultMap 名。結(jié)果集映射是MyBatis 中最強(qiáng)大的特性。許多復(fù)雜的映射都可以輕松解決。（resultType 與resultMap 不能并用） | ||
| flushCache | 如果設(shè)為true，則會(huì)在每次語(yǔ)句調(diào)用的時(shí)候就會(huì)清空緩存。select 語(yǔ)句默認(rèn)設(shè)為false | true|false | false |
| useCache | 如果設(shè)為true，則語(yǔ)句的結(jié)果集將被緩存。select 語(yǔ)句默認(rèn)設(shè)為false true|false false timeout 設(shè)置驅(qū)動(dòng)器在拋出異常前等待回應(yīng)的最長(zhǎng)時(shí)間，默認(rèn)為不設(shè)值，由驅(qū)動(dòng)器自己決定 |
true|false | false |
| timeout | 設(shè)置驅(qū)動(dòng)器在拋出異常前等待回應(yīng)的最長(zhǎng)時(shí)間，默認(rèn)為不設(shè)值，由驅(qū)動(dòng)器自己決定 | 正整數(shù) | 未設(shè)置 |
| fetchSize | 設(shè)置一個(gè)值后，驅(qū)動(dòng)器會(huì)在結(jié)果集數(shù)目達(dá)到此數(shù)值后，激發(fā)返回，默認(rèn)為不設(shè)值，由驅(qū)動(dòng)器自己決定 | 正整數(shù) | 驅(qū)動(dòng)器決定 |
| statementType | statement，preparedstatement，callablestatement。 預(yù)準(zhǔn)備語(yǔ)句、可調(diào)用語(yǔ)句 |
STATEMENT PREPARED CALLABLE |
PREPARED |
| resultSetType | forward_only，scroll_sensitive，scroll_insensitive 只轉(zhuǎn)發(fā)，滾動(dòng)敏感，不區(qū)分大小寫(xiě)的滾動(dòng) |
FORWARD_ONLY SCROLL_SENSITIVE SCROLL_INSENSITIVE |
驅(qū)動(dòng)器決定 |
2.2 insert
一個(gè)簡(jiǎn)單的insert語(yǔ)句：
<!-- 插入學(xué)生 -->
<insert id="insertStudent" parameterType="StudentEntity">
INSERT INTO STUDENT_TBL (STUDENT_ID,
STUDENT_NAME,
STUDENT_SEX,
STUDENT_BIRTHDAY,
CLASS_ID)
VALUES (#{studentID},
#{studentName},
#{studentSex},
#{studentBirthday},
#{classEntity.classID})
</insert>
insert可以使用數(shù)據(jù)庫(kù)支持的自動(dòng)生成主鍵策略，設(shè)置useGeneratedKeys=”true”，然后把keyProperty 設(shè)成對(duì)應(yīng)的列，就搞定了。比如說(shuō)上面的StudentEntity 使用auto-generated 為id 列生成主鍵.還可以使用selectKey元素。下面例子，使用mysql數(shù)據(jù)庫(kù)nextval('student')為自定義函數(shù)，用來(lái)生成一個(gè)key。
<!-- 插入學(xué)生 自動(dòng)主鍵-->
<insert id="insertStudentAutoKey" parameterType="StudentEntity">
<selectKey keyProperty="studentID" resultType="String" order="BEFORE">
select nextval('student')
</selectKey>
INSERT INTO STUDENT_TBL (STUDENT_ID,
STUDENT_NAME,
STUDENT_SEX,
STUDENT_BIRTHDAY,
CLASS_ID)
VALUES (#{studentID},
#{studentName},
#{studentSex},
#{studentBirthday},
#{classEntity.classID})
</insert>
insert語(yǔ)句屬性配置細(xì)節(jié)：
| 屬性 | 描述 | 取值 | 默認(rèn) |
| id | 在這個(gè)模式下唯一的標(biāo)識(shí)符，可被其它語(yǔ)句引用 | ||
| parameterType | 傳給此語(yǔ)句的參數(shù)的完整類(lèi)名或別名 | ||
| flushCache | 如果設(shè)為true，則會(huì)在每次語(yǔ)句調(diào)用的時(shí)候就會(huì)清空緩存。select 語(yǔ)句默認(rèn)設(shè)為false | true|false | false |
| useCache | 如果設(shè)為true，則語(yǔ)句的結(jié)果集將被緩存。select 語(yǔ)句默認(rèn)設(shè)為false true|false false timeout 設(shè)置驅(qū)動(dòng)器在拋出異常前等待回應(yīng)的最長(zhǎng)時(shí)間，默認(rèn)為不設(shè)值，由驅(qū)動(dòng)器自己決定 |
true|false | false |
| timeout | 設(shè)置驅(qū)動(dòng)器在拋出異常前等待回應(yīng)的最長(zhǎng)時(shí)間，默認(rèn)為不設(shè)值，由驅(qū)動(dòng)器自己決定 | 正整數(shù) | 未設(shè)置 |
| fetchSize | 設(shè)置一個(gè)值后，驅(qū)動(dòng)器會(huì)在結(jié)果集數(shù)目達(dá)到此數(shù)值后，激發(fā)返回，默認(rèn)為不設(shè)值，由驅(qū)動(dòng)器自己決定 | 正整數(shù) | 驅(qū)動(dòng)器決定 |
| statementType | statement，preparedstatement，callablestatement。 預(yù)準(zhǔn)備語(yǔ)句、可調(diào)用語(yǔ)句 |
STATEMENT PREPARED CALLABLE |
PREPARED |
| useGeneratedKeys |
告訴MyBatis 使用JDBC 的getGeneratedKeys 方法來(lái)獲取數(shù)據(jù)庫(kù)自己生成的主鍵（MySQL、SQLSERVER 等 關(guān)系型數(shù)據(jù)庫(kù)會(huì)有自動(dòng)生成的字段）。默認(rèn)：false |
true|false | false |
| keyProperty |
標(biāo)識(shí)一個(gè)將要被MyBatis 設(shè)置進(jìn)getGeneratedKeys 的key 所返回的值，或者為insert 語(yǔ)句使用一個(gè)selectKey 子元素。 |
selectKey語(yǔ)句屬性配置細(xì)節(jié)：
| 屬性 | 描述 | 取值 |
| keyProperty | selectKey 語(yǔ)句生成結(jié)果需要設(shè)置的屬性。 | |
| resultType | 生成結(jié)果類(lèi)型，MyBatis 允許使用基本的數(shù)據(jù)類(lèi)型，包括String 、int類(lèi)型。 | |
| order | 可以設(shè)成BEFORE 或者AFTER，如果設(shè)為BEFORE，那它會(huì)先選擇主鍵，然后設(shè)置keyProperty，再執(zhí)行insert語(yǔ)句；如果設(shè)為AFTER，它就先運(yùn)行insert 語(yǔ)句再運(yùn)行selectKey 語(yǔ)句，通常是insert 語(yǔ)句中內(nèi)部調(diào)用數(shù)據(jù)庫(kù)（像Oracle）內(nèi)嵌的序列機(jī)制。 | BEFORE AFTER |
| statementType | 像上面的那樣， MyBatis 支持STATEMENT，PREPARED和CALLABLE 的語(yǔ)句形式， 對(duì)應(yīng)Statement ，PreparedStatement 和CallableStatement 響應(yīng) | STATEMENT PREPARED CALLABLE |
2.3 update、delete
一個(gè)簡(jiǎn)單的update：
<!-- 更新學(xué)生信息 -->
<update id="updateStudent" parameterType="StudentEntity">
UPDATE STUDENT_TBL
SET STUDENT_TBL.STUDENT_NAME = #{studentName},
STUDENT_TBL.STUDENT_SEX = #{studentSex},
STUDENT_TBL.STUDENT_BIRTHDAY = #{studentBirthday},
STUDENT_TBL.CLASS_ID = #{classEntity.classID}
WHERE STUDENT_TBL.STUDENT_ID = #{studentID};
</update>
一個(gè)簡(jiǎn)單的delete：
<!-- 刪除學(xué)生 -->
<delete id="deleteStudent" parameterType="StudentEntity">
DELETE FROM STUDENT_TBL WHERE STUDENT_ID = #{studentID}
</delete>
update、delete語(yǔ)句屬性配置細(xì)節(jié)：
| 屬性 | 描述 | 取值 | 默認(rèn) |
| id | 在這個(gè)模式下唯一的標(biāo)識(shí)符，可被其它語(yǔ)句引用 | ||
| parameterType | 傳給此語(yǔ)句的參數(shù)的完整類(lèi)名或別名 | ||
| flushCache | 如果設(shè)為true，則會(huì)在每次語(yǔ)句調(diào)用的時(shí)候就會(huì)清空緩存。select 語(yǔ)句默認(rèn)設(shè)為false | true|false | false |
| useCache | 如果設(shè)為true，則語(yǔ)句的結(jié)果集將被緩存。select 語(yǔ)句默認(rèn)設(shè)為false true|false false timeout 設(shè)置驅(qū)動(dòng)器在拋出異常前等待回應(yīng)的最長(zhǎng)時(shí)間，默認(rèn)為不設(shè)值，由驅(qū)動(dòng)器自己決定 |
true|false | false |
| timeout | 設(shè)置驅(qū)動(dòng)器在拋出異常前等待回應(yīng)的最長(zhǎng)時(shí)間，默認(rèn)為不設(shè)值，由驅(qū)動(dòng)器自己決定 | 正整數(shù) | 未設(shè)置 |
| fetchSize | 設(shè)置一個(gè)值后，驅(qū)動(dòng)器會(huì)在結(jié)果集數(shù)目達(dá)到此數(shù)值后，激發(fā)返回，默認(rèn)為不設(shè)值，由驅(qū)動(dòng)器自己決定 | 正整數(shù) | 驅(qū)動(dòng)器決定 |
| statementType | statement，preparedstatement，callablestatement。 預(yù)準(zhǔn)備語(yǔ)句、可調(diào)用語(yǔ)句 |
STATEMENT PREPARED CALLABLE |
PREPARED |
2.4 sql
Sql元素用來(lái)定義一個(gè)可以復(fù)用的SQL 語(yǔ)句段，供其它語(yǔ)句調(diào)用。比如：
<!-- 復(fù)用sql語(yǔ)句 查詢(xún)student表所有字段 -->
<sql id="selectStudentAll">
SELECT ST.STUDENT_ID,
ST.STUDENT_NAME,
ST.STUDENT_SEX,
ST.STUDENT_BIRTHDAY,
ST.CLASS_ID
FROM STUDENT_TBL ST
</sql>
這樣，在select的語(yǔ)句中就可以直接引用使用了，將上面select語(yǔ)句改成：
<!-- 查詢(xún)學(xué)生，根據(jù)id -->
<select id="getStudent" parameterType="String" resultMap="studentResultMap">
<include refid="selectStudentAll"/>
WHERE ST.STUDENT_ID = #{studentID}
</select>
2.5 parameters
上面很多地方已經(jīng)用到了參數(shù)，比如查詢(xún)、修改、刪除的條件，插入，修改的數(shù)據(jù)等，MyBatis可以使用的基本數(shù)據(jù)類(lèi)型和Java的復(fù)雜數(shù)據(jù)類(lèi)型。
基本數(shù)據(jù)類(lèi)型，String，int，date等。
但是使用基本數(shù)據(jù)類(lèi)型，只能提供一個(gè)參數(shù)，所以需要使用Java實(shí)體類(lèi)，或Map類(lèi)型做參數(shù)類(lèi)型。通過(guò)#{}可以直接得到其屬性。
2.5.1 基本類(lèi)型參數(shù)
根據(jù)入學(xué)時(shí)間，檢索學(xué)生列表：
<!-- 查詢(xún)學(xué)生list，根據(jù)入學(xué)時(shí)間 -->
<select id="getStudentListByDate" parameterType="Date" resultMap="studentResultMap">
SELECT *
FROM STUDENT_TBL ST LEFT JOIN CLASS_TBL CT ON ST.CLASS_ID = CT.CLASS_ID
WHERE CT.CLASS_YEAR = #{classYear};
</select>
List<StudentEntity> studentList = studentMapper.getStudentListByClassYear(StringUtil.parse("2007-9-1"));
for (StudentEntity entityTemp : studentList) {
System.out.println(entityTemp.toString());
}
2.5.2 Java實(shí)體類(lèi)型參數(shù)
根據(jù)姓名和性別，檢索學(xué)生列表。使用實(shí)體類(lèi)做參數(shù)：
<!-- 查詢(xún)學(xué)生list，like姓名、=性別，參數(shù)entity類(lèi)型 -->
<select id="getStudentListWhereEntity" parameterType="StudentEntity" resultMap="studentResultMap">
SELECT * from STUDENT_TBL ST
WHERE ST.STUDENT_NAME LIKE CONCAT(CONCAT('%', #{studentName}),'%')
AND ST.STUDENT_SEX = #{studentSex}
</select>
StudentEntity entity = new StudentEntity();
entity.setStudentName("李");
entity.setStudentSex("男");
List<StudentEntity> studentList = studentMapper.getStudentListWhereEntity(entity);
for (StudentEntity entityTemp : studentList) {
System.out.println(entityTemp.toString());
}
2.5.3Map參數(shù)
根據(jù)姓名和性別，檢索學(xué)生列表。使用Map做參數(shù)：
<!-- 查詢(xún)學(xué)生list，=性別，參數(shù)map類(lèi)型 -->
<select id="getStudentListWhereMap" parameterType="Map" resultMap="studentResultMap">
SELECT * from STUDENT_TBL ST
WHERE ST.STUDENT_SEX = #{sex}
AND ST.STUDENT_SEX = #{sex}
</select>
Map<String, String> map = new HashMap<String, String>();
map.put("sex", "女");
map.put("name", "李");
List<StudentEntity> studentList = studentMapper.getStudentListWhereMap(map);
for (StudentEntity entityTemp : studentList) {
System.out.println(entityTemp.toString());
}
2.5.4多參數(shù)的實(shí)現(xiàn)
如果想傳入多個(gè)參數(shù)，則需要在接口的參數(shù)上添加@Param注解。給出一個(gè)實(shí)例：
接口寫(xiě)法：
public List<StudentEntity> getStudentListWhereParam(@Param(value = "name") String name, @Param(value = "sex") String sex, @Param(value = "birthday") Date birthdar, @Param(value = "classEntity") ClassEntity classEntity);
SQL寫(xiě)法：
<!-- 查詢(xún)學(xué)生list，like姓名、=性別、=生日、=班級(jí)，多參數(shù)方式 -->
<select id="getStudentListWhereParam" resultMap="studentResultMap">
SELECT * from STUDENT_TBL ST
<where>
<if test="name!=null and name!='' ">
ST.STUDENT_NAME LIKE CONCAT(CONCAT('%', #{name}),'%')
</if>
<if test="sex!= null and sex!= '' ">
AND ST.STUDENT_SEX = #{sex}
</if>
<if test="birthday!=null">
AND ST.STUDENT_BIRTHDAY = #{birthday}
</if>
<if test="classEntity!=null and classEntity.classID !=null and classEntity.classID!='' ">
AND ST.CLASS_ID = #{classEntity.classID}
</if>
</where>
</select>
進(jìn)行查詢(xún)：
List<StudentEntity> studentList = studentMapper.getStudentListWhereParam("", "",StringUtil.parse("1985-05-28"), classMapper.getClassByID("20000002"));
for (StudentEntity entityTemp : studentList) {
System.out.println(entityTemp.toString());
}
2.5.5字符串代入法
默認(rèn)的情況下，使用#{}語(yǔ)法會(huì)促使MyBatis 生成PreparedStatement 屬性并且使用PreparedStatement 的參數(shù)（=？）來(lái)安全的設(shè)置值。盡量這些是快捷安全，也是經(jīng)常使用的。但有時(shí)候你可能想直接未更改的字符串代入到SQL 語(yǔ)句中。比如說(shuō)，對(duì)于ORDER BY，你可能會(huì)這樣使用：ORDER BY ${columnName}但MyBatis 不會(huì)修改和規(guī)避掉這個(gè)字符串。
注意：這樣地接收和應(yīng)用一個(gè)用戶(hù)輸入到未更改的語(yǔ)句中，是非常不安全的。這會(huì)讓用戶(hù)能植入破壞代碼，所以，要么要求字段不要允許客戶(hù)輸入，要么你直接來(lái)檢測(cè)他的合法性 。
2.6 cache緩存
MyBatis 包含一個(gè)強(qiáng)在的、可配置、可定制的緩存機(jī)制。MyBatis 3 的緩存實(shí)現(xiàn)有了許多改進(jìn)，既強(qiáng)勁也更容易配置。默認(rèn)的情況，緩存是沒(méi)有開(kāi)啟，除了會(huì)話(huà)緩存以外，它可以提高性能，且能解決全局依賴(lài)。開(kāi)啟二級(jí)緩存，你只需要在SQL 映射文件中加入簡(jiǎn)單的一行：<cache/>
這句簡(jiǎn)單的語(yǔ)句的作用如下：
（1）. 所有在映射文件里的select 語(yǔ)句都將被緩存。
（2）. 所有在映射文件里insert,update 和delete 語(yǔ)句會(huì)清空緩存。
（3）. 緩存使用“最近很少使用”算法來(lái)回收
（4）. 緩存不會(huì)被設(shè)定的時(shí)間所清空。
（5）. 每個(gè)緩存可以存儲(chǔ)1024 個(gè)列表或?qū)ο蟮囊茫ú还懿樵?xún)出來(lái)的結(jié)果是什么）。
（6）. 緩存將作為“讀/寫(xiě)”緩存，意味著獲取的對(duì)象不是共享的且對(duì)調(diào)用者是安全的。不會(huì)有其它的調(diào)用
（7）. 者或線(xiàn)程潛在修改。
例如，創(chuàng)建一個(gè)FIFO 緩存讓60 秒就清空一次，存儲(chǔ)512 個(gè)對(duì)象結(jié)果或列表引用，并且返回的結(jié)果是只讀。因?yàn)樵诓挥玫木€(xiàn)程里的兩個(gè)調(diào)用者修改它們可能會(huì)導(dǎo)致引用沖突。
<cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"> </cache>
還可以在不同的命名空間里共享同一個(gè)緩存配置或者實(shí)例。在這種情況下，你就可以使用cache-ref 來(lái)引用另外一個(gè)緩存。
<cache-ref namespace="com.liming.manager.data.StudentMapper"/>
Cache 語(yǔ)句屬性配置細(xì)節(jié)：
| 屬性 | 說(shuō)明 | 取值 | 默認(rèn)值 |
| eviction | 緩存策略： LRU - 最近最少使用法：移出最近較長(zhǎng)周期內(nèi)都沒(méi)有被使用的對(duì)象。 FIFI- 先進(jìn)先出：移出隊(duì)列里較早的對(duì)象 SOFT - 軟引用：基于軟引用規(guī)則，使用垃圾回收機(jī)制來(lái)移出對(duì)象 WEAK - 弱引用：基于弱引用規(guī)則，使用垃圾回收機(jī)制來(lái)強(qiáng)制性地移出對(duì)象 |
LRU FIFI SOFT WEAK |
LRU |
| flushInterval | 代表一個(gè)合理的毫秒總計(jì)時(shí)間。默認(rèn)是不設(shè)置，因此使用無(wú)間隔清空即只能調(diào)用語(yǔ)句來(lái)清空。 | 正整數(shù) |
不設(shè)置 |
| size | 緩存的對(duì)象的大小 | 正整數(shù) | 1024 |
| readOnly |
只讀緩存將對(duì)所有調(diào)用者返回同一個(gè)實(shí)例。因此都不能被修改，這可以極大的提高性能。可寫(xiě)的緩存將通過(guò)序列 化來(lái)返回一個(gè)緩存對(duì)象的拷貝。這會(huì)比較慢，但是比較安全。所以默認(rèn)值是false。 |
true|false | false |
相關(guān)文章
這篇文章主要介紹了Java編碼輔助工具M(jìn)apstruct用法詳解，手動(dòng)編碼setter/getter各個(gè)對(duì)應(yīng)屬性，會(huì)顯得臃腫繁瑣。通過(guò)Mapstruct框架可簡(jiǎn)單方便地完成這一工作。,需要的朋友可以參考下2019-06-06
這篇文章主要介紹了Mybatis批量插入返回插入成功后的主鍵id操作，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2021-03-03
在mapper.xml中，需要在字段映射時(shí)加入typeHandler，具體：<id?property="abnormalEigenList"?column="AbnormalEigen"?typeHandler="com.xxx.config.JsonHandler">，下面通過(guò)本文給大家介紹Mybatis中，映射mysql中的JSON字段,需要的朋友可以參考下2023-10-10
這篇文章主要介紹了淺談Java8的特性之Optional類(lèi),Optional類(lèi)是 Java 8 引入的一個(gè)很有趣的特性,Optional 類(lèi)是一個(gè)可以為null的容器對(duì)象,它主要解決的問(wèn)題是臭名昭著的空指針異常,需要的朋友可以參考下2023-08-08
SpringCloud融入Python的實(shí)現(xiàn)
這篇文章主要介紹了SpringCloud融入Python的實(shí)現(xiàn)，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-12-12
這篇文章主要為大家詳細(xì)介紹了JavaCV實(shí)現(xiàn)獲取視頻每幀并保存，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2019-07-07
java多線(xiàn)程編程學(xué)習(xí)(線(xiàn)程間通信)
下面小編就為大家?guī)?lái)一篇java多線(xiàn)程編程學(xué)習(xí)(線(xiàn)程間通信)。小編覺(jué)得挺不錯(cuò)的，現(xiàn)在就分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2017-09-09
在我們?nèi)粘I(yè)務(wù)代碼中,經(jīng)常要用到星期幾,下面這篇文章主要給大家介紹了關(guān)于Java根據(jù)日期計(jì)算星期幾的四種方法,文中通過(guò)代碼將每種實(shí)現(xiàn)的非常詳細(xì),需要的朋友可以參考下2023-09-09
Java的Hibernate框架中用于操作數(shù)據(jù)庫(kù)的HQL語(yǔ)句講解
這篇文章主要介紹了Java的Hibernate框架中用于操作數(shù)據(jù)庫(kù)的HQL語(yǔ)句講解,Hibernate是Java的SSH三大web開(kāi)發(fā)框架之一,需要的朋友可以參考下2016-01-01
Java設(shè)計(jì)模式之代理模式與@Async異步注解失效的解決
代理模式是Java常見(jiàn)的設(shè)計(jì)模式之一。所謂代理模式是指客戶(hù)端并不直接調(diào)用實(shí)際的對(duì)象，而是通過(guò)調(diào)用代理，來(lái)間接的調(diào)用實(shí)際的對(duì)象2022-07-07