Mybatis - 入门篇

Mybatis是什么

        mybatis是一款优秀的持久层框架，支持自定义SQL、存储过程以及高级映射。Mybatis免除了几乎所有的JDBC代码以及设置参数和获取结果集的工作。Mybatis可以通过简单的XML货注解来配置和映射原始类型、接口和JAVA pojo（Plain Old Java Objects，普通老式对象）为数据库中的记录。

        半自动的ORM框架能给灵活解决的可以指定部分数据修改保存问题，能给自定义生成SQL，可以支持动态SQL，比如分表中的表名、条件、参数变化等等。

        Mybatis的前身是ibatis，2001年开始开发，是internet和abatis两个单词的组合。04年捐赠给Apache，2010年改为mybatis。

        在Mybatis里面，SQL和代码是分离的，所有会写SQL的基本上就会用mybatis，没有额外的学习成本。

MyBatis实际案例

环境准备

创建项目

        创建一个普通的Maven项目，然后添加对应的Mybatis和MySQL的相关依赖

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.4</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.11</version>
</dependency>

POJO对象

        我们的案例通过数据库中的 T_USER 表来讲解，创建的对应的POJO对象为,有用到Lombok，大家可 以自行添加对应的依赖

@Data
public class User {
    private Integer id;
    private String userName;
    private String realName;
    private String password;
    private Integer age;
    private Integer dId;
}

添加配置文件

        在MyBatis中我们需要添加全局的配置文件和对应的映射文件。

        全局配置文件,这里面是对MyBatis的核心行为的控制

<?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>
    <properties resource="db.properties"></properties>
    <settings>
        <!-- 打印查询语句 -->
        <setting name="logImpl" value="STDOUT_LOGGING" />
        <!-- 控制全局缓存（二级缓存），默认 true-->
        <setting name="cacheEnabled" value="false"/>
        <!-- 延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。默认 false -->
        <setting name="lazyLoadingEnabled" value="true"/>
        <!-- 当开启时，任何方法的调用都会加载该对象的所有属性。默认 false，可通过select标签
        的 fetchType来覆盖-->
        <setting name="aggressiveLazyLoading" value="true"/>
        <!-- Mybatis 创建具有延迟加载能力的对象所用到的代理工具，默认JAVASSIST -->
        <!--<setting name="proxyFactory" value="CGLIB" />-->
        <!-- STATEMENT级别的缓存，使一级缓存，只针对当前执行的这一statement有效 -->
        <!--
        <setting name="localCacheScope" value="STATEMENT"/>
        -->
        <setting name="localCacheScope" value="SESSION"/>
    </settings>
    <typeAliases>
        <typeAlias alias="user" type="com.gupaoedu.domain.User" />
    </typeAliases>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/><!-- 单独使用时配置成MANAGED没有事务 -->
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>
</configuration>

关联的映射文件,通常来说一张表对应一个，我们会在这个里面配置我们增删改查的SQL语句，以及参数 和返回的结果集的映射关系。

<?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.gupaoedu.mapper.UserMapper">
    <resultMap id="BaseResultMap" type="user">
        <id property="id" column="id" jdbcType="INTEGER"/>
        <result property="userName" column="user_name" jdbcType="VARCHAR" />
        <result property="realName" column="real_name" jdbcType="VARCHAR" />
        <result property="password" column="password" jdbcType="VARCHAR"/>
        <result property="age" column="age" jdbcType="INTEGER"/>
        <result property="dId" column="d_id" jdbcType="INTEGER"/>
    </resultMap>
    <select id="selectUserById" resultMap="BaseResultMap" statementType="PREPARED">
        select * from t_user where id = #{id}
    </select>
    <!-- $只能用在自定义类型和map上 -->
    <select id="selectUserByBean" parameterType="user" resultMap="BaseResultMap">
        select * from t_user where user_name = '${userName}'
    </select>
    <select id="selectUserList" resultMap="BaseResultMap" >
        select * from t_user
    </select>
</mapper>

数据库属性的配置文件一并贴出

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatisdb?characterEncoding=utf8&serverTimezone=UTC
jdbc.username=root
jdbc.password=123456

代理方式的使用

        我们还可以通过SqlSession中提供的getMapper方法来获取声明接口的代理对象来处理。实现如下

接口声明

        我们需要声明一个Dao的接口。然后在接口中定义相关的方法。

/**
* Mapper 的接口声明
*/
public interface UserMapper {
    public List<User> selectUserList();
}

映射文件

        我们通过getMapper的方式来使用的话，我们需要添加对应的映射文件，在映射文件中我们需要将 namespace声明为上面接口的全类路径名，同时对应的sql标签的id要和方法名称一致。最后我们还有保证映射文件的名称和接口的名称要一致。在文件很多的情况能很好的管理

getMapper

        我们也可以通过getMapper方法来获取声明的Dao接口的代码对象来实现数据库操作。

/**
* MyBatis getMapper 方法的使用
*/
@Test
public void test2() throws Exception{
    // 1.获取配置文件
    InputStream in = Resources.getResourceAsStream("mybatis-config.xml");
    // 2.加载解析配置文件并获取SqlSessionFactory对象
    SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(in);
    // 3.根据SqlSessionFactory对象获取SqlSession对象
    SqlSession sqlSession = factory.openSession();
    // 4.通过SqlSession中提供的 API方法来操作数据库
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    List<User> list = mapper.selectUserList();
    for (User user : list) {
    System.out.println(user);
    }
    // 5.关闭会话
    sqlSession.close();
}

        通过执行接口方法，来执行映射器中的SQL语句。

总结

1. 使用连接池对连接进行管理
2. sql和代码分离，集中管理
3. 结果集映射
4. 参数映射和动态SQL
5. 重复SQL的提取
6. 缓存管理
7. 插件机制