MyBatis框架学习

初学MyBatis

---

1. 理解MyBatis的概念以及优点特性
2. 理解核心类的作用域和生命周期
3. 了解MyBatis与JDBC、Hibernate的区别
4. 掌握配置文件结构内容
5. 搭建MyBatis环境

MyBati的前身是iBatis,本是Apache的一个开源项目

MyBatis是一个数据持久层（ORM Object Relational Mapping）框架，把实体类和SQL语句之间建立了映射关系，是一种半自动化的ORM实现

MyBatis小巧，简单易学

• 其余SQL语法，简单易学
• 能了解底层组装过程
• SQL语句封装在配置文件中，便于统一管理与维护，降低了程序的耦合度
• 程序调试方便

使用MyBatis的开发步骤

1. 下载需要的Mybatis.jar包
2. 部署MyBatis.jar包
3. 编写MyBatista配置文件
4. 创建实体类和DAO接口
5. 创建SQL映射文件
6. 创建DAO接口的实现类
7. 编写测试类进行测试

需求说明

搭建MyBatis开发环境，实现用户表记录输的查询

1. 在MyEclipse中创建工程，导入MyBatis的jar包
2. 创建MyBatis配置文件mybatis-config.xml,配置数据库信息
3. 编写实体类User和UserMapper接口
4. 配置映射文件UserMapper.xml
5. 实现UserImp1

在项目中resource file文件夹，创建MyBatis配置文件mybatis-config.xml和jdbc.properties,配置数据库信息。

<?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">  <!-- 通过这次配置文件，完成mybatis与数据库的连接 -->  <configuration>    <!-- 引入jdbc.proerties -->    <properties resource="jdbc.properties"/>    <typeAliases>       <!-- 取个别名 在usermapper.xml中parameterType直接用cn.pojo中的类名 -->     <package name="cn.pojo"/>    </typeAliases>      <environments default="develoment">        <environment id="develoment">            <!-- 配置事务管理采用JDBC -->            <transactionManager type="JDBC" />            <!-- POOLED:mybatis的数据源 JNDI:基于tomcat的数据源 -->            <dataSource type="POOLED">                <property name="driver" value="${driver}" />                <property name="url" value="${url}" />                <property name="username" value="${username}" />                <property name="password" value="${password}" />            </dataSource>        </environment>    </environments>    <!-- 将mapper文件加入到配置文件中 -->    <mappers>        <mapper resource="cn/dao/UserMapper.xml"/>    </mappers></configuration>

在resources file创建jdbc.properties文件，在mybatis-config.xml中configuration节点进行引用（注意引用在environments前面否则出错）。

driver=com.mysql.jdbc.Driverurl=jdbc:mysql://127.0.0.1:3306/studentusername=rootpassword=wugen199711

创建并配置核心映射文件cn.dao.UserMapper.xml,将mapper文件配置到mybatis-config.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="cn.dao.UserMapper">    <select id="count" resultType="int">        select count(1) from user;    </select></mapper>

创建一个Junit UserTest来测试

package cn.test;import static org.junit.Assert.*;    import java.io.IOException;import java.io.InputStream;    import org.apache.ibatis.io.Resources;import org.apache.ibatis.session.SqlSession;import org.apache.ibatis.session.SqlSessionFactory;import org.apache.ibatis.session.SqlSessionFactoryBuilder;import org.apache.log4j.Logger;import org.junit.Test;public class UserTest {    private Logger logger = Logger.getLogger(UserTest.class);    @Test    public void test() {        String resource = "mybatis-config.xml";        int count = 0;        SqlSession sqlSession = null;               try {            //读取配置文件（mybatis-config.xml）的输入流            InputStream is = Resources.getResourceAsStream(resource);            //创建sqlsessionfactory对象，完成配置文件            SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);            //创建SqlSession             sqlSession = factory.openSession();            //调用mapper文件进行数据操作（调用之前,mapper要配置到mybatis-config.xml中）            count = sqlSession.selectOne("cn.dao.UserMapper.count");            logger.debug("------> "+count);        } catch (IOException e) {                       e.printStackTrace();        } finally{            sqlSession.close();        }           }}

MyBatis基本要素

• MyBatis的核心对象
• configuration.xml 全局配置文件
• mapper.xml 核心映射文件

核心对象

1. SqlSessionFactoryBuilder
2. SqlSessionFactory(单例)
3. SqlSession

注意：理解MyBatis核心对象的不同范围和生命周期是很重要的，不正确的使用他们会导致严重的并发问题。

SqlSessionFactoryBuilder

• 用过及丢，其生命周期只存在于方法体内
• 可重用SqlSessionFactorBuilder来创建多个SqlSessionFactory实例

• SqlSessionFactoryBuider类负责构建SqlSessionFactory,并且提供了多个build的重载方法

  配置信息以三种形式供给SqlSessionFactory的build方法：InputStream(字节流)、Reader(字符流)、Configuration(类)。

• 构建一个SqlSessionFactory的两种方式：

  1. 读取XML文件构造方式

  2. 编程构造方式

     读取XML文件构造方式//读取配置文件（mybatis-config.xml）的输入流InputStream is = Resources.getResourceAsStream(resource);//创建sqlsessionfactory对象，完成配置文件SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);//创建SqlSession sqlSession = factory.openSession();

SqlSessionFactory

• SqlSessionFactory是每个MyBatis应用的核心
• 单例，存在整合应用运用时，并且同时只存在一个实例对象

SqlSession

• 包含了执行sql所需的所有方法，可以通过SqlSession实例直接运行映射的sql语句
• SQLSession对应着一次数据库会话，他的生命周期不是永久的，在每次访问数据库时需要创建它
• 每个线程都有自己的SqlSession实例，SqlSession实例是不能被共享，也不是线程安全的

注意： 并不是说在SqlSession里只能执行一次sql，你可以执行多次，当一旦关闭了SqlSession就需要重新创建它。关闭SqlSession是非常重要，你必须要确保SqlSession在finally方法体中正常关闭。

SqlSessionFactory的openSession方法：SqlSession session = sqlSessionFactory.openSession();try{    //do work}finally{    session.close();}

SqlSession的获取与使用

• SqlSession的获取方式

  String resource = "mybatis-config.xml";InputStream is = Resources.getResourceAsStream(resource);SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(is);sqlSession = factory.openSession();

• SqlSession的使用
  调用insert,update,selectList,selectOne,delete等方法执行增、删、查、改等操作。

使用MyBatis框架进行操作数据库

在cn.dao包中创建UserMapper接口，接口里的方法映射到了UserMapper.xml中。

package cn.dao;import java.util.List;import cn.pojo.User;public interface UserMapper {    public int count();    public void insert(User user);    public void update(User user);    public void delete(User user);    public List<User> getUserList();}

配置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="cn.dao.UserMapper">    <select id="count" resultType="int">        select count(1) from user;    </select>    <insert id="insert" parameterType="User">        insert into user        value(#{id},#{userCode},#{userName},#{userPassword});    </insert>    <update id="update" parameterType="User">        update user set        userCode=#{userCode},userName=#{userName},userPassword=#{userPassword}        where id=#{id}    </update>    <delete id="delete" parameterType="User">        delete from user where        id=${id}    </delete>    <select id="getUserList" resultType="User">        select * from user    </select></mapper>

创建一个Junit UserTest来测试

package cn.test;import static org.junit.Assert.*;import java.util.List;import org.apache.ibatis.session.SqlSession;import org.apache.log4j.Logger;import org.junit.Test;import cn.dao.UserMapper;import cn.pojo.User;import cn.util.MyBatisUtil;public class UserDaoTestByMapper {    private Logger logger = Logger.getLogger(getClass());    @Test    public void countTest() {        SqlSession session = null;        int count = 0;        try {            session = MyBatisUtil.createSqlSession();            // count = session.selectOne("cn.dao.UserMapper.count");            count = session.getMapper(UserMapper.class).count();            logger.debug("--->" + count);        } catch (Exception e) {            session.rollback();        } finally {            MyBatisUtil.closeSqlSession(session);        }    }    @Test    public void insertTest() {        SqlSession session = null;        User user = new User(6, "T06", "wg", "123");        try {            session = MyBatisUtil.createSqlSession();            // session.insert("cn.dao.UserMapper.insert", user);            session.getMapper(UserMapper.class).insert(user);            session.commit();        } catch (Exception e) {            session.rollback();        } finally {            MyBatisUtil.closeSqlSession(session);        }    }    @Test    public void updateTest() {        SqlSession session = null;        User user = new User(5, "1506030139", "wg", "199711");        try {            session = MyBatisUtil.createSqlSession();            // session.update("cn.dao.UserMapper.update", user);            session.getMapper(UserMapper.class).update(user);            session.commit();        } catch (Exception e) {            session.rollback();        } finally {            MyBatisUtil.closeSqlSession(session);        }    }    @Test    public void deleteTest() {        SqlSession session = null;        User user = new User();        user.setId(7);        try {            session = MyBatisUtil.createSqlSession();            // session.delete("cn.dao.UserMapper.delete", user);            session.getMapper(UserMapper.class).delete(user);            session.commit();        } catch (Exception e) {            session.rollback();        } finally {            MyBatisUtil.closeSqlSession(session);        }    }    @Test    public void getUserList() {        SqlSession session = null;        List<User> userlist = null;        try {            session = MyBatisUtil.createSqlSession();            // userlist = session.selectList("cn.dao.UserMapper.getUserList");            userlist = session.getMapper(UserMapper.class).getUserList();            logger.debug("size ----------> " + userlist.size());            for (User user : userlist) {                logger.debug("user id : " + user.getId());            }        } catch (Exception e) {            session.rollback();        } finally {            MyBatisUtil.closeSqlSession(session);        }    }}

configuration.xml 系统核心配置文件

configuration配置包含数据源和事务管理器等设置和属性信息

---

• properties 可以配置在Java属性配置文件中
• settings 修改MyBatis在运行时的行为方式
• typeAliases 为Java类型命名一个别名（简称）
• typeHandlers 类型处理器
• objectFactory 对象工厂
• plugings 插件
• environments 环境
• environment 环境变量（transactionManager 事务管理器，dataSource 数据源）
• mapper 映射器

properties元素

properties和java的.properties的配置文件有关。配置properties的resource指定，文件中相应属性值。properties的路径，然后再在properties标签下配置property的name和value，则可以替换.properties。

<properties resource="jdbc.properties">    <property name="driver" value="${driver}" />    <property name="url" value="${url}" />    <property name="username" value="${username}" />    <property name="password" value="${password}" /></properties>

Settings元素

用来修改MyBatis在运行时的行为方式，主要时Mybatis的一些全局配置属性的设置

<settings>    <!-- 启用延迟加载-->    <setting name="lazyLoadingEnabled" value="false"/></settings>

typeAliases元素

类型别名时Java类型的简称，它仅仅只是关联到XML配置，简写冗长的Java类名

<typeAliases>    <!-- 只指向一个类取别名 -->    <typeAlias alias="User" type="cn.pojo.User"/>    <typeAliases>       <!-- 取个别名 在usermapper中parameterType直接用cn.pojo中的类名 -->     <package name="cn.pojo"/></typeAliases></typeAliases>

Environments元素

• Mybatis可以配置多套运行环境，将SQL映射到多个数据库上

• 虽然可以配置多个运行环境，但是每个SqlSessionFactory 实例只能选择一个运行环境。即：每个数据库对应一个SqlSessionFactory实例

  <!-- 默认的运行环境ID--><environments default="develoment">    <!-- 运行环境ID-->     <environment id="develoment">        <!-- 配置事务管理采用JDBC -->        <transactionManager type="JDBC" />        <!-- POOLED:mybatis的数据源 JNDI:基于tomcat的数据源 -->        <dataSource type="POOLED">            <property name="driver" value="${driver}" />            <property name="url" value="${url}" />            <property name="username" value="${username}" />            <property name="password" value="${password}" />        </dataSource>               </environment>    <!-- 运行环境ID-->    <environment id="test">    .....    </environment>   </environments>

transactionManager 事务管理器 ####

• <transactionManager type="[JDBC|MANAGED]"/>
• JDBC
• MANAGED（托管）

dataSource

• dataSource元素使用基本的JDBC数据源接口来配置JDBC连接对象的资源。有三种内建的数据源模型。

• <dataSource type="[UNPOOLED|POOLED|JNDI]"/>

  <dataSource type="POOLED">    <property name="driver" value="${driver}" />    <property name="url" value="${url}" />    <property name="username" value="${username}" />    <property name="password" value="${password}" /></dataSource>   

mappers元素

Sql映射语句一般定义在各持久类的Mapper.xml文件中，需要在配置中引用这些映射文件。

<!-- 将mapper文件加入到配置文件中 --><mappers>    <mapper resource="cn/dao/UserMapper.xml"/></mappers>

MyBatis是支持普通SQL查询，存储过程和高级映射的优秀持久层框架

mybatis是什么？

• 支持：sql查询，存储过程，高级查询
• 消除：手工jdbc代码，参数手工设置，结果集的检索
• 使用：xml，注解}pojo映射成数据库的记录

MyBatis环境搭建，实现对数据表简单的增删查改操作

MyBatis的核心对象

• SqlSessionFactoryBuilder 用完就不用了
• SqlSessionFactory 单例
• SqlSession

configuration.xml 全局配置文件