二、mybatis之数据输出

时间:2023-03-10 00:34:53
二、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进去,可以看到下面的源码

二、mybatis之数据输出

所以先写驼峰<settings>,别名配置<typeAliases>,然后<environments>,<mappers>.

驼峰配置

pojo中属性命名采用驼峰命名规则,而表中字段名一般都是表名_字段名来表示,如果执行查询任务,我们在入门时采用的是取别名的方法,让结果集映射成功,封装到pojo类。但是如果字段名多了,这个方法就不太方便了,所以我们采用了驼峰命名法。直接在全局配置中加入下列代码。

<!-- 使用settings对Mybatis全局进行设置 -->
<settings>
<!-- 将xxx_xxx这样的列名自动映射到xxXxx这样驼峰式命名的属性名 -->
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>

类型别名配置

在获取的结果集中,我们需要写全限定名,太长了,所以可以在全局配置中配置<typeAliases>标签,里面就是别名配置,有两种方法:

  1. 每一个typeAlias标签就表示配置一个别名
  • type属性:要进行别名配置的类
  • alias属性:取的别名
<typeAliases>
<typeAlias type="pojo.Employee" alias="employee"></typeAlias>
</typeAliases>
  1. 因为所有的POJO类基本上都是放在同一个包中,所以我们可以采用包扫描进行别名配置

    用package标签进行包扫描,别名就是该类的类名(不区分大小写)

    我们一般采用第二种(也就是包扫描的方式进行别名配置)
<typeAliases>
<package name="pojo"/>
</typeAliases>
Mapper映射

之前的案例都是只有一个接口,一个映射配置文件,如果多个接口多个映射配置文件,我们可以采取打包的方式,此时这个包下的所有Mapper配置文件将被自动加载、注册,比较方便。

但是,要求是:

  • Mapper接口和Mapper配置文件名称一致
  • Mapper配置文件放在Mapper接口所在的包内
<mappers>
<!--resource=映射路径-->
<!-- <mapper resource="mappers/EmployeeMapper.xml"/>-->
<package name="mappers"/>
</mappers>

模块下的包如图:

二、mybatis之数据输出

(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());
}
}

总结:

二、mybatis之数据输出

下篇整理多表关联查询