Mybatis系列之——快速入门

1、mybatis简介

1.1、原始jdbc操作

查询数据：

插入数据：

1.2、 原始jdbc操作的分析

原始jdbc开发存在的问题如下：

• ① 数据库连接创建、释放频繁造成系统资源浪费从而影响系统性能
• ② sql 语句在代码中硬编码，造成代码不易维护，实际应用 sql 变化的可能较大，sql 变动需要改变java代码。
• ③ 查询操作时，需要手动将结果集中的数据手动封装到实体中。插入操作时，需要手动将实体的数据设置到sql语句的占位符位置

应对上述问题给出的解决方案：

• ① 使用数据库连接池初始化连接资源
• ② 将sql语句抽取到xml配置文件中
• ③ 使用反射、内省等底层技术，自动将实体与表进行属性与字段的自动映射

1.3 、什么是Mybatis

• MyBatis 是一款优秀的持久层框架
• 它支持定制化 SQL、存储过程以及高级映射。
• MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。
• MyBatis 可以使用简单的 XML 或注解来配置和映射原生类型、接口和 Java 的 POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。
• MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。
• 2013年11月迁移到Github。

mybatis 是一个优秀的基于java的持久层框架，它内部封装了jdbc，使开发者只需要关注sql语句本身，而不需要花费精力去处理加载驱动、创建连接、创建statement等繁杂的过程。

mybatis通过xml或注解的方式将要执行的各种 statement配置起来，并通过java对象和statement中sql的动态参数进行映射生成最终执行的sql语句。

最后mybatis框架执行sql并将结果映射为java对象并返回。采用ORM思想解决了实体和数据库映射的问题，对jdbc 进行了封装，屏蔽了jdbc api 底层访问细节，使我们不用与jdbc api打交道，就可以完成对数据库的持久化操作。

1.4、Mybatis开发步骤

如何获得Mybatis？

• maven仓库：

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

• Github ： https://github.com/mybatis/mybatis-3/releases

• 中文文档：https://mybatis.org/mybatis-3/zh/index.html

MyBatis开发步骤：

• 添加MyBatis依赖
• 创建user数据表
• 编写User实体类
• 编写映射文件UserMapper.xml
• 编写核心文件SqlMapConfig.xml
• 编写测试类

环境搭建：

<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.25</version>
    </dependency>

    <!--单元测试坐标-->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
    </dependency>

    <!--日志坐标-->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
</dependencies>

创建user表：

编写实体类：

public class User {

    private int id;
    private String username;
    private String password;
    private String perm;

    //省略get/set方法
}

编写UserMapper.xml映射文件：

<?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="userMapper" >
    <select id="findAll" resultType="com.spongebob.pojo.User">
        select * from mybatis.user;
    </select>
</mapper>

编写sqlMapConfig.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"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="admin"/>
            </dataSource>
        </environment>
    </environments>

    <!--加载映射文件-->
    <mappers>
        <mapper resource="com/spongebob/mapper/UserMapper.xml"></mapper>
    </mappers>
</configuration>

编写测试代码：

public class Test {

    @org.junit.Test
    public void test1() throws IOException {
        
        //获得核心配置文件
        InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
        //获得session工厂对象
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
        //获得session会话对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //执行操作  参数：namespace+id
        List<User> list = sqlSession.selectList("userMapper.findAll");

        System.out.println(list);
        //释放资源
        sqlSession.close();
    }
}

1.5、Mybatis的映射文件

1.6、Mybatis的增删改查操作

1.6.1、编写UserMapper映射文件

<mapper namespace="userMapper" >
    <select id="findAll" resultType="com.spongebob.pojo.User">
        select * from mybatis.user
    </select>

    <insert id="add" parameterType="com.spongebob.pojo.User">
        insert into mybatis.user values(#{id},#{username},#{password},#{perm})
    </insert>

    <update id="update" parameterType="com.spongebob.pojo.User">
        update mybatis.user set username=#{username},password=#{password} where id=#{id}
    </update>

    <delete id="delete" parameterType="java.lang.Integer">
        delete from user where id=#{id}
    </delete>
</mapper>

插入操作测试：

@org.junit.Test
public void testAdd() throws IOException {
    User user = new User(5,"tutu@qq.com","123","add");
    InputStream resourceAsStream = Resources.getResourceAsStream("SqlMapConfig.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
    SqlSession sqlSession = sqlSessionFactory.openSession();
    int insert = sqlSession.insert("userMapper.add", user);
    System.out.println(insert);
    //提交事务
    sqlSession.commit();
    sqlSession.close();

}

插入操作注意问题

• 插入语句使用insert标签
• 在映射文件中使用parameterType属性指定要插入的数据类型
• Sql语句中使用#{实体属性名}方式引用实体中的属性值
• 插入操作使用的API是sqlSession.insert("命名空间.id",实体对象);
• 插入操作涉及数据库数据变化，所以要使用sqlSession对象显示的提交事务，即sqlSession.commit()

更新操作测试：

@org.junit.Test
public void testUpdate() throws IOException {
    User user = new User(5,"tutu@qq.com","23456","add");
    InputStream resourceAsStream = Resources.getResourceAsStream("SqlMapConfig.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
    SqlSession sqlSession = sqlSessionFactory.openSession();
    int update = sqlSession.update("userMapper.update", user);
    System.out.println(update);
    sqlSession.commit();
    sqlSession.close();

}

修改操作注意问题

• 修改语句使用update标签
• 修改操作使用的API是sqlSession.update("命名空间.id",实体对象);

删除操作测试：

@org.junit.Test
public void testDelete() throws IOException {
    InputStream resourceAsStream = Resources.getResourceAsStream("SqlMapConfig.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
    SqlSession sqlSession = sqlSessionFactory.openSession();
    int delete = sqlSession.delete("userMapper.delete",3);
    System.out.println(delete);
    sqlSession.commit();
    sqlSession.close();
    
}

删除操作注意问题

• 删除语句使用delete标签
• Sql语句中使用#{任意字符串}方式引用传递的单个参数
• 删除操作使用的API是sqlSession.delete("命名空间.id",Object);

1.7、Mybatis核心配置文件

1.7.1、MyBatis核心配置文件层级关系

1.7.2、MyBatis常用配置解析

environments标签：

数据库环境的配置，支持多环境配置

其中，事务管理器（transactionManager）类型有两种：

• JDBC：这个配置就是直接使用了JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域。
• MANAGED：这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如JEE 应用服务器的上下文）。 默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 false 来阻止它默认的关闭行为。

其中，数据源（dataSource）类型有三种：

• UNPOOLED：这个数据源的实现只是每次被请求时打开和关闭连接。
• POOLED：这种数据源的实现利用"池"的概念将 JDBC 连接对象组织起来。
• JNDI：这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用

mapper标签:

该标签的作用是加载映射的，加载方式有如下几种：

• 使用相对于类路径的资源引用，例如：<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
• 使用完全限定资源定位符（URL），例如：<mapper url="file:///var/mappers/AuthorMapper.xml"/>
• 使用映射器接口实现类的完全限定类名，例如：<mapper class="org.mybatis.builder.AuthorMapper"/>
• 将包内的映射器接口实现全部注册为映射器，例如：<package name="org.mybatis.builder"/>

Properties标签:

实际开发中，习惯将数据源的配置信息单独抽取成一个properties文件，该标签可以加载额外配置的properties文件。

typeAliases标签：

类型别名是为Java 类型设置一个短的名字。原来的类型名称配置如下

配置typeAliases，为com.spongebob.pojo.User定义别名为user

<typeAliases>
    <typeAlias type="com.spongebob.pojo.User" alias="user"></typeAlias>
</typeAliases>

上面我们是自定义的别名，mybatis框架已经为我们设置好的一些常用的类型的别名

1.8、MyBatis相应API

1.8.1、 SqlSession工厂对象SqlSessionFactory

SqlSessionFactory 有多个个方法创建 SqlSession 实例。

常用的有如下两个：

1.8.2、SqlSession会话对象

SqlSession 实例在 MyBatis 中是非常强大的一个类。在这里你会看到所有执行语句、提交或回滚事务和获取映射器实例的方法。

执行语句的方法主要有：

<T> T selectOne(String statement, Object parameter) 
<E> List<E> selectList(String statement, Object parameter) 
int insert(String statement, Object parameter) 
int update(String statement, Object parameter) 
int delete(String statement, Object parameter)

操作事务的方法主要有：

void commit()
void rollback()