二、第一个Mybatis程序

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

1.搭建环境

先提供一个数据库和用来操作的表
新建项目
1.File->new Project 新建maven项目

下面这一堆代码是构建maven项目以后，自带的

<?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>com.kuang</groupId>
    <artifactId>Mybatis-study</artifactId>
    <version>1.0-SNAPSHOT</version>

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

</project>

2.删除src,这样就可以当成父工程了
3.导入maven依赖
第一次加入依赖的时候，项目会爆红，记得重新加载项目，这样就不会爆红了

<!--导入依赖-->
    <dependencies>
<!--         mysql驱动-->
        <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.16</version>
        </dependency>

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

        <!--        junit驱动-->
        <!-- https://mvnrepository.com/artifact/org.junit.jupiter/junit-jupiter-api -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>5.8.2</version>
            <scope>test</scope>
        </dependency>

    </dependencies>

2.创建一个新模块

父项目的pox.xml就会多出来这样的代码

 <modules>
        <module>mybatis-01</module>
        <module>mybatis-01</module>
        <module>mybatis-01</module>
    </modules>

• 编写mybatis核心配置文件
  
  把下面的代码拷贝到刚刚新建的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="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="org/mybatis/example/BlogMapper.xml"/>
    </mappers>
</configuration>

上面那一个从官网复制过来的，相当于是一个模板，但是里面具体的信息需要我们自己去设置，比如说我们要连接的数据库的用户名，密码等信息需要手动配置

<?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">
<!--            事务管理器，类型是JDBC-->
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?serverTimezone=Asia/Shanghai&amp;useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="a87684009."/>
<!--                数据源就是连接是连接数据库的信息-->
            </dataSource>
        </environment>
        <environment id="test">
            <transactionManager type="JDBC"/>
<!--            type=POOLED表示使用数据库连接池-->
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
<!--    引入映射文件-->
<!--    每一个Mapper.xml都需要在Mybatis的核心配置文件中注册-->
    <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
    </mappers>
</configuration>

3.编写代码

• 编写mybatis工具类

//工厂模式
//sqlSessionFactory---->sqlSession
public class MybatisUtils {
    public static SqlSessionFactory sqlSessionFactory;

    static {

        try {
            //读取配置文件
            //下面三句话是固定的
            //使用Mybatis第一步:获取sqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            SqlSessionFactory build = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    /**
     * 既然有了SqlSessionFactory,顾名思义，我们就可以从中获取SqlSession的实例了
     * SqlSession完全包含了面向数据库执行sql命令所需要的所有方法
     */
    public static SqlSession getSqlSession() {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        return  sqlSession;
    }


}

• 实体类(domain,pojo,domain)每一个类都和数据库中的一张表相关联

package com.kuang.pojo;

/**实体类
 * @author zengyihong
 * @create 2022--03--28 17:14
 */
public class User {
 private int id;
 private String username;
 private String password;

 public User() {
 }

 public User(int id, String username, String password) {
  this.id = id;
  this.username = username;
  this.password = password;
 }

 public int getId() {
  return id;
 }

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

 public String getUsername() {
  return username;
 }

 public void setUsername(String username) {
  this.username = username;
 }

 public String getPassword() {
  return password;
 }

 public void setPassword(String password) {
  this.password = password;
 }

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

• DAO接口(对数据库表的CRUD操作，对user表的操作就对应一个userDao)

package com.kuang.dao;

import com.kuang.pojo.User;

import java.util.List;

/**这个类用来操作数据库中对象的实体
 * @author zengyihong
 * @create 2022--03--28 17:16
 */
//dao等价于mapper
public interface UserDao {
    List<User> getUserList();
}

• 接口实现类由原来的UserDaoImpl转换成为一个Mapper配置文件

<?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">
<!--命名空间要绑定一个对应的DAO/Mapper接口-->
<mapper namespace="com.kuang.dao.UserDao">
<!--     select查询语句 id对应原来的方法名字-->
    <select id="getUserList"  resultType="com.kuang.pojo.User">
        select  * from mybatis.user
    </select>

</mapper>

可能大家看到上面那些有点懵，那我们就来复习一下 ，具体的大家可以看我博客中JDBC的内容，里面有关于分层的讲解。

4.Junit测试

package com.kuang.dao;

import com.kuang.pojo.User;
import com.kuang.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.jupiter.api.Test;

import java.util.List;

/**
 * @author zengyihong
 * @create 2022--03--29 9:55
 */
public class UserDaoTest {
    @Test
    public void test(){
//        SqlSession
//                第一步：获得SqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        //方式一：执行SQL getMapper
        UserDao mapper = sqlSession.getMapper(UserDao.class);
        List<User> userList = mapper.getUserList();
        for (User user:userList){
            System.out.println(user);
        }
        //关闭SqlSession

        sqlSession.close();

    }

}

三、可能遇到的问题

1.配置文件没有注册
2.绑定接口错误
3.方法名错误
4.返回类型错误
5.maven导出资源错误
在pox.xml中，加入下面代码即可

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