SSM06 —— MyBatis基础

本文记录了MyBatis的基础知识，包括映射文件，增删改查操作，核心配置文件概述和基本的API介绍

MyBatis简介

原始JDBC操作的分析

查询：

插入：

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

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

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

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

什么是MyBatis

官网地址

• mybatis 是一个优秀的基于java的持久层框架，它内部封装了jdbc，使开发者只需要关注sql语句本身，而不需要花费精力去处理加载驱动、创建连接、创建statement等繁杂的过程。
• mybatis通过xml或注解的方式将要执行的各种 statement配置起来，并通过java对象和statement中sql的动态参数进行映射生成最终执行的sql语句。
• 最后mybatis框架执行sql并将结果映射为java对象并返回。采用ORM思想解决了实体和数据库映射的问题，对jdbc 进行了封装，屏蔽了jdbc api 底层访问细节，使我们不用与jdbc api打交道，就可以完成对数据库的持久化操作。

MyBatis开发简单演示

MyBatis开发步骤：

• 导入MyBatis的坐标和其他相关坐标

  <!--mysql驱动坐标-->
  <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.32</version>
  </dependency>
  <!--mybatis坐标-->
  <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.4.6</version>
  </dependency>
  <!--单元测试坐标-->
  <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
  </dependency>
  <!--日志坐标-->
  <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>1.2.17</version>
  </dependency>

• 创建user数据表

  包含三个属性：id int， username varchar(32), password varchar(32)

• 编写User实体类

  public class User {
  
      private int id;
      private String username;
      private String password;
  
  	//省略get set 以及 toString方法
  }

• 编写映射文件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="user">
          select * from 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>
  
      <!--通过properties标签加载外部properties文件-->
      <properties resource="jdbc.properties"></properties>
  
      <!--自定义别名，注意要写在前面-->
      <typeAliases>
          <typeAlias type="com.itheima.domain.User" alias="user"></typeAlias>
      </typeAliases>
  
      <!--数据源环境-->
      <environments default="development">
          <environment id="development">
              <!--事务管理器使用JDBC-->
              <transactionManager type="JDBC"></transactionManager>
              <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="com/itheima/mapper/UserMapper.xml"></mapper>
      </mappers>
  
  </configuration>

• 编写测试类

  @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> userList = sqlSession.selectList("userMapper.findAll");
      //打印数据
      System.out.println(userList);
      //释放资源
      sqlSession.close();
  }

MyBatis的映射文件概述

MyBatis的增删改查操作

插入操作

编写UserMapper映射文件

<mapper namespace="userMapper">
    <!--插入操作-->
    <insert id="save" parameterType="com.itheima.domain.User">
        insert into user values(#{id},#{username},#{password})
    </insert>
</mapper>

编写插入实体User的代码：

//插入操作
public void test2() throws IOException {
    //模拟user对象
    User user = new User();
    user.setUsername("xxx");
    user.setPassword("abc");

    //获得核心配置文件
    InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
    //获得session工厂对象
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
    //获得session会话对象
    SqlSession sqlSession = sqlSessionFactory.openSession(true);
    //执行操作  参数：namespace+id
    sqlSession.insert("userMapper.save",user);

    //mybatis执行更新操作  提交事务
    //sqlSession.commit();

    //释放资源
    sqlSession.close();
}

插入操作注意问题

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

修改操作

编写UserMapper映射文件

<mapper namespace="userMapper">
    <!--修改操作-->
    <update id="update" parameterType="com.itheima.domain.User">
        update user set username=#{username},password=#{password} where id=#{id}
    </update>
</mapper>

编写修改实体User的代码：

//修改操作
public void test2() throws IOException {
    //模拟user对象
    User user = new User();
    user.setId(7);
    user.setUsername("lucy");
    user.setPassword("123");

    //获得核心配置文件
    InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
    //获得session工厂对象
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
    //获得session会话对象
    SqlSession sqlSession = sqlSessionFactory.openSession();
    //执行操作  参数：namespace+id
    sqlSession.update("userMapper.update",user);

    //mybatis执行更新操作  提交事务
    sqlSession.commit();

    //释放资源
    sqlSession.close();
}

修改操作注意问题

• 修改语句使用update标签

• 修改操作使用的API是sqlSession.update(“命名空间.id”,实体对象);

删除操作

编写UserMapper映射文件

<mapper namespace="userMapper">
    <!--删除操作-->
    <delete id="delete" parameterType="int">
        delete from user where id=#{abc}
    </delete>
</mapper>

编写删除实体User的代码：

//删除操作
public void test2() throws IOException {
    //获得核心配置文件
    InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
    //获得session工厂对象
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
    //获得session会话对象
    SqlSession sqlSession = sqlSessionFactory.openSession();
    //执行操作  参数：namespace+id
    sqlSession.delete("userMapper.delete",8);

    //mybatis执行更新操作  提交事务
    sqlSession.commit();

    //释放资源
    sqlSession.close();
}

删除操作注意问题

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

MyBatis的核心配置文件概述

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 类型设置一个短的名字。原来的类型名称配置如下

  

  MyBatis框架已经为我们设置好的一些常用的类型的别名

  

MyBatis的相应API

SqlSession工厂构建器SqlSessionFactoryBuilder

常用API：SqlSessionFactory build(InputStream inputStream)

通过加载mybatis的核心文件的输入流的形式构建一个SqlSessionFactory对象

String resource = "org/mybatis/builder/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
SqlSessionFactory factory = builder.build(inputStream);

其中， Resources 工具类，这个类在 org.apache.ibatis.io 包中。Resources 类帮助你从类路径下、文件系统或一个 web URL 中加载资源文件。

SqlSession工厂对象SqlSessionFactory

SqlSessionFactory 有多个个方法创建 SqlSession 实例。常用的有如下两个：

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()