大纲
- 配置的修改
- 代码的修改
- Main.java文件所在包下
- 新增org.example.model包
- 新增org.example.mapper包
- 单元测试
在《0基础学习Mybatis系列数据库操作框架——最小Demo》一文中，我们用最简单的方法组织出一个Mybatis应用项目。为了后续构建更符合日常开发环境的项目，我们对项目的目录结构做了调整，并引入了单元测试组件JUnit。
配置的修改
在resources目录下，将mybatis相关的配置聚合到名字叫mybatis的目录下，这样会方便后续管理。因为实际开发中，我们还会使用到很多其他组件的配置。如果散乱在resources这个目录下，将不利于后期维护。
mybatis的配置由两部分组成：
- 数据库连接和mapper文件路径。这个配置叫mybatis-config.xml，我们把它放在config目录下。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"https://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/testdb?useSSL=true&useUnicode=true&characterEncoding=utf8"/>
<property name="username" value="root"/>
<property name="password" value="fangliang"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="mybatis/mapper/AllTypeMapper.xml"/>
</mappers>
</configuration>
- mapper文件。可能是多个mapper文件，我们把它们放到mapper目录下。本例我们只设计了一个mapper，但是含有两条SQL。
- findAll用查询表中所有数据。
- findOne会根据传入的参数返回最多一条数据。
需要注意的是mapper的namespace，它与后续我们定义的SQL映射器（mapper）接口的包(org.example.mapper)和名称(AllTypeMapper)组合一致。否则我们在后续的Java代码中不能创建SQL映射器对象。
<?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="org.example.mapper.AllTypeMapper">
<select id="findAll" resultType="org.example.model.AllType">
select * from all_type
</select>
<select id="findOne" resultType="org.example.model.AllType">
select * from all_type where info_int = #{info_int}
</select>
</mapper>
代码的修改
主要修改分为两部分
Main.java文件所在包下
新增org.example.model包
用于保存SQL结果映射的Java对象类。
package org.example.model;
public class AllType {
public int getInfo_int() {
return info_int;
}
public void setInfo_int(int info_int) {
this.info_int = info_int;
}
private int info_int;
}
新增org.example.mapper包
用于保存SQL语句映射器类（Mapper Class）的接口定义（Interface）。这个概念我们并没有在《0基础学习Mybatis系列数据库操作框架——最小Demo》中涉及，因为之前我们直接通过全限定名“AllTypeMapper.findAll”访问了SQL方法。而本文我们将使用映射机器来访问。
注意映射器接口中的findOne方法名，在之前写好的SQL XML文件中看到过。后续我们还将在单元测试代码中见到它。
这个接口的定义连接了SQL XML和Java代码。
package org.example.mapper;
import org.example.model.AllType;
public interface AllTypeMapper {
AllType findOne(int info_int);
}
单元测试
和main目录对等，建立相似的目录结构和包。
我们并不打算针对main下的model和mapper包做单元测试，而是在单元测试中测试mybatis相关特性，所以test目录下的org.example包下只有一个测试文件AllTypeTest.java。
不同于《0基础学习Mybatis系列数据库操作框架——最小Demo》中查询所有数据的写法
try (SqlSession s = sqlSF.openSession()) {
all = s.selectList("org.example.mapper.AllTypeMapper.findAll");
}
for (AllType a : all) {
System.out.println(a.getInfo_int());
}
本文要根据根据传入的参数，动态修改SQL语句。注意下面的写法：
- 通过connection的getMapper方法获取映射器类（传入的是接口）。
- 通过映射器类的方法（继承自映射器接口），修改SQL语句并获得返回结果。
try (SqlSession s = sqlSF.openSession()) {
AllTypeMapper all_type_mapper = s.getMapper(AllTypeMapper.class);
AllType a = all_type_mapper.findOne(1);
System.out.println(a.getInfo_int());
}
完整代码如下：
package org.example;
import org.example.model.AllType;
import org.example.mapper.AllTypeMapper;
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.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
public class AllTypeTest {
private static SqlSessionFactory sqlSF;
@BeforeAll
static void CreateSessionFactory() throws IOException {
InputStream in = Resources.getResourceAsStream("mybatis/config/mybatis-config.xml");
sqlSF = new SqlSessionFactoryBuilder().build(in);
}
@Test
void testFindAll() {
List<AllType> all = null;
try (SqlSession s = sqlSF.openSession()) {
all = s.selectList("org.example.mapper.AllTypeMapper.findAll");
} catch (Exception e) {
System.out.println(e.getMessage());
}
for (AllType a : Objects.requireNonNull(all)) {
System.out.println(a.getInfo_int());
}
}
@Test
void testFindOne() {
try (SqlSession s = sqlSF.openSession()) {
AllTypeMapper all_type_mapper = s.getMapper(AllTypeMapper.class);
AllType a = all_type_mapper.findOne(1);
if (a != null) {
System.out.println(a.getInfo_int());
}
} catch (Exception e) {
System.out.println(e.getMessage());
}
}
}
经过优化后的目录结构，将有利于后续我们的设计和探索。
