MyBatis IDEA 程序配置教程

MyBatis 是一款基于 Java 的持久层框架,它支持定制化 SQL、存储过程以及高级映射。对于经常使用 IDEA 进行 Java 开发,可以按照本教程配置 MyBatis。

本文使用的实验环境:IDEA2020.1 + MySQL8.0.21 + Mybatis3.5.5 + Junit4.13。

1. 搭建实验数据库

我们创建一个 mybatis 实验数据库,并创建一个 user 表为后续实验准备。

CREATE DATABASE `mybatis`;
USE `mybatis`;

CREATE TABLE `user`(
	`id` INT(4) NOT NULL PRIMARY key,
	`name` VARCHAR(20) NOT NULL,
	`pwd` VARCHAR(20) NOT NULL
)ENGINE=INNODB DEFAULT CHARSET=utf8;

INSERT INTO `user` VALUE
(1,'zsr','200024'),
(2,'gcc','000421'),
(3,'bareth','123456');

2. 新建 IDEA 项目

  • 新建一个普通的maven项目
  • 删除 src 目录,作为父工程
  • pom.xml 中导入相关的 maven 依赖
<!--导入依赖-->
 <dependencies>
 <!--MySQL驱动-->
 <dependency>
 <groupId>mysql</groupId>
 <artifactId>mysql-connector-java</artifactId>
 <version>8.0.21</version>
 </dependency>
 <!--MyBatis驱动-->
 <dependency>
 <groupId>org.mybatis</groupId>
 <artifactId>mybatis</artifactId>
 <version>3.5.5</version>
 </dependency>
 <!--junit驱动-->
 <dependency>
 <groupId>junit</groupId>
 <artifactId>junit</artifactId>
 <version>4.13</version>
 <scope>test</scope>
 </dependency>
 </dependencies>

连接 MySQL 数据库,选择我们前面创建的数据库 mybatis 并打开:

MyBatis IDEA 配置教程

3. 编写 MyBatis 核心配置文件

在 MyBatis 核心配置文件中,创建一个子模块 maven_study01

MyBatis IDEA 配置教程

在该模块的 resource 目录下,新建 mybatis-config.xml 文件,这是 MyBatis核心配置 文件。

MyBatis IDEA 配置教程

<?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>
 <environments default="development">
 <environment id="development">
 <transactionManager type="JDBC"/>
 <dataSource type="POOLED">
 <property name="driver" value="com.mysql.jdbc.Driver"/>
 <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSH=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
 <property name="username" value="root"/>
 <property name="password" value="200024"/>
 </dataSource>
 </environment>
 </environments>
</configuration>

注意:以下部分换成自己的数据库信息。

<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>

4. 编写 MyBatis 工具类

  • 在子模块 maven_study01/src/main/java 目录下,新建一个 utils 工具类包,新建 MyBatisUtils 类
  • 该类用来从 XML 中构建 SqlSessionFactory

MyBatis IDEA 配置教程

package 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;

//从 SqlSessionFactory 中获取 SqlSession
public class MybatisUtils {
 private static SqlSessionFactory sqlSessionFactory;

 static {
 try {
 //获取SqlSessionFactory对象
 String resource = "mybatis-config.xml";
 InputStream inputStream = Resources.getResourceAsStream(resource);
 sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
 } catch (IOException e) {
 e.printStackTrace();
 }
 }

 //从 SqlSessionFactory 中获取 SqlSession
 public static SqlSession getSqlSession() {
 SqlSession sqlSession = sqlSessionFactory.openSession();
 return sqlSession;
 }
}

5. 创建表对应实体类

数据库中每个表的每一行对应了一个实体类对象,这里我们对前面创建的 user表 创建对应的实体类。

在 maven_study01/src/main/java 目录下,新建 pojo 实体类包,其中新建 User类

MyBatis IDEA 配置教程

package pojo;

public class User {
 private int id;
 private String name;
 private String pwd;

 public User() {
 }

 public User(int id, String name, String pwd) {
 this.id = id;
 this.name = name;
 this.pwd = pwd;
 }

 public int getId() {
 return id;
 }

 public void setId(int id) {
 this.id = id;
 }

 public String getName() {
 return name;
 }

 public void setName(String name) {
 this.name = name;
 }

 public String getPwd() {
 return pwd;
 }

 public void setPwd(String pwd) {
 this.pwd = pwd;
 }

 @Override
 public String toString() {
 return "User{" +
 "id=" + id +
 ", name='" + name + '\'' +
 ", pwd='" + pwd + '\'' +
 '}';
 }
}

6. 编写 Mapper 接口

在 maven_study01/src/main/java 目录下,新建 mapper包,其中新建 UserMapper 接口。

其中抽象方法 getUserList() 用来返回 User 对象的集合。

package mapper;

import pojo.User;

import java.util.List;

public interface UserMapper {
 List<User> getUserList();
}

MyBatis IDEA 配置教程

7. 编写 Mapper.xml 配置文件

在子模块 /src/main/java/mapper 下,新建 UserMapping.xml

<?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="mapper.UserMapper">
 <select id="getUserList" resultType="pojo.User">
 select * from mybatis.user
 </select>
</mapper>
  • namespace = 自己创建Mapper接口
  • id = 对应Mapper接口的方法名
  • resultType = 返回结果类型
  • select 中间是sql语句

MyBatis IDEA 配置教程

8. 编写 junit 测试类

在 maven_study01/test/java 下新建 mapper包,该包下新建测试类 UserMapperTest

junit测试:

package mapper;

import mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import pojo.User;
import utils.MyBatisUtils;

import java.util.List;

public class UserMapperTest {
 @Test
 public void test() {
 //获取sqlSession对象
 SqlSession sqlSession = MyBatisUtils.getSqlSession();

 //执行SQL
 UserMapper mapper = sqlSession.getMapper(UserMapper.class);
 List<User> userList = mapper.getUserList();

 for (User user : userList) {
 System.out.println(user);
 }
 //关闭sqlSession
 sqlSession.close();
 }
}

MyBatis IDEA 配置教程

9. 给 Mapper.xml 添加注册

每一个 Mapper.xml 都需要在 MyBatis 核心配置文件中注册。

我们要在 mybatis-config.xml 中进行注册,最后加上以下代码:

<!--每一个Mapper.xml都需要在MyBatis核心配置文件中注册-->
<mappers>
 <mapper resource="mapper/UserMapping.xml"/>
</mappers>

这里的路径是我们定义的xml配置文件的路径

注意:该路径的中要用/进行分隔

MyBatis IDEA 配置教程

10. 测试运行

我们点击运行测试类 UserMapperTest,成功!

发现他提示我们驱动类名已经遗弃,我们利用他给的新驱动名即可,在 MyBatis 核心配置文件中,将驱动名更换为以下即可

<property name="driver" value="com.mysql.cj.jdbc.Driver"/>

再测试,没有错误~

MyBatis IDEA 配置教程

11. 可能遇到的问题

1) 配置文件没有注册

每一个 Mapper.xml 都需要在 MyBatis 核心配置文件中注册

2) 绑定接口不对,方法名不对,返回类型不对

对应如图所示三个参数

MyBatis IDEA 配置教程

3) maven配置文件无法被导出或生效

MyBatis IDEA 配置教程

maven默认资源文件配置在 resource 目录下,但是我们放在了 java 目录下,该目录下无法导出,所以需要手动配置资源过滤,让 src/main/java 下的 .properties 或 .xml 可以导出。

解决方案是:将以下设置写在 pom.xml中

<!--在build中配置resources,防止我们资源导出失败的问题-->
<build>
 <resources>
 <resource>
 <directory>src/main/resources</directory>
 <includes>
 <include>**/*.properties</include>
 <include>**/*.xml</include>
 </includes>
 <filtering>true</filtering>
 </resource>
 <resource>
 <directory>src/main/java</directory>
 <includes>
 <include>**/*.properties</include>
 <include>**/*.xml</include>
 </includes>
 <filtering>true</filtering>
 </resource>
 </resources>
</build>

12. 步骤作用及总结

对整个过程进行总结,可分为七大步骤:

  • 编写 MyBatis 核心配置 xml 文件,其中包括了获取数据库连接实例的数据源(DataSource)以及决定事务作用域和控制方式的事务管理器(TransactionManager)
  • 编写 MyBatis 工具类,加载上述 xml 文件,从该xml文件中构建 SqlSessionFactory,再从 SqlSessionFactory 中获取 SqlSession,SqlSession 提供了在数据库执行 SQL 命令所需的所有方法
  • 创建数据库表对应的实体类,把 JavaBean 的属性和数据库表的字段自动关联起来
  • 编写一个 Mapper 接口,定义抽象方法用来执行下述 Mapper.xml 配置中文件中的 SQL
  • 编写 Mapper.xml 配置文件,绑定上述 Mapper 接口,以及对应的抽象方法
  • 在 MyBatis 核心配置 xml 文件中给 Mapper.xml 配置文件添加注册
  • 编写 junit 测试类测试