快捷導(dǎo)航

MyBatis輸入映射和輸出映射的實(shí)現(xiàn)示例

更新時(shí)間：2026年04月23日 15:17:11 作者：二哈喇子！

本文詳細(xì)介紹了MyBatis框架中resultMap的使用,包括其在Java對(duì)象與數(shù)據(jù)庫(kù)表列映射中的作用,以及如何配置resultMap處理不同情況,具有一定的參考價(jià)值,感興趣的可以了解一下

前言

MyBatis的輸入映射和輸出映射是將Java對(duì)象和數(shù)據(jù)庫(kù)表的列進(jìn)行映射，實(shí)現(xiàn)數(shù)據(jù)的自動(dòng)轉(zhuǎn)換。

輸入映射（Parameter Mapping）：是將Java對(duì)象轉(zhuǎn)換為可供SQL語(yǔ)句執(zhí)行的參數(shù)。MyBatis提供了多種方式進(jìn)行輸入映射，包括基本類(lèi)型、Map、注解、XML映射文件等。

輸出映射（Result Mapping）：是將SQL查詢(xún)結(jié)果映射為Java對(duì)象。MyBatis提供了多種方式進(jìn)行輸出映射，包括基本類(lèi)型、Map、注解、XML映射文件等。其中XML映射文件是最常用的方式，可以根據(jù)列名或列索引將查詢(xún)結(jié)果映射為Java對(duì)象的屬性。

通過(guò)輸入映射和輸出映射，可以方便地完成Java對(duì)象與數(shù)據(jù)庫(kù)表的轉(zhuǎn)換，提高了開(kāi)發(fā)效率和代碼的可維護(hù)性。

resultMap的使用

使用resultMap的場(chǎng)景如下：

數(shù)據(jù)庫(kù)表和Java類(lèi)字段名稱(chēng)不一致。如果數(shù)據(jù)庫(kù)表中的列名稱(chēng)和Java類(lèi)中的屬性名稱(chēng)不一致，可以使用resultMap來(lái)映射這兩者之間的關(guān)系，避免手動(dòng)轉(zhuǎn)換的繁瑣和容易出錯(cuò)。
處理復(fù)雜查詢(xún)結(jié)果。如果查詢(xún)結(jié)果是多表聯(lián)合查詢(xún)，或者需要按照特定的順序和格式顯示結(jié)果，可以使用resultMap來(lái)定制化查詢(xún)結(jié)果的映射。
查詢(xún)結(jié)果中包含關(guān)聯(lián)對(duì)象。如果查詢(xún)結(jié)果中包含了與主對(duì)象關(guān)聯(lián)的其他對(duì)象，可以使用resultMap來(lái)映射出這些關(guān)聯(lián)對(duì)象，方便進(jìn)行對(duì)象的嵌套查詢(xún)和處理。
可以提高程序性能。使用resultMap可以緩存映射規(guī)則，避免每次查詢(xún)都需要重新定義映射規(guī)則的操作，從而提高程序的性能。

總之，如果需要處理一些復(fù)雜的查詢(xún)結(jié)果或者需要將數(shù)據(jù)庫(kù)查詢(xún)結(jié)果映射到Java對(duì)象中，就可以使用resultMap。

MyBatis框架的工作執(zhí)行流程如下

（1）讀取MyBatis配置文件mybatis-config.xml

（2）加載映射文件Mapper.xml

（3）構(gòu)建會(huì)話工廠

（4）創(chuàng)建SqlSession對(duì)象

（5）使用Executor接口來(lái)操作數(shù)據(jù)庫(kù)

（6）使用MappedStatement類(lèi)型的參數(shù)對(duì)映射信息進(jìn)行封裝。

（7）輸入?yún)?shù)映射

（8）輸出結(jié)果映射

mapper元素子元素及其作用

在映射文件中，<mapper>元素是映射文件的根元素，其他元素都是它的子元素。這些子元素及其作用如下所示：

<select>：用于映射查詢(xún)語(yǔ)句，可自定義參數(shù)，返回結(jié)果集等。
<insert>：用于映射插入語(yǔ)句，執(zhí)行后返回一個(gè)整數(shù)，代表插入的條數(shù)。
<update>：用于映射更新語(yǔ)句，執(zhí)行后返回一個(gè)整數(shù)，代表更新的條數(shù)。
<delete>：用于映射刪除語(yǔ)句，執(zhí)行后返回一個(gè)整數(shù)，代表刪除的條數(shù)。
<sql>：用于定義一部分SQL，然后可被其他語(yǔ)句引用此SQL。
<cache>：用于給定命名空間的緩存配置。
<cache-ref>：用于其他命名空間緩存配置的引用。
<resultMap>：用于描述如何從數(shù)據(jù)庫(kù)結(jié)果集中來(lái)加載對(duì)象。

案例

po 類(lèi)

public class Dept {
	private Integer deptno;
	private String dname;
	private String loc;
	// 自動(dòng)生成兩個(gè)構(gòu)造方法、Getter/Setter/toString
}

在同main/java包中，新建mapper包，里面新建同名的一個(gè)接口，一個(gè)映射文件

映射文件的 namespace 是接口的限定名

只有查詢(xún)語(yǔ)句有查詢(xún)

在接口文件中：

List<Dept> queryAll();

對(duì)應(yīng)的映射文件：

<mapper namespace="com.mybatis.mapper.DeptMapper">
<!-- 如果查詢(xún)中的列名和某個(gè)po類(lèi)的屬性名不一致，那么我們就需要配置結(jié)果的映射 -->
		<!-- type：po類(lèi)的名字 -->
	<resultMap type="Dept" id="dept">
		<!-- id標(biāo)記配置的是主鍵列的映射關(guān)系 -->
		<id column="no" property="deptno" />
		<!-- result配置的是非主鍵列和屬性的映射關(guān)系 -->
		<result column="name" property="dname"/>
		<result column="location" property="loc"/>
	</resultMap>
<!-- 如果查詢(xún)語(yǔ)句中的列名和某個(gè)po類(lèi)中的屬性名一致，那么需要配置resultType -->
						    	<!-- dept：上面的id值 -->
    <select id="queryAll" resultMap="dept">
    	select deptno as no,dname as name,loc as location
    	from dept 
    </select>
</mapper>

測(cè)試代碼：

@Test 
	public void queryDept() {
		DeptMapper mapper = session.getMapper(DeptMapper.class);
		List<Dept> list = mapper.queryAll();
		// foreach 生成
		for (Dept dept : list) {
			System.out.println(dept);
		}
	}