MyBatis快速入门案例

学了好久没用又忘了，所以回去复习了一下，这篇blog总结了MyBatis快速入门案例，非常适合小白学习MyBatis的快速入门！

mybatis 是一个优秀的基于 java 的持久层框架，它内部封装了 jdbc，使开发者只需要关注 sql 语句本身，而不需要花费精力去处理加载驱动、创建连接、创建 statement 等繁杂的过程。
mybatis 通过 xml 或注解的方式将要执行的各种 statement 配置起来，并通过 java 对象和 statement 中sql 的动态参数进行映射生成最终执行的 sql 语句，最后由 mybatis 框架执行 sql 并将结果映射为 java 对象并返回。
采用 ORM 思想解决了实体和数据库映射的问题，对 jdbc 进行了封装，屏蔽了 jdbc api 底层访问细节，使我们不用与 jdbc api 打交道，就可以完成对数据库的持久化操作。

ORM思想（Object Relational Mapping）对象关系映射

简单的说：就是把数据库表和实体类及实体类的属性对应起来，让我们可以操作实体类就实现操作数据库表

MyBatis入门案例步骤

• 第一步：创建数据库，创建maven工程在pom.xml中导入依赖坐标（mysql、mybatis、logj、junit单元测试），log4jp.propotites导入
• 第二步：创建实体类User（属性定义，get/set方法，tostring方法）和dao接口
• 第三步：创建mybatis的主配置文件SqlMapConfig.xml（导入头部约束、environment配置mysql的环境、mapper配置映射文件的位置）
• 第四步：创建映射配置文件IUserDao.xml（导入mapper/Dao约束、名字空间、id、resultType、sql语句）
• 第五步：在测试类中写测试方法，测试CRUD操作

注意事项：

• 第一个：创建IUserDao.xml和IUserDao.java的名称是为了和我们之前的知识保持一致，在mybatis中它把吃就成的操作接口名称和映射文件也叫做：Mapper。所以IUserDao和IUserMapper是一样的
• 第二个：在idea创建目录的时候，它和包是不一样的。包在在创建时com.baihui.dao时三级目录，而目录在创建时是一级目录
• 第三个：mabatis的映射配置文件位置必须和dao接口的包结构相同
• 第四个：映射配置文件的mapper标签namespace属性的取值必须是dao接口的全限定类名
• 第五个：映射配置文件的操作配置（select），id属性的取值必须是dao接口的方法名
• 当我遵从了第三四五点之后，我们在开发中就无需再写dao的实现类

入门案例文件结构如下：

1、创建数据库，导入依赖坐标

在数据库eesy_mybatis中创建user表：

在pom.xml中添加mybatis、mysql（连接数据库）、log4j（用于打印日志）、junit（用于测试）：

<?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">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>day01_eesy_01mybatis</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>14</maven.compiler.source>
        <maven.compiler.target>14</maven.compiler.target>
    </properties>

    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.6</version>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.12</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

2、编写User实体类

在com.baihui目录下新建domian目录，创建User实体类：

package com.baihui.domain;

import java.io.Serializable;
import java.util.Date;

public class User implements Serializable {

    private Integer id;
    private String username;
    private Date birthday;
    private String sex;
    private String address;
	//省略get、set、tostring方法
}

3、编写持久层接口IUserDao

在com.baihui目录下新建dao目录，创建IUserDao接口，定义一个findAll()方法：

package com.baihui.dao;

import com.baihui.domain.User;
import java.util.List;

public interface IUserDao {
    //查询所有用户
    List<User> findAll();
}

4、编写持久层接口的映射配置文件IUserDao.xml

创建位置：必须和持久层接口在相同的包中。

名称：必须以持久层接口名称命名文件名，扩展名是.xml

• 注意事项：不要忘记在映射配置中告知mybatis要封装到哪个实体类中，配置的方式：指定实体类的全限定类名

<?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.baihui.dao.IUserDao">
    <!--配置查询所有-->
    <select id="findAll" resultType="com.baihui.domain.User">
        select * from user
    </select>
</mapper>

5、编写SqlMapConfig.xml主配置文件

在resource目录下创建mybatis主配置文件SqlMapConfig.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">

<!--mabatis的主配置文件-->
<configuration>
    <!--配置环境-->
    <environments default="mysql">
        <!--配置mysql环境-->
        <environment id="mysql">
            <!--配置事务类型-->
            <transactionManager type="jdbc"></transactionManager>
            <!--配置数据源（连接池）-->
            <dataSource type="POOLED">
                <!--配置连接数据库的4个基本信息-->
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/eesy_mybatis?serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="1234"/>
            </dataSource>
        </environment>
    </environments>

    <!--指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件-->
    <mappers>
        <mapper resource="com/baihui/dao/IUserDao.xml"/>
    </mappers>
</configuration>

6、编写测试类

• 第一步：读取配置文件
• 第二步：创建工厂
• 第三步：用工厂创建SqlSession对象
• 第四步：创建dao接口的代理对象
• 第五步：执行dao中的方法
• 第六步：释放资源

package com.baihui.test;

import com.baihui.dao.IUserDao;
import com.baihui.domain.User;
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.InputStream;
import java.util.List;

public class MybatisTest01 {
    //入门案例
    public static void main(String[] args) throws Exception{
        //1.读取配置文件
        InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
        //2.创建 SqlSessionFactory 的构建者对象
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
		//3.使用构建者创建工厂对象 SqlSessionFactory
        SqlSessionFactory factory = builder.build(in);
		//4.使用 SqlSessionFactory 生产 SqlSession 对象
        SqlSession session = factory.openSession();
		//5.使用 SqlSession 创建 dao 接口的代理对象
        IUserDao userDao = session.getMapper(IUserDao.class);
		//6.使用代理对象执行查询所有方法
        List<User> users = userDao.findAll();
        for(User user : users) {
            System.out.println(user);
        }
		//7.释放资源
        session.close();
        in.close();
    }
}

查询成功