1、MyBatis 快速入门

• 使用工具：IDEA
• Maven项目环境

步骤

1. 创建项目
2. 导包/添加依赖（Mybatis，mysql-connector-java是必须的）
3. 数据库建表
4. 配置全局配置文件(配置数据源Environment)
5. 创建对象关系模型（POJO）
6. 创建Mapper接口
7. 创建Mapper接口对应的映射文件（xml）
8. 全局配置文件中注册Mapper.xml映射文件
9. 测试

1、创建项目

选择Maven，然后点击next即可；

填写GroupId和ArtifactId，然后一路点击next即可；

2、导包

在POM文件中添加相关依赖（使用mybatis框架至少需要添加Mybatis和mysql-connector-java的依赖）

相关依赖以及可以访问 http://mvnrepository.com/ 进行查找

必须依赖

        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.5</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.20</version>
        </dependency> 

其他依赖

        <!--便于测试-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13</version>
            <scope>test</scope>
        </dependency>
        <!-- https://mvnrepository.com/artifact/log4j/log4j -->
        <!--用于打印日志-->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency> 

3、数据库建表

创建数据库

填写数据名（随意），字符集选utf8即可；

CREATE TABLE `user`  (
  `id` int(11) NOT NULL,
  `username` varchar(40),
  `birthday` date,
  `gender` varchar(40),
  `address` varchar(40),
  PRIMARY KEY (`id`)
) 

添加数据(添加一条简单的数据只是为了方便测试mybatis框架能否从数据库中获得数据)

INSERT INTO `user` VALUES (1, 'lin', '1997-08-17', '男', '汕头市');

4、配置全局配置文件

注：全局配置文件一般放于类路径下，即项目的resources目录下

该文件名取名为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>
    <!--环境配置-->
    <environments default="mysql">
        <!--配置数据库的环境-->
        <environment id="mysql">
            <!--配置事务类型-->
            <transactionManager type="JDBC"></transactionManager>
            <!--配置数据源（连接池）-->
            <dataSource type="POOLED">
                <!--配置连接数据库的四个基本信息-->
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <!--url中的mybatis就是数据库名称，serverTimezone是时区，没有配置时可能会抛出异常-->
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="12345"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

这里至少配置数据源用于访问数据库

5、创建对象关系模型（POJO）

创建User实体类，将数据库读取出来的数据封装给该对象

public class User {

    private Integer id;
    private String username;
    private Date birthday;
    private String gender;
    private String address;

    //以下省略了各个属性的get和set方法，以及同String方法
}

6、创建Mapper接口

Mapper接口应该放置于java目录下

文件名为UserDao.java

public interface UserDao {

    /**
     * 查询所有User对象
     */
    List<User> findAllUser();
}

7、创建Mapper接口对应的映射文件（xml）

xml文件默认放置于resources目录下；

<?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">
<!--namespace填写的是Mapper接口的全限定名-->
<mapper namespace="com.example.mybatis.dao.UserDao">
    <!--
        id必须与接口的方法名一致
        select语句会返回查询结果，所以需要配置一个resultType将查询结果赋值给对象的属性
    -->
    <select id="findAllUser" resultType="com.example.mybatis.pojo.User">
        select * FROM user
    </select>
</mapper>

注意：mapper接口和映射文件必须放置于同样结构的路径下
结构图如下

路径对比如下：

com.example.mybatis.dao.UserDao
com/example/mybatis/dao/UserDao.xml

8、全局配置文件中注册Mapper.xml映射文件

在mappers标签中进行注册

<!--指定映射文件的位置，映射配置文件指的是每个dao独立的配置文件-->
    <mappers>
        <!--采用接口加xml配置文件的方式开发dao层时，使用的是resource属性，属性值为映射文件的全限定名
        全限定名即，从类路径下到文件名的全称-->
        <mapper resource="com/example/mybatis/dao/UserDao.xml"></mapper>
    </mappers>

9、测试

public class MyBatisTest01 {
    /**
     * 测试能否成功获取数据库中的数据
     */
    @Test
    public void test01() throws IOException {
//    1、读取配置文件(从类路径下开始读取)
        InputStream in = Resources.getResourceAsStream("mybatis-config.xml");
//    2、创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        SqlSessionFactory sqlSessionFactory = builder.build(in);
//    3、使用工厂生产SqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
//    4、使用SQLSession创建Dao接口的代理对象
        UserDao userDao = sqlSession.getMapper(UserDao.class);
//    5、使用代理对象执行方法
        List<User> users = userDao.findAllUser();
        for (User user: users
                ) {
            System.out.println(user);
        }
//     6、释放资源
        sqlSession.close();
        in.close();

    }
}

如果测试结果没有报错，则说明mybatis框架搭建成！！！

注意事项

1、测试时，要确保mysql服务是否已经启动
没有启动，则出现该异常 java.net.ConnectException: Connection refused: connect
2、数据源url属性没有添加时区
报错该异常：

com.mysql.cj.exceptions.InvalidConnectionAttributeException： You must configure either the server or JDBC driver (via the 'serverTimezone' configuration property) to use a more specifc time zone value 

3、映射文件Mapper.xml中的namespace属性需要填写对应的Mapper接口的全限定类名，并且保证接口和映射文件的包结构一致；