MyBatis - 09 - 自定义映射resultMap

完整代码在后面

1 准备工作

1.1 建表

t_emp

添加测试数据：

1.2 创建实体类

在src/main/java/com/rqs/mybatis/pojo下创建Emp类：
Emp类：

package com.rqs.mybatis.pojo;public class Emp {private Integer eid;private String empName;private Integer age;private String sex;private String email;public Integer getEid() {return eid;}public void setEid(Integer eid) {this.eid = eid;}public String getEmpName() {return empName;}public void setEmpName(String empName) {this.empName = empName;}public Integer getAge() {return age;}public void setAge(Integer age) {this.age = age;}public String getSex() {return sex;}public void setSex(String sex) {this.sex = sex;}public String getEmail() {return email;}public void setEmail(String email) {this.email = email;}public Emp() {}public Emp(Integer eid, String empName, Integer age, String sex, String email) {this.eid = eid;this.empName = empName;this.age = age;this.sex = sex;this.email = email;}@Overridepublic String toString() {return "Emp{" +"eid=" + eid +", empName='" + empName + '\'' +", age=" + age +", sex='" + sex + '\'' +", email='" + email + '\'' +'}';}
}

1.3 引出一个问题

在之前实现查询功能的时候，用到的都是resultType来设置默认的映射关系，要求字段名（数据库表中的字段名）和属性名（java类中的属性名）保持一致，例如下图所示，字段名和属性名是一致的。
字段名：

属性名：

但是，在本例中，出现了字段名和属性名不一致的情况，如下图
字段名要求单词与单词之间使用下划线连接：

属性名，单词与单词之间命名遵循驼峰原则：

如下所示，在进行查询操作的时候，由于无法映射，导致empName的查询结果为空

既然字段名和属性名不一致了，那么该如何处理映射关系呢？

方案1

在EmpMapper.xml的SQL语句中为字段起别名，保持和属性名的一致
结果如下所示：

方案2

在核心配置文件mybatis-config.xml中设置全局配置，将_自动映射为驼峰

    <!--设置MyBatis的全局配置--><!--将_自动映射为驼峰 --><settings><setting name="mapUnderscoreToCamelCase" value="true"/></settings>

注意：MyBatis核心配置文件标签的设置顺序，要把settings放在properties和typeAlliases中间

    properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?

测试结果：

方案3

在核心配置文件mybatis-config.xml中，通过resultMap逐一设置自定义的映射关系

    <!--resultMap：设置自定义映射关系id：唯一标识，不能重复type：设置映射关系中的实体类类型子标签：id：专门用来设置主键的映射关系result：设置普通字段的映射关系属性：property：设置映射关系中的属性名，必须是type属性所设置的实体类类型中的属性名column：设置映射关系中的字段名，必须是sql语句查询出的字段名要注意：1.属性名和字段名一致的话也要写property和column2.要在select标签中添加resultMap="对应resultMap的id"--><resultMap id="empResultMap" type="Emp"><id property="eid" column="eid"></id><result property="empName" column="emp_name"></result><result property="age" column="age"></result><result property="sex" column="sex"></result><result property="email" column="email"></result></resultMap><!--List<Emp> getAllEmp();--><select id="getAllEmp" resultMap="empResultMap">select * from t_emp</select>

测试结果：

2.完整代码

项目结构

EmpMapper接口

package com.rqs.mybatis.mapper;import com.rqs.mybatis.pojo.Emp;
import org.apache.ibatis.annotations.Param;import java.util.List;public interface EmpMapper {/*** 查询所有的员工信息*/List<Emp> getAllEmp();}

Emp类

package com.rqs.mybatis.pojo;public class Emp {private Integer eid;private String empName;private Integer age;private String sex;private String email;public Integer getEid() {return eid;}public void setEid(Integer eid) {this.eid = eid;}public String getEmpName() {return empName;}public void setEmpName(String empName) {this.empName = empName;}public Integer getAge() {return age;}public void setAge(Integer age) {this.age = age;}public String getSex() {return sex;}public void setSex(String sex) {this.sex = sex;}public String getEmail() {return email;}public void setEmail(String email) {this.email = email;}public Emp() {}public Emp(Integer eid, String empName, Integer age, String sex, String email) {this.eid = eid;this.empName = empName;this.age = age;this.sex = sex;this.email = email;}@Overridepublic String toString() {return "Emp{" +"eid=" + eid +", empName='" + empName + '\'' +", age=" + age +", sex='" + sex + '\'' +", email='" + email + '\'' +'}';}
}

SqlSessionUtils工具类

package com.rqs.mybatis.utils;import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;import java.io.IOException;
import java.io.InputStream;public class SqlSessionUtils {public static SqlSession getSqlSession() {SqlSession sqlSession = null;try {InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);sqlSession = sqlSessionFactory.openSession(true);} catch (IOException e) {e.printStackTrace();}return sqlSession;}
}

EmpMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.rqs.mybatis.mapper.EmpMapper"><!--resultMap：设置自定义映射关系id：唯一标识，不能重复type：设置映射关系中的实体类类型子标签：id：设置主键的映射关系result：设置普通字段的映射关系属性：property：设置映射关系中的属性名，必须是type属性所设置的实体类类型中的属性名column：设置映射关系中的字段名，必须是sql语句查询出的字段名--><resultMap id="empResultMap" type="Emp"><id property="eid" column="eid"></id><result property="empName" column="emp_name"></result><result property="age" column="age"></result><result property="sex" column="sex"></result><result property="email" column="email"></result></resultMap><!--List<Emp> getAllEmp();--><select id="getAllEmp" resultMap="empResultMap">select * from t_emp</select><select id="getAllEmpOld" resultType="Emp"><!--select eid,emp_name empName,age,sex,email from t_emp-->select * from t_emp</select></mapper>

jdbc.properties

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=root
jdbc.password=root

log4j.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/"><appender name="STDOUT" class="org.apache.log4j.ConsoleAppender"><param name="Encoding" value="UTF-8" /><layout class="org.apache.log4j.PatternLayout"><param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS}
%m  (%F:%L) \n" /></layout></appender><logger name="java.sql"><level value="debug" /></logger><logger name="org.apache.ibatis"><level value="info" /></logger><root><level value="debug" /><appender-ref ref="STDOUT" /></root>
</log4j:configuration>

mybatis-config.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><!--    MyBatis核心配置文件，标签的顺序properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?--><properties resource="jdbc.properties"></properties><!--    &lt;!&ndash;设置MyBatis的全局配置&ndash;&gt;<settings><setting name="mapUnderscoreToCamelCase" value="true"/></settings>--><!--设置类型别名，大小写不敏感。如果不设置alias，则默认为类名（大小写不敏感）--><typeAliases><!--typeAlias: 设置某个类型的别名属性：type 设置需要设置别名的类型alias 设置某个类型的别名，如果不设置该属性，那么该类型拥有默认的类名，且不区分大小写--><!--<typeAlias type="com.rqs.mybatis.pojo.User" alias="User"></typeAlias>--><!--推荐以包为单位，将包下所有的类型设置默认的类型别名且不区分大小写--><package name="com.rqs.mybatis.pojo"/></typeAliases><!--设置连接数据库的环境--><!--每一个environment都是具体连接数据库的环境--><!--一个项目中只会用一个环境，default用于使用默认使用的环境：id：表示连接数据库的环境的唯一标识 不能重复--><environments default="development"><!--transactionmanager:设置事务管理方式属性：type="JDBC/MANAGED"JDBC: 在当前环境中，执行sql时，使用的时jdbc原声的事务管理方式，需要手动的提交和回滚事务MANAGED：被管理，例如Spring--><environment id="development"><transactionManager type="JDBC"/><!--        dataSource：配置数据源属性"type：设置数据源的类型type=""POOLED:表示使用数据库连接池缓存数据库连接UNPOOLED：表示不使用数据库连接池JNDI：表示使用上下文中的数据源--><dataSource type="POOLED"><!--设置连接数据库的驱动--><property name="driver" value="${jdbc.driver}"/><!--设置连接地址--><property name="url" value="${jdbc.url}"/><!--注意：如果在建sql表单的时候选了字符集（如utf8），这里的value要改成：value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf8"--><!--用户名和密码--><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></dataSource></environment></environments><!--引入映射文件--><mappers><!--推荐以包为单位引入映射文件，要求：1。 mapper接口所在的包要和映射文件所在的包一致2。 mapper接口要和映射文件的名字一致--><!--        com.rqs.mybatis.mapper创建包时要用/分隔，这样才是目录，否则这整一个就只是文件夹名字而已--><package name="com.rqs.mybatis.mapper"/></mappers></configuration>

ResultMapTest

package com.rqs.mybatis.test;import com.rqs.mybatis.mapper.EmpMapper;
import com.rqs.mybatis.pojo.Emp;
import com.rqs.mybatis.utils.SqlSessionUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;import java.util.List;public class ResultMapTest {/*** 解决字段名和属性名不一致的情况：* a>为字段起别名，保持和属性名的一致* b>设置全局配置，将_自动映射为驼峰* <setting name="mapUnderscoreToCamelCase" value="true"/>* c>通过resultMap设置自定义的映射关系* <resultMap id="empResultMap" type="Emp">*     <id property="eid" column="eid"></id>*     <result property="empName" column="emp_name"></result>*     <result property="age" column="age"></result>*     <result property="sex" column="sex"></result>*     <result property="email" column="email"></result>* </resultMap>*/@Testpublic void testGetAllEmp(){SqlSession sqlSession = SqlSessionUtils.getSqlSession();EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);List<Emp> list = mapper.getAllEmp();list.forEach(emp -> System.out.println(emp));}}