MyBatis框架教程「入门起步」

Web项目聚集地

图文教程，技术交流

今天我们就踏上学习Mybatis框架的旅程，在SSM框架中Mybatis框架是dao层的一个解决方案。相当于传统Servlet+JavaBean开发模式中JDBC的作用。具体关于MVC架构的知识可以移步「从零学习Spring MVC框架「环境搭建和MVC架构」」文章，在这一篇文章的开篇我详细阐述了关于MVC架构的知识。

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs「Plain Old Java Objects,普通的 Java对象」映射成数据库中的记录，它是dao层的一个解决方案。

什么需求催生了MyBatis这种框架的产生呢？Mybatis框架比较重要的是：Mybatis自动将sql执行结果映射至java对象。我们知道目前流行的编程语言，例如Java，C#是面向对象的编程语言；但是主流的数据库产品，例如：Oracle，Mysql 等都是关系型数据库，编程语言和底层数据的发展不协调，催生出了ORM框架。

我们可以理解为ORM框架可作为面向对象语言和数据库之间的桥梁。我们将要学习的MyBatis的设计思想和ORM很相似。

1. 起步

首先将mybatis-x.x.x.jar文件置于 classpath 中即可。由于需要连接数据库我们还需要驱动包。

如果使用 Maven 来构建项目，则需将下面的 dependency 代码置于 pom.xml 文件中：

<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis</artifactId>
  <version>x.x.x</version>
</dependency>

2. 构建 SqlSessionFactory

每个基于 MyBatis 的应用都是以一个 SqlSessionFactory的实例为中心的。SqlSessionFactory的实例可以通过SqlSessionFactoryBuilder获得,关于SqlSession的介绍我们在文章末尾展开。

SqlSessionFactoryBuilder可以从 XML 配置文件或一个预先定制的 Configuration的实例构建出SqlSessionFactory的实例。

SqlSession产生的第一步就是要利用SqlSessionFactoryBuilder来获取工厂SqlSessionFactory，再获得SqlSession。

SqlSessionFactoryBuilder有五个build()方法,每一种都允许你从不同的资源中创建一个SqlSession实例。

SqlSessionFactory build(InputStream inputStream)
SqlSessionFactory build(InputStream inputStream, String environment)
SqlSessionFactory build(InputStream inputStream, Properties properties)
SqlSessionFactory build(InputStream inputStream, String env, Properties props)
SqlSessionFactorybuild(Configuration config)

以上五种 build()方法中，第一种是最常用的一种，在这里就不进行讲解。

这里我们使用：

//加载  核心配置文件
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
//创建sqlsession工厂 -->相当于connection
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
//获取sqlsession -->相当于执行sql语句对象
sqlSession = sqlSessionFactory.openSession();

3. mybatis-config.xml

XML配置文件中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源（DataSource）和决定事务作用域和控制方式的事务管理器。XML 配置文件的详细内容下方探讨，这里先给出一个简单的示例：

<?xml version="1.0"encoding="UTF-8"?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTDConfig 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
  <configuration>
  <!-- 配置环境 -->
  <environments default="jujidi">
     <environment id="jujidi">
      <transactionManager type="JDBC"></transactionManager>
      <dataSource type="POOLED">
      <property name="driver" value="com.mysql.jdbc.Driver"/>
      <property name="url" value="jdbc:mysql://localhost:3306/dbname"/>
      <property name="username" value="root"/>
      <property name="password" value="root"/>
     </dataSource>
   </environment>
 </environments>
 <!-- 加载映射文件 -->
 <mappers>
  <mapper resource="com/jujidi/test/TestMapper.xml" />
 </mappers>
</configuration>

当然，还有很多可以在XML 文件中进行配置，上面的示例指出的则是最关键的部分。要注意 XML 头部的声明，用来验证 XML 文档正确性。

environment 元素体中包含了事务管理和连接池的配置。mappers 元素则是包含一组 mapper 映射器（这些 mapper 的 XML 文件包含了 SQL 代码和映射定义信息）

关于事务管理器：在 MyBatis 中有两种类型的事务管理器

• JDBC – 这个配置就是直接使用了 JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域

• MANAGED – 这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文） 

4. TestMapper.xml

<?xml version="1.0"encoding="UTF-8"?>
<!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTDMapper 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
 <mapper namespace="com.jujidi.model.User">
 <!-- 通过id返回数据 -->
 <select id="load"resultType="map">
  select * from user where user_id=1
 </select>
</mapper>

namespace:是对此mapper 的唯一标识，通过select标签进行声明一个sql语句。

select中的id属性是在此mapper映射文件中sql语句的唯一id，我们可以通过namespace.id来定位这一条sql语句

5. MyBatisTest.java

public class MybatisTest {
 public static void main(String[] args ) {
  SqlSession sqlSession = null;
   try{
     //加载核心配置文件
     InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
     //创建sqlsession工厂 -->相当于connection
     SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
     //获取sqlsession -->相当于执行sql语句对象
     sqlSession = sqlSessionFactory.openSession();
     //执行sql
     Map<String , Object> map =  sqlSession.selectOne("com.jujidi.model.User.load");
     System.out.println(map);
    }catch(IOException e){
      // TODO Auto-generated catch block
      e.printStackTrace();
    }finally{
     if(sqlSession!=null){
     sqlSession.close();
    }
   }
 }
}

到这里环境环境搭建完毕，讲解大体流程： MyBatisTest.java类中进行测试搭建的环境，首先加载核心配置文件mybatis-config.xml，此配置文件用来配置环境参数和加载映射文件。

然后创建sqlsession工厂，这个工厂就要通过刚刚加载的mybatis-config.xml配置文件来build。通过工厂就可以生产sqlsession了，sqlsession有很多方法，我们执行selectOne方法来执行映射文件中的SQL，这就必须在selectOne方法中填写映射文件中对应SQL的地址，也就是全限定类名来定位。

在映射文件中进行操作数据库把结果进行返回，打印输出。

好了这里差不多把环境搭建完毕后的流程走了一遍，算是对MyBatis的一个入门和起步，接下来我们就来谈一下SqlSessionFactory和SqlSession.

6. SqlSessionFactory和SqlSession

SqlSessionFactory是MyBatis非常重要的对象，他是单个数据库映射关系经过编译后的内存镜像。

SqlSessionFactory的实例可以通过SqlSessionFactoryBuilder对象来获得，而SqlSessionFactoryBuilder从XML配置文件等中构建出SqlSessionFactory的实例。SqlSessionFactory一旦创建，在应用的执行期间都存在，其线程也是安全的。

SqlSession类似于JDBC中的Connection。它是应用程序与持久层之间执行交互操作的一个单线程对象。它底层封装了JDBC连接，线程是不安全的。

如果您觉得此平台教程不错的话，欢迎分享和点赞，您的转发是我最大的动力！

推荐阅读

1. 从零学习Spring MVC框架

2. JavaWeb项目部署到Linux云服务器

3. SSM框架开发「内容管理系统」

4. Linux养成计划（一）

欢迎您的转发和点赞

▲长按关注我们