二、mybatis之数据输出
上一篇我们做了一个入门案例，是我们做mybatis的基本步骤，不熟悉的可以回顾一下https://www.cnblogs.com/jasmine-e/p/15330355.html，在这篇文章中只是简单介绍了一下用于select标签时使用resultType属性来指定输出的类型，这只是单行数据的输出方式，今天整理了数据输出的几种方式。
一、数据的输出
数据输出是针对查询数据的方法返回查询结果，也就是让mapper接口的对象返回select的结果集。那么既然是返回结果集，那我们必须得先了解一下结果集的类型有哪几种。
1. select结果集的类型
- 单个数据：以简单类型接收，比如查询总数居的条数。
- 一条数据：以pojo或Map类型接受，比如根据id查询员工信息。
- 多条数据：以List
或者List
2. 实例分析
按照入门案例的方法，我们来做个实例分析
（1） 物理建模
创建数据库mybatis-example，表t_emp，添加一行数据。(为了方便，还是入门案例的数据）
CREATE DATABASE `mybatis-example`;
USE `mybatis-example`;
CREATE TABLE `t_emp`(
emp_id INT AUTO_INCREMENT,
emp_name CHAR(100),
emp_salary DOUBLE(10,5),
PRIMARY KEY(emp_id)
);
INSERT INTO `t_emp`(emp_name,emp_salary) VALUES("tom",200.33);
(2)逻辑建模
package pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Employee {
private Integer empId;
private String empName;
private Double empSalary;
}
(3)引入依赖
在pom.xml里加入以下依赖（其中还有打包方式）
<packaging>jar</packaging>
<dependencies>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.8</version>
<scope>provided</scope>
</dependency>
<!-- Mybatis核心 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- junit测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.3</version>
<scope>runtime</scope>
</dependency>
<!-- log4j日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
</dependencies>
(4)创建持久层接口
package mappers;
import pojo.Employee;
import java.util.List;
import java.util.Map;
public interface EmployeeMapper {
/*查询单个数据,返回简单类型*/
Long selectCount();
/*查询单行数据，返回实体类对象*/
Employee selectEmployeeByEmpId(Integer empId);
/*查询单行数据，返回map集合*/
Map selectEmployeeMapByEmpId(Integer empId);
/*查询多行数据，返回list<pojo>*/
List<Employee> selectEmployeeList();
/*查询多行数据，返回list<Map>*/
List<Map> selectMapList();
/*添加数据*/
void insertEmployee(Employee e);
}
（5）引入日志框架和依赖
先引入依赖，这一步在引入依赖那里一起引入了，再在类路径下，也就是resources下创建log4j.xml，因为我已经有了，所以直接复制过来。
以上步骤都是和入门案例差不多的，对于接口我们只需要写我们要测试的方法就行，下面的才是重点。
（6）全局配置文件
重点关注驼峰配置，类型别名配置，映射路径配置
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!--驼峰映射-->
<settings>
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
<!--类型别名配置-->
<typeAliases>
<!-- <typeAlias type="pojo.Employee" alias="employee"></typeAlias>-->
<!--
采用包扫描的方式，一次性对某个包中的所有类配置别名，每个类的别名就是它的类名，不区分大小写
-->
<package name="pojo"/>
</typeAliases>
<environments default="dev">
<environment id="dev">
<transactionManager type="JDBC"></transactionManager>
<dataSource type="POOLED">
<property name="username" value="root"></property>
<property name="password" value="888888"></property>
<property name="driver" value="com.mysql.jdbc.Driver"></property>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis-example"></property>
</dataSource>
</environment>
</environments>
<mappers>
<!--resource=映射路径-->
<!-- <mapper resource="mappers/EmployeeMapper.xml"/>-->
<package name="mappers"/>
</mappers>
</configuration>
这些配置的位置是有规定的，可以点configuration进去，可以看到下面的源码
所以先写驼峰<settings>,别名配置<typeAliases>,然后<environments>,<mappers>.
驼峰配置
pojo中属性命名采用驼峰命名规则，而表中字段名一般都是表名_字段名来表示，如果执行查询任务，我们在入门时采用的是取别名的方法，让结果集映射成功，封装到pojo类。但是如果字段名多了，这个方法就不太方便了，所以我们采用了驼峰命名法。直接在全局配置中加入下列代码。
<!-- 使用settings对Mybatis全局进行设置 -->
<settings>
<!-- 将xxx_xxx这样的列名自动映射到xxXxx这样驼峰式命名的属性名 -->
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
类型别名配置
在获取的结果集中，我们需要写全限定名，太长了，所以可以在全局配置中配置<typeAliases>标签，里面就是别名配置，有两种方法：
- 每一个typeAlias标签就表示配置一个别名
- type属性:要进行别名配置的类
- alias属性:取的别名
<typeAliases>
<typeAlias type="pojo.Employee" alias="employee"></typeAlias>
</typeAliases>
- 因为所有的POJO类基本上都是放在同一个包中,所以我们可以采用包扫描进行别名配置
用package标签进行包扫描,别名就是该类的类名(不区分大小写)
我们一般采用第二种(也就是包扫描的方式进行别名配置)
<typeAliases>
<package name="pojo"/>
</typeAliases>
Mapper映射
之前的案例都是只有一个接口，一个映射配置文件，如果多个接口多个映射配置文件，我们可以采取打包的方式，此时这个包下的所有Mapper配置文件将被自动加载、注册，比较方便。
但是，要求是：
- Mapper接口和Mapper配置文件名称一致
- Mapper配置文件放在Mapper接口所在的包内
<mappers>
<!--resource=映射路径-->
<!-- <mapper resource="mappers/EmployeeMapper.xml"/>-->
<package name="mappers"/>
</mappers>
模块下的包如图：
(7)映射配置文件
这一步重点是手动映射，为后面的多表查询做铺垫
<?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="mappers.EmployeeMapper">
<!--手动映射,多表查询都会用到手动映射
autoMapping="true"表示能自动映射的就自动映射
驼峰映射在全局配置中配置
-->
<resultMap id="employeeMap" type="Employee" autoMapping="true">
</resultMap>
<select id="selectCount" resultType="long">
select count(emp_id) from t_emp
</select>
<select id="selectEmployeeByEmpId" resultMap="employeeMap" >
select * from t_emp where emp_id=#{emp_id}
</select>
<!--返回值是map类型，就不适用于上面的手动映射了，直接自动驼峰-->
<select id="selectEmployeeMapByEmpId" resultType="map" >
select * from t_emp where emp_id=#{emp_id}
</select>
<select id="selectEmployeeList" resultMap="employeeMap" >
select * from t_emp
</select>
<select id="selectMapList" resultType="map">
select * from t_emp
</select>
<!--
useGeneratedKeys="true"表示获取自增长的主键值
keyProperty="empId"表示将获取到的自增长的主键值赋给传入的POJO的empId属性
-->
<insert id="insertEmployee" useGeneratedKeys="true" keyProperty="empId">
insert into t_emp (emp_name,emp_salary) values (#{empName},#{empSalary})
</insert>
</mapper>
映射
映射一般包括全自动映射，驼峰映射，手动映射
手动映射
完整映射步骤如下：
<!--
手动映射:通过resultMap标签配置映射规则
1. id属性:表示这个手动映射规则的唯一表示
2. type属性: 表示这个手动映射规则是将结果集映射给哪个类的对象，就是JavaBean类的全限定名
resultMap标签中的子标签就是一一指定映射规则:
1. id标签:表示对主键进行手动映射
2. result标签:指定非主键的映射规则
id标签和result标签的属性:
1. column:要进行映射的结果集的字段名
2. property:要进行映射的JavaBean的属性名
-->
<resultMap id="EmployeeMap" type="Employee">
<id column="emp_id" property="id"/>
<result column="emp_name" property="name"/>
<result column="emp_salary" property="salary"/>
</resultMap>
<!--
在select标签中通过resultMap属性来指定使用哪个手动映射规则
-->
<select id="selectEmployeeByEmpId" resultMap="EmployeeMap">
select * from t_emp where emp_id=#{empId}
</select>
对比以下我加在配置文件的代码，
<resultMap id="employeeMap" type="Employee" autoMapping="true">
</resultMap>
加了autoMapping="true"表示我在全局配置的驼峰命名先自动映射，再手动映射，因为后面的id,result标签采用的是驼峰命名的手动映射，所以可以不写了。不过后面的多表关联查询就需要注意。值得注意的是，如果需要用到手动映射的地方，返回值的类型要改为resultMap="employeeMap"
获取自动增长的主键值
在这里加了一个方法，添加一条数据之后再获得添加后的主键值。有两种方法：
第一种（经常）
- useGeneratedKeys="true"表示获取自增长的主键值
- keyProperty="empId"表示将获取到的自增长的主键值赋给传入的POJO的empId属性
<insert id="insertEmployee" useGeneratedKeys="true" keyProperty="empId">
insert into t_emp (emp_name,emp_salary) values (#{empName},#{empSalary})
</insert>
第二种
可以使用在那些不支持主键自增的数据库中，比如Oracle
- selectKey表示查询键:
- keyColumn="emp_id" 表示要查询emp_id字段
- keyProperty="empId" 将查询到的字段赋值给POJO的empId属性
- order="AFTER"表示在执行添加语句之后进行查询
- resultType="int" 表示查询到的主键的类型
<!-- <insert id="insertEmployee" >
<selectKey keyColumn="emp_id" keyProperty="empId" order="AFTER" resultType="int">
select last_insert_id()
</selectKey>
insert into t_emp(emp_name,emp_salary) values(#{empName},#{empSalary})
</insert>-->
（8）测试程序
import mappers.EmployeeMapper;
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 org.junit.After;
import org.junit.Before;
import pojo.Employee;
import java.io.InputStream;
public class Test {
private EmployeeMapper employeeMapper;
private InputStream is;
private SqlSession sqlSession;
@Before
public void init() throws Exception{
//目标:获取EmployeeMapper接口的代理对象，并且使用该对象调用selectEmployee(1)方法,然后返回Employee对象
//1. 将全局配置文件转成字节输入流
is = Resources.getResourceAsStream("mybatis-config.xml");
//2. 创建SqlSessionFactoryBuilder对象
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
//3. 使用构建者模式创建SqlSessionFactory对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
//4. 使用工厂模式创建一个SqlSession对象
sqlSession = sqlSessionFactory.openSession();
//5. 使用动态代理模式，创建EmployeeMapper接口的代理对象
employeeMapper = sqlSession.getMapper(EmployeeMapper.class);
}
@After
public void after() throws Exception{
//提交事务!!!
sqlSession.commit();
//7. 关闭资源
is.close();
sqlSession.close();
}
@org.junit.Test
public void testSelectCount(){
System.out.println(employeeMapper.selectCount());
}
@org.junit.Test
public void testSelectEmployeeByEmpId(){
System.out.println(employeeMapper.selectEmployeeByEmpId(1));
}
@org.junit.Test
public void testSelectEmployeeMapByEmpId(){
System.out.println(employeeMapper.selectEmployeeMapByEmpId(1));
}
@org.junit.Test
public void testSelectEmployeeList(){
System.out.println(employeeMapper.selectEmployeeList());
}
@org.junit.Test
public void testSelectMapList(){
System.out.println(employeeMapper.selectMapList());
}
@org.junit.Test
public void testInsertEmployee(){
Employee e=new Employee(null,"alisa",666d);
employeeMapper.insertEmployee(e);
System.out.println(e.getEmpId());
}
}
总结：
下篇整理多表关联查询
