我肝了一個星期，爲大家整理出了mybatis程序配置教程

一、搭建實驗數據庫

• 咱們建立一個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');

二、IDEA新建項目，鏈接數據庫

• 新建一個普通的maven項目

• 刪除src目錄，做爲父工程

• pom.xml中導入相關的maven依賴

1. MySQL驅動

2. MyBatis驅動

3. junit驅動

<!--導入依賴-->
<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核心配置文件

• 建立一個子模塊maven_study01

• 在該模塊的resource目錄下，新建mybatis-config.xml文件，這是MyBatis核心配置文件

<?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&useUnicode=true&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}"/>

四、編寫MyBatis工具類

• 在子模塊maven_study01/src/main/java目錄下，新建一個utils工具類包，新建MyBatisUtils類

• 該類用來從 XML 中構建 SqlSessionFactory

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

五、建立表對應實體類

數據庫中每一個表的每一行對應了一個實體類對象，這裏咱們對前面建立的user表建立對應的實體類

• 在maven_study01/src/main/java目錄下，新建pojo實體類包，其中新建User類

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 + '\'' +
'}';
}
}

六、編寫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();
}

七、編寫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語句

八、編寫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();
}
}

九、給Mapper.xml添加註冊

每個Mapper.xml都須要在MyBatis核心配置文件中註冊

咱們要在mybatis-config.xml中進行註冊，最後加上如下代碼

<!--每個Mapper.xml都須要在MyBatis核心配置文件中註冊-->
<mappers>
<mapper resource="mapper/UserMapping.xml"/>
</mappers>

這裏的路徑是咱們定義的xml配置文件的路徑

注意：該路徑的中要用/進行分隔

十、測試運行

咱們點擊運行測試類UserMapperTest，成功！

發現他提示咱們驅動類名已經遺棄，咱們利用他給的新驅動名便可，

在MyBatis核心配置文件中，將驅動名更換爲如下便可

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

再測試，沒有錯誤~

十一、可能遇到的問題

• 配置文件沒有註冊

1. 每個Mapper.xml都須要在MyBatis核心配置文件中註冊

• 綁定接口不對，方法名不對，返回類型不對

1. 對應如圖所示三個參數

• maven配置文件沒法被導出或生效

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>

十二、步驟做用及總結

對整個過程進行總結，可分爲七大步驟：

1. 編寫MyBatis核心配置xml文件，其中包括了獲取數據庫鏈接實例的數據源（DataSource）以及決定事務做用域和控制方式的事務管理器（TransactionManager）

2. 編寫MyBatis工具類，加載上述xml文件，從該xml文件中構建 SqlSessionFactory，再從 SqlSessionFactory 中獲取 SqlSession，SqlSession 提供了在數據庫執行 SQL 命令所需的全部方法

3. 建立數據庫表對應的實體類，把JavaBean的屬性和數據庫表的字段自動關聯起來

4. 編寫一個Mapper接口，定義抽象方法用來執行下述Mapper.xml配置中文件中的 SQL

5. 編寫Mapper.xml配置文件，綁定上述Mapper接口，以及對應的抽象方法

6. 在MyBatis核心配置xml文件中給Mapper.xml配置文件添加註冊

7. 編寫junit測試類測試