MyBatis映射文件Mapper.xml详解_mybatis映射文件的元素的属性与元素的属性大部分相同,但还包含三

作者：从前慢现在也慢 | 2024-03-05 14:11:15

赞

踩

mybatis映射文件的元素的属性与

元素的属性大部分相同,但还包含三

映射文件是 MyBatis 框架中十分重要的文件 可以说， MyBatis 框架的强大之处就体现在映射文件的编写上。在映射文件中，<mapper>元素是映射文件的根元素，其他元素都是它的子元素。

Select元素
<select>元素用来映射查询语句，它可以帮助我们从数据库中读取出数据。如下代码所示：

<select id="findCustomerById" parameterType="Integer"
            resultType="com.lzq.po.Customer">
            select * from t_customer where id = #{id}
</select>
1
2
3
4

select元素属性详情见下表：

Insert元素
元素用于映射插入语句，在执行完元素中定义的SQL语句后，会返回一个表示插入记录数的整数。如下代码所示：

<insert id="addCustomer" parameterType="com.itheima.po.Customer" flushCache="true"
      statementType="PREPARED" keyProperty="" keyColumn="" useGeneratedKeys="" timeout="20">
1
2

其中<insert>元素的属性与<select>元素的属性大部分相同，但还包含了3个特有属性，这3个属性的描述如下表所示：

执行插入操作后，很多时候我们会需要返回插入成功的数据生成的主键值，此时就可以通过上面讲的3个属性来实现。如果使用的数据库支持主键自动增长(如MySQL )，那么可以通过keyProperty属性指定PO类的某个属性接收主键返回值(通常会设置到id属性上),然后将useGeneratedKeys的属性值设置为true,其使用示例如下。

<insert id="addCustomer" parameterType="com.lzq.po.Customer"
	keyProperty="id" useGeneratedKeys="true">
insert into t_customer (username, jobs, phone) values (#(username),#(jobs},#{phone})
</insert>
1
2
3
4

Updata 和 Delete元素
<update>和<delete>元素的使用比较简单，它们的属性配置也基本相同。如下代码所示：

<update id="updateCustomer" parameterType="com.lzq.po.Customer">
       update t_customer 
       set username=#{username},jobs=#{jobs},phone=#{phone}
       where id=#{id}
</update>

<delete id="deleteCustomer" parameterType="Integer">
        delete from t_customer where id=#{id}
</delete>
1
2
3
4
5
6
7
8
9

在配置update和delete元素的配置基本和insert元素差不了多少，在使用这俩个元素时，也会返回一个表示有多少航受到影响的参数，

Sql元素
在一个映射文件中，通常需要定义多条SQL语句，这些SQL语句的组成可能有一部分是相同的（如多条select语句中都查询相同的id、username、jobs字段），如果每一个SQL语句都重写一遍相同的部分，势必会增加代码量，导致映射文件过于臃肿。那么有没有什么办法将这些SQL语句中相同的组成部分抽取出来，然后在需要的地方引用呢？这个时候就需要使用到sql元素了。
<sql>元素的作用就是定义可重用的SQL代码片段，然后在其他语句中引用这一代码片段。

比如：定义一个包含id、username、jobs和phone字段的代码片段如下：给sql加上一个ID

<sql id="customerColumns">id,username,jobs,phone</sql>
1

上述代码片段可以包含在其他语句中直接使用，使用方法如下：在select查询语句当中使用include的refid属性进行引入sql

<select id="findCustomerById" parameterType="Integer"resultType="com.lzq.po.Customer">
    select <include refid="customerColumns"/> 
    from t_customer 
    where id = #{id}
</select>
1
2
3
4
5

当然除了这种简单的sql进行引入还有比较复杂的引入：如下图所示：（相同效果）

代码如下所示：分别是对查询语句进行了分割成一个很小的小块，方便后续的查询可以直接调用sql元素。

	<sql id="tablename">${prefix} customer</sql>
	<sql id="someinclude">from<include refid="${include_target}" /></sql>
	<sql id="customerColumns">id,username,jobs,phone</sql>
	<select id="findCustomerById" parameterType="Integer" 
			resultType="com.lzq.po.Customer">
		select
		<include refid="customerColumns" />
		<include refid="someinclude">
			<property name="prefix" value="t_" />
			<property name="include_target" value="tablename" />
		</include>
		where id = #{id}
	</select>
1
2
3
4
5
6
7
8
9
10
11
12
13

resultMap 元素
<resultMap>元素表示结果映射集，是MyBatis中最重要也是最强大的元素。它的主要作用是定义映射规则、级联的更新以及定义类型转化器等。
<resultMap>元素中包含了一些子元素，它的元素结构如下代码段所示：

<resultMap type="" id="">
       <constructor>    	<!-- 类在实例化时,用来注入结果到构造方法中-->
             <idArg/>     	<!-- ID参数;标记结果作为ID-->
             <arg/>         <!-- 注入到构造方法的一个普通结果-->
       </constructor>  
       <id/>                <!-- 用于表示哪个列是主键-->
       <result/>           	<!-- 注入到字段或JavaBean属性的普通结果-->
       <association property="" />        	<!-- 用于一对一关联 -->
       <collection property="" />          	<!-- 用于一对多关联 -->
       <discriminator javaType="">      	<!-- 使用结果值来决定使用哪个结果映射-->
            <case value="" />               <!-- 基于某些值的结果映射 -->
       </discriminator>	
</resultMap>
1
2
3
4
5
6
7
8
9
10
11
12
13

<resultMap>元素的type属性表示需要映射的POJO,id属性是这个resultMap的唯一标识。它的子元素<constructor>用于配置构造方法(当一个POJO中未定义无参的构造方法时，就可以使用<constructor>元素进行配置)。子元素<id>用于表示哪个列是主键，而<result> 用于表示POJO和数据表中普通列的映射关系。<association> 和<collection>用于处理多表时的关联关系，而<discriminator>元素主要用于处理一个单独的数据库查询返回很多不同数据类型结果集的情况。

在默认情况下，MyBatis程序在运行时会自动地将查询到的数据与需要返回的对象的属性进行匹配赋值(需要表中的列名与对象的属性名称完全一致 )。然而实际开发时，数据表中的列和需要返回的对象的属性可能不会完全一致， 这种情况下MyBatis是不会自动赋值的。此时，就可以使用<resultMap>元素进行处理。

resultMap元素的使用
首先创建一个表t_user：并且插入几条数据用于测试：代码如下

CREATE TABLE t_user( 
t_id INT PRIMARY KEY AUTO_INCREMENT, 
t_name VARCHAR(50),
t_age INT
)
INSERT INTO t_user(t_name,t_age) VALUES('tom' , 25);
INSERT INTO t_user(t_name , t_age) VALUES('Lili' , 20); 
INSERT INTO t_user(t_name , t_age) VALUES('Jim' , 20);
1
2
3
4
5
6
7
8

随后在 com.lzq.po 包中，创建持久化类 User ，并在类中定义 id name age 属性，以及其 getter/setter 方法和 toString()方法，代码如下所示：（省略getset方法）

package com.lzq.po;
public class User {
	private Integer id;
	private String name;
	private Integer age;
	@Override
	public String toString() {
		return "User[id=" + id + ", name=" + name + ", age=" + age + ")]";
	}
}
1
2
3
4
5
6
7
8
9
10

创建映射文件UserMapper.xml文件代码如下所示：
<resultMap>的子元素<id>和<result>的property属性表示User类的属名，column属性表示数据表t _user 的列名。<select> 元素的resultMap属性表示引用上面定的resultMap。

<?xml version="1.0" encoding="UTF-8"?>
       <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
          "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.lzq.mapper.UserMapper">
	<resultMap type="com.lzq.po.User" id="resultMap">
		<id property="id" column="t_id" />
		<result property="name" column="t_name" />
		<result property="age" column="t_age" />
	</resultMap>
	<select id="findAllUser" resultMap="resultMap">
		select * from t_user
	</select>
</mapper>
1
2
3
4
5
6
7
8
9
10
11
12
13

再在mybatis-config.xml文件当中引入配置文件：如下代码所示：

<mappers>
	<mapper resource="com/lzq/mapper/UserMapper.xml" />
</mappers>
1
2
3

在使用公共类MybatisUtils，该类将加载mybatis的配置文件和创建sqlSession的工厂的代码进行抽离出来：代码如下所示：

package com.lzq.utils;
import java.io.Reader;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class MybatisUtils {
	private static SqlSessionFactory sqlSessionFactory = null;
	// 初始化SqlSessionFactory对象
	static {
		try {
			// 使用MyBatis提供的Resources类加载mybatis的配置文件
			Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
			// 构建sqlSession的工厂
			sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
	// 获取SqlSession对象的静态方法
	public static SqlSession getSession() {
		return sqlSessionFactory.openSession();
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

最后使用一个测试类进行测试：测试方法如下所示：

public void findAllUserTest() {
		// 获取SqlSession
		SqlSession sqlSession = MybatisUtils.getSession();
		// SqlSession执行映射文件中定义的SQL，并返回映射结果
		List<User> list = sqlSession.selectList
					("com.lzq.mapper.UserMapper.findAllUser");
		for (User user : list) {
			System.out.println(user);
		}
		sqlSession.close();
	}
1
2
3
4
5
6
7
8
9
10
11

在最后看下效果图，可以看到执行select * from t_user表会返回表当中所有的数据：