记第一次使用MyBatis过程

一、环境

jdk 1.8
maven 3.3.9
mysql 5.5
idea 2020.3.1

二、第一个MyBatis代码编写过程

• 确认在已连接数据库的基础上
• 导入MyBatis相关的jar包

<dependency>
   <groupId>org.mybatis</groupId>
   <artifactId>mybatis</artifactId>
   <version>3.5.2</version>
</dependency>
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
   <version>5.1.47</version>
</dependency>

• 编写MyBatis核心配置文件
  该配置文件需要修改数据库相关的信息，用来连接数据库；第二个作用是映射到资源文件**Mapper.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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/book?useSSL=true&amp;userUnicode=true&amp;characterEncoding=UTF-8&amp;serverTimezone=GMT%2B8"/>
                <!--                <property name="url" value="jdbc:mysql://localhost:3306"/>-->
                <property name="username" value="root"/>
                <property name="password" value="061536"/>
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="com/zxf/lesson/dao/BookMapper.xml"/>
    </mappers>
</configuration>

可能出现的问题：

• 找不到数据库驱动：
  Error setting driver on UnpooledDataSource.Cause:java.lang.ClassNotFoundException: Cannot find class:com.mysql.jdbc.Driver

• 解决方法：可能是数据库版本问题，我在maven配置文件中换了一个高一点的数据库版本，注意还要修改数据库的时区，在url值中，最后加上serverTimezone=GMT%2B8，不然连不上数据库。
  jdbc:mysql://localhost:3306/book?useSSL=true&userUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8

• 编写MyBatis工具类
  通过刚刚创建的配置文件作为一个输入流，借助SqlSessionFactoryBuilder().build()生成一个sqlSessionFactory对象，然后通过getSession()方法中的sqlSessionFactory.openSession();获取SqlSession连接。代码如下：

public class Mybatisutils {

    private static SqlSessionFactory sqlSessionFactory;

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

    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

• 创建实体类
  根据数据库表的信息，创建实体类，包含表中的变量，生成空参、带参构造器，变量的get、set方法，tostring方法。

• 创建Mapper接口
  Mapper接口类似于之前使用JDBC时的UserDao接口

public interface BookMapper {
    List<Book> selectBook();
}

• 编写Mapper.xml配置文件
  这个Mapper.xml文件是用来实现Mapper接口，相当于JDBC中的UserDaoImpl类

<?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.zxf.lesson.dao.BookMapper">
    <select id="selectBook" resultType="com.zxf.lesson.pojo.Book">
        select * from t_book
    </select>
</mapper>

namespace：BookMapper接口的位置
id：要实现的方法
resultType：实体类路径
select * from t_book sql语句
这个Mapper.xml配置文件的作用相当于实现namespace位置接口中的明为id的方法，方法体为 select * from t_book ，返回值类型为resultType。
那么，如何是这个配置文件生效，就是在前面的MyBatis核心配置文件中有个<mappers> <mapper resource="com/zxf/lesson/dao/BookMapper.xml"/> </mappers>
这样就使两个文件相互关联起来了。

• 编写测试类

public class BookDaoTest {

    @Test
    public void bookDaoTest(){
        SqlSession session = Mybatisutils.getSqlSession();
        BookMapper bookMapper = session.getMapper(BookMapper.class);
        List<Book> books = bookMapper.selectBook();
        for (Book book : books) {
            System.out.println(book);
        }
        session.close();
    }
}

开启测试,启动配置文件mybatis-config.xml---->连接数据库，映射BookMapper.xml文件---->实现BookMapper接口---->获取session 数据库连接对象---->通过session中的getMapper方法获取映射得到Mapper对象，相当于JDBC中的UserDaoImpl对象---->对象调用方法执行sql语句---->关闭资源

• 结果
  
  成功查找到数据库表中的信息