1. 简介

1.1 什么是MyBatis

MyBatis 是一款优秀的持久层框架。
它支持自定义 SQL、存储过程以及高级映射。
MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

如何获取MyBatis?

maven仓库

<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.2</version>
</dependency>

GitHub：https://github.com/mybatis/mybatis-3/releases/tag/mybatis-3.5.3
中文文档：https://mybatis.net.cn/getting-started.html

2. 第一个MyBatis程序

思路流程：搭建环境–>导入Mybatis—>编写代码—>测试

2.1 搭建环境

创建数据库：

CREATE DATABASE `mybatis`;
USE `mybatis`;
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
`id` int(20) NOT NULL,
`name` varchar(30) DEFAULT NULL,
`pwd` varchar(30) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
insert into `user`(`id`,`name`,`pwd`) values (1,'狂神','123456'),(2,'张
三','abcdef'),(3,'李四','987654');

创建项目：

新建一个maven项目
删除src目录
导入maven依赖

pom.xml

<!--导入依赖-->
<dependencies>
    <!--mybatis驱动-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.47</version>
    </dependency>
    <!--mybatis-->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.2</version>
    </dependency>
    <!--junit-->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>
</dependencies>

2.2 创建一个模块

在这里插入图片描述

在生成的模块中也会有pom.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>com.xxc</artifactId>
        <groupId>org.example</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>mybatis-01</artifactId>
</project>

说明：从这里可以看到子模块的的父类引用配置是在外层的pom.xml中配置。可以实现资源的共用，好处多多。

编写MyBatis核心配置文件，mybatis-config.xml

<?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核心配置文件-->
<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?useSSL=false&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="xxc113206"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/xxc/dao/UserMapper.xml"/>
    </mappers>
</configuration>

说明：environments default=“development”，说明可以配置多套环境，default是具体要取哪一套环境，这里使用development。mappers是注册所有的xml文件，如果还有其他的xml也需要往里添加，路径是斜杠，不是点，要注意。

编写mybatis工具类

// sqlSessionFactory  -->  sqlSession
public class MyBatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    static {
        try {
            // 获取MyBatis第一步：获取sqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    // 既然有了sqlSessionFactory，顾名思义，我们就可以从中获得SqlSession的实例了
    // SqlSession 完全包含了面向数据库执行SQL命令所需的所有方法
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

注意：mybatis-config.xml为对应的mybaits配置名称。工具类写好之后不用改变。

2.3 编写代码

实体类（pojo => User.java）

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

    // 构造器
	// get 和 set 方法
    // toString方法

Dao接口（UserDao.java）

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

接口实现类有原来的UserDaoImpl转换为一个mapper.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="com.xxc.dao.UserDao">
   <select id="getUserList" resultType="com.xxc.pojo.User">
       select * from user;
   </select>
</mapper>

这里注意namespace不能写错，为UserDao的全路径地址。resultType为返回值类型。

2.4 测试

public class UserDaoTest {
    @Test
    public void test(){
        // 第一步，获取SqlSession对象
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        // 执行  方式一：
        UserDao userDao = sqlSession.getMapper(UserDao.class);
        List<User> userList = userDao.getUserList();
        for (User user : userList){
            System.out.println(user);
        }
        System.out.println("==============================");
        // 方式二：
        List<User> UserList1 = sqlSession.selectList("com.xxc.dao.UserDao.getUserList");
        for (User user : UserList1){
            System.out.println(user);
        }
        //关闭SqlSession
        sqlSession.close();
    }
}

在Test下创建一个UserDaoTest的文件。通过之前写的工具类MyBatisUtils获取到sqlSession。
方法二的一些说明：它在命名空间 “com.xxc.dao.UserDao” 中定义了一个名为 “selectList” 的映射语句，这样你就可以用全限定名 “com.xxc.dao.UserDao.selectList” 来调用映射语句了。
推荐使用第一种方式。

在这里插入图片描述

问题说明：

Maven静态资源过滤问题，需要在pom.xml中配置如下信息：

<build>
    <resources>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>