搭建MyBatis

开发环境

• IDE: IDEA 2021.3
• 构建工具: Maven 3.8.4
• MySQL版本: MySQL 8.0.27
• MyBatis版本: MyBatis 3.5.7

创建Maven工程

打包方式

<packaging>jar</packaging>

引入依赖

<dependencies>
    <!-- MyBatis核心 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>
    
    <!-- MySQL驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.27</version>
    </dependency>
    
    <!-- junit测试 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>

创建MyBatis的核心配置文件

习惯上命名为 mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求。将来整合 Spring 之后，这个配置文件可以省略。

核心配置文件主要用于配置连接数据库的环境以及 MyBatis 的全局配置信息。

核心配置文件存放的位置是 src/main/resources 目录下。

<?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/mybatis"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    
    <!-- 引入映射文件 -->
    <mappers>
        <mapper resource="mappers/UserMapper.xml"/>
    </mappers>
</configuration>

创建Mapper接口

MyBatis 中的 Mapper 接口相当于以前的 DAO。但是区别在于，Mapper 仅仅是接口，我们不需要写实现类。

public interface UserMapper {
    /**
     * 添加用户信息
     */
    int insertUser();
}

创建MyBatis的映射文件

ORM概念

ORM（Object Relationship Mapping）对象关系映射：

• 对象：Java 的实体类对象
• 关系：关系型数据库
• 映射：二者之间的对应关系

映射文件的命名规则

表所对应的实体的类名 + Mapper.xml

例如：表 t_user，映射的实体类为 User，所对应的映射文件为 UserMapper.xml

因此一个映射文件用于编写 SQL，访问以及操作表中的数据。

MyBatis 映射文件存放的位置是 src/main/resources/mappers 目录下。

两个一致

MyBatis 中可以面向接口操作数据，要保证两个一致：

1. Mapper 接口的全类名和映射文件的**命名空间（namespace）**保持一致
2. Mapper 接口中方法的方法名和映射文件中编写 SQL 的标签的 id 属性保持一致

<?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.example.mapper.UserMapper">
    <!-- int insertUser(); -->
    <insert id="insertUser">
        insert into t_user values(null, 'admin', '123456', 23, '男', '123@qq.com')
    </insert>
</mapper>

通过junit测试功能

核心概念

• SqlSession：代表 Java 程序和数据库之间的会话（HttpSession 是 Java 程序和浏览器之间的会话）
• SqlSessionFactory：是生产 SqlSession 的工厂

工厂模式：如果创建某个对象，使用的过程基本固定，那么我们就可以把创建这个对象的相关代码封装到一个"工厂类"中，以后都可以使用这个工厂类来"生产"我们需要的对象。

测试代码

@Test
public void testMyBatis() throws IOException {
    // 加载核心配置文件
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    // 获取SqlSessionFactoryBuilder
    SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
    // 获取SqlSessionFactory
    SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
    // 获取SqlSession
    SqlSession sqlSession = sqlSessionFactory.openSession(true); // true表示自动提交事务
    // 获取mapper接口对象
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    // 测试功能
    int result = mapper.insertUser();
    System.out.println("result: " + result);
}

加入log4j日志功能

添加依赖

<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

添加log4j配置文件

在 src/main/resources 目录下创建 log4j.xml：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
        <param name="Encoding" value="UTF-8"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n"/>
        </layout>
    </appender>
    <logger name="java.sql">
        <level value="debug"/>
    </logger>
    <logger name="org.apache.ibatis">
        <level value="info"/>
    </logger>
    <root>
        <level value="debug"/>
        <appender-ref ref="STDOUT"/>
    </root>
</log4j:configuration>

日志级别

FATAL(致命) > ERROR(错误) > WARN(警告) > INFO(信息) > DEBUG(调试)

从左到右打印的内容越来越详细。