[Java知识库]SSM框架之Mybatis——Mybatis入门

目录

一、Mybatis的简介

1.1原始JDBC操作缺点及改进方向

1.2Mybatis简介

1.3Mybatis快速入门

二、MyBatis的映射文件概述

三、MyBatis的增删改查操作

3.1插入数据

3.2修改数据

3.3删除数据

四、MyBatis的核心配置文件概述

4.1MyBatis核心配置文件层级关系

4.2MyBatis常用配置解析

五、MyBatis的相应API

5.1SqlSession工厂构建器SqlSessionFactoryBuilder

5.2SqlSession工厂对象SqlSessionFactory

5.3SqlSession会话对象

一、Mybatis的简介

1.1原始JDBC操作缺点及改进方向

首先我们一起来看看原始的JDBC操作数据库的一般步骤，

Class.forName("com.mysql.jdbc.Diver");//注册驱动
Connection connection=DriverManager.getConnection("jdbc:mysql:///mydb1","root","3837");//获得数据库连接
PreparedStatement statement=connection.prepareStatement("select id,username,password from user");//获得statement对象
ResultSet resultSet=statement.executeQuery();//执行查询
while (resultSet.next()){//遍历结果集，对数据进行实体封装
    User user=new User();
    user.setId(resultSet.getInt("id"));
    user.setUsername(resultSet.getInt("username"));
    user.setPassword(resultSet.getInt("password"));
    System.out.println(user);
}
resultSet.close();//关闭资源
statement.close();
connection.close();

从上述代码我们可以看出原始的jdbc开发存在很多问题：

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

针对上述这些问题，我们可以通过以下思路进行改进，

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

1.2Mybatis简介

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

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

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

详细官方文档请见Mybatis官网。?

1.3Mybatis快速入门

使用Mybatis作为持久层进行开发时，其主要开发步骤如下：

1. 添加MyBatis的坐标
2. 创建user数据表
3. 编写User实体类?
4. 编写映射文件UserMapper.xml（配置sql语句）
5. 编写核心配置文件SqlMapConfig.xml（Mybatis的核心配置）
6. 编写测试类

第一步我们添加Mybatis的坐标，同时导入一些必要的其他依赖包坐标，

<dependencies>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.32</version>
    </dependency>
    <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>
</dependencies>

第二步在数据库中创建user表，填入一些数据（这里我们使用mydb1数据库中的user表）

第三步我们在工程中创建User实体类，生成好get和set方法，为了方便打印也重写toString方法，

class User {
    private int id;
    private String username;
    private String password;

    //省略了set、get方法和toString方法
}

第四步我们编写映射文件UserMapper.xml，在里面写好sql语句。首先在资源文件目录下新建Mapper目录，里面创建UserMapper.xml，导入mapping文件约束头，并指定映射关系。

<?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">

<!--指定sql语句的命名空间-->
<mapper namespace="userMapper">
    <!--对当前sql语句指定一个id名称，返回结果集的类型为User-->
    <select id="findAll" resultType="Domain.User">
        select * from user
    </select>
</mapper>

第五步我们编写核心文件SqlMapConfig.xml，对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>
    <!--配置数据源环境，default指定使用的默认环境-->
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mydb1"/>
                <property name="username" value="root"/>
                <property name="password" value="3837"/>
            </dataSource>
        </environment>
    </environments>

    <!--加载映射文件-->
    <mappers>
        <mapper resource="Mapper/UserMapper"/>
    </mappers>
</configuration>

第六步我们创建测试类，进行测试，

@Test//测试利用Mybatis进行数据库操作
public void test1() throws IOException {
    InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");//获取核心配置文件
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);//获得session工厂对象
    SqlSession sqlSession=sqlSessionFactory.openSession();//获得session会话对象
    List<Object> userList = sqlSession.selectList("userMapper.findAll");//执行操作，参数：namespace+id
    System.out.println(userList);//打印数据
    sqlSession.close();//释放资源
}

运行可以看到用户数据被正确打印出来了：?

二、MyBatis的映射文件概述

三、MyBatis的增删改查操作

查询操作我们在快速入门中已经实现了，接下来我们看看如何利用MyBatis进行增删改操作。

3.1插入数据

第一步我们要在UserMapper.xml中配置sql语句和对应的id号，

<!--指定sql语句的命名空间-->
<mapper namespace="userMapper">       
        <!--插入操作-->
        <insert id="insertUser" parameterType="Domain.User">
                insert into user(id,username,password) values (#{id},#{username},#{password})
        </insert>
</mapper>

注意这里我们传入的参数类型是User对象，在sql语句中通过"#{}"来取对象的属性，

第二步我们创建测试方法进行测试，

@Test//测试利用Mybatis进行添加数据操作
public void test2() throws IOException {
    InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");//获取核心配置文件
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);//获得session工厂对象
    SqlSession sqlSession=sqlSessionFactory.openSession();//获得session会话对象
    sqlSession.insert("userMapper.insertUser",new User(4,"add","123"));//执行操作，参数：namespace+id，后面是要添加的对象
    sqlSession.commit();//MyBatis如果需要更新数据，需要手动提交事务（默认是不提交的）
    sqlSession.close();//释放资源
}

打开数据库可以看到数据表中的数据已经被添加了，

在执行插入操作时，有以下几点注意事项：

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

3.2修改数据

第一步我们还是在UserMapper.xml中配置sql修改语句和对应的id，

<!--指定sql语句的命名空间-->
<mapper namespace="userMapper">
        <!--修改操作-->
        <update id="updateUser" parameterType="Domain.User">
                update user set username=#{username},password=#{password} where id=#{id}
        </update>
</mapper>

第二步我们创建测试方法进行测试，

@Test//测试利用Mybatis进行数据修改操作
public void test3() throws IOException {
    InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");//获取核心配置文件
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);//获得session工厂对象
    SqlSession sqlSession=sqlSessionFactory.openSession();//获得session会话对象
    sqlSession.update("userMapper.updateUser",new User(4,"update","321"));//执行操作，参数：namespace+id，后面是要更新的对象数据
    sqlSession.commit();//MyBatis如果需要更新数据，需要手动提交事务（默认是不提交的）
    sqlSession.close();//释放资源
}

我们运行就可以发现数据库中的数据已经被修改了，

在执行修改操作时，有以下几点注意事项：

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

3.3删除数据

第一步我们还是在UserMapper.xml中配置sql删除语句和对应的id，

<!--指定sql语句的命名空间-->
<mapper namespace="userMapper">
        <!--删除操作-->
        <delete id="deleteUser" parameterType="java.lang.Integer">
                delete from user where id=#{id}
        </delete>
</mapper>

?第二步我们创建测试方法进行测试，

@Test//测试利用Mybatis进行数据删除操作
public void test4() throws IOException {
    InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");//获取核心配置文件
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);//获得session工厂对象
    SqlSession sqlSession=sqlSessionFactory.openSession();//获得session会话对象
    sqlSession.delete("userMapper.deleteUser",4);//执行操作，参数：namespace+id，后面是要删除的id
    sqlSession.commit();//MyBatis如果需要更新数据，需要手动提交事务（默认是不提交的）
    sqlSession.close();//释放资源
}

我们运行就可以发现id=4的数据被删除了，

在执行删除操作时，有以下几点注意事项：

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

四、MyBatis的核心配置文件概述

在快速入门中，我们通过MyBatis的核心配置文件配置了数据源的环境，给定了连接数据库的参数，并且还通过核心配置文件加载了映射文件（包含了不同的sql语句），接下来我们学习一下这个MyBatis的核心配置文件。

4.1MyBatis核心配置文件层级关系

MyBatis的核心配置文件是通过configuration标签进行配置的，其中有以下属性可供配置：

• configuration：配置
  • properties：属性
  • settings：设置
  • typeAliases：类型别名
  • typeHandlers：类型处理器
  • objectFactory：对象工厂
  • plugins：插件
  • environments：环境
    • environment：环境变量
      • transactionManager：事务管理器
      • dataSource：数据源
  • databaseIdProvider：数据库厂商标识
  • mappers：映射器

4.2MyBatis常用配置解析

1、environments标签

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

• 事务管理器（transactionManager）类型有两种：
  • JDBC：这个配置就是直接使用了JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域。
  • MANAGED：这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 false 来阻止它默认的关闭行为。
• 数据源（dataSource）类型有三种：
  • UNPOOLED：这个数据源的实现只是每次被请求时打开和关闭连接。
  • POOLED：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来。
  • JNDI：这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。
    ?

2、mapper标签

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

• 使用相对于类路径的资源引用（我们一般放在resources文件夹下，即相对resources的路径）
  • 例如：<mapper resource="Mapper/UserMapper.xml"/>
• 使用完全限定资源定位符（URL）
  • 例如：<mapper url="file:///var/mappers/UserMapper.xml"/>
• 使用映射器接口实现类的完全限定类名（加载指定的映射器实现）
  • 例如：<mapper class="org.mybatis.builder.AuthorMapper"/>
• 将包内的映射器所有接口实现全部注册为映射器（包内的所有映射器实现都加载）
  • 例如：<package name="org.mybatis.builder"/>
    ?

3、Properties标签

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

?这样就可以提高代码的解耦性，将数据库的配置信息单独出来了。

4、typeAliases标签

类型别名是为Java 类型设置一个短的名字。简单来说就是给比较长的名字起一个短一点的绰号。

假设原来的类型名称配置如下：

<select id="findAll" resultType="Domain.User">
        select * from user
</select>

这里我们执行的查询操作，结果集的类型石Domain.User类，我们可以利用typeAliases标签对这个名称进行简化，最后使用简化的名称。（注意typeAliases的标签在核心配置文件中的放置顺序，要按照4.1中的文件层级顺序进行放置，否则会报错）

<!--自定义别名-->
<typeAliases>
    <!--对Domain.User进行简化，简化后的别名为user-->
    <typeAlias type="Domain.User" alias="user"/>
</typeAliases>

接着我们就可以在映射文件中使用该别名user，

<select id="findAll" resultType="user">
        select * from user
</select>

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

五、MyBatis的相应API

5.1SqlSession工厂构建器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 中加载资源文件。

5.2SqlSession工厂对象SqlSessionFactory

获得了SqlSessionFactory工厂对象，我们就可以利用工厂对象去创建SqlSession实例，常用的创建方法有如下两种：

5.3SqlSession会话对象

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