MyBatis入门第1天--MyBatis基础知识（一）

文档版本	开发工具	测试平台	工程名字	日期	作者	备注
V1.0				2016.06.25	lutianfei	none

• 内容梳理

• 第一天：基础知识（重点，内容量多）

  • 对原生态jdbc程序（单独使用jdbc开发）问题总结
  • mybatis框架原理 （掌握）
  • mybatis入门程序
  • 用户的增、删、改、查
  • mybatis开发dao两种方法：
  • 原始dao开发方法（程序需要编写dao接口和dao实现类）（掌握）
  • mybaits的mapper接口（相当于dao接口）代理开发方法（掌握）
  • mybatis配置文件SqlMapConfig.xml
  • mybatis核心：
  • mybatis输入映射（掌握）
  • mybatis输出映射（掌握）
  • mybatis的动态sql（掌握）

• 第二天：高级知识

  • 订单商品数据模型分析
  • 高级结果集映射（一对一、一对多、多对多）
  • mybatis延迟加载
  • mybatis查询缓存（一级缓存、二级缓存）
  • mybaits和spring进行整合（掌握）
  • mybatis逆向工程

• POJO : 名称解释

  • POJO（Plain Ordinary Java Object）简单的Java对象，实际就是普通JavaBeans，是为了避免和EJB混淆所创造的简称。
  • 使用POJO名称是为了避免和EJB混淆起来, 而且简称比较直接. 其中有一些属性及其getter setter方法的类,没有业务逻辑，有时可以作为VO(value -object)或dto(Data Transform Object)来使用.当然,如果你有一个简单的运算属性也是可以的,但不允许有业务方法,也不能携带有connection之类的方法。

原生态jdbc程序中问题总结

• 1、数据库连接，使用时就创建，不使用立即释放，对数据库进行频繁连接开启和关闭，造成数据库资源浪费，影响 数据库性能。

  • 设想：使用数据库连接池管理数据库连接。

• 2、将sql语句硬编码到java代码中，如果sql 语句修改，需要重新编译java代码，不利于系统维护。

  • 设想：将sql语句配置在xml配置文件中，即使sql变化，不需要对java代码进行重新编译。

• 3、向preparedStatement中设置参数，对占位符号位置和设置参数值，硬编码在java代码中，不利于系统维护。

  • 设想：将sql语句及占位符号和参数全部配置在xml中。

• 4、从resutSet中遍历结果集数据时，存在硬编码，将获取表的字段进行硬编码，不利于系统维护。

  • 设想：将查询的结果集，自动映射成java对象。

Mybatis框架

• MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis，实质上Mybatis对ibatis进行一些改进。

• MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。

• Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。

• mybatis可以将向 preparedStatement中的输入参数自动进行输入映射，将查询结果集灵活映射成java对象。（输出映射）

• MyBatis框架示意图
  

• mapper.xml文件即sql映射文件，文件中配置了操作数据库的sql语句。此文件需要在SqlMapConfig.xml中加载。

• 通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂

• 由会话工厂创建sqlSession即会话，操作数据库需要通过sqlSession进行。

• mybatis底层自定义了Executor执行器接口操作数据库，Executor接口有两个实现，一个是基本执行器、一个是缓存执行器。

• Mapped Statement也是mybatis一个底层封装对象，它包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个Mapped Statement对象，sql的id即是Mapped statement的id。

• Mapped Statement对sql执行输入参数进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。

• Mapped Statement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。

MyBatis入门程序

• 需求

  • 根据用户id（主键）查询用户信息
  • 根据用户名称模糊查询用户信息
  • 添加用户
  • 删除用户
  • 更新用户

• 3.1 环境

  • java环境：jdk1.7.0_72
  • eclipse：indigo
  • mysql：5.1

• mybatis运行环境（jar包）：

  • 从 https://github.com/mybatis/mybatis-3/releases 下载，3.2.7版本
    

• lib下：依赖包

  • mybatis-3.2.7.jar：核心包
  • mybatis-3.2.7.pdf，操作指南

创建mysql数据库

• 先导入sql_table.sql，再导入 sql_data.sql脚本

  • sql_table.sql：记录表结构
  • sql_data.sql：记录测试数据，在实际企业开发中，最后提供一个初始化数据脚本

• log4j.properties

# Global logging configuration
log4j.rootLogger=DEBUG, stdout

# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

• 工程结构
  

• 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>

<!-- </a>和spring整合后 environments配置将废除-->
   <environments default="development">
      <environment id="development">
      <!-- 使用jdbc事务管理-->
         <transactionManager type="JDBC" />

      <!-- 数据库连接池-->
         <dataSource type="POOLED">
            <property name= "driver" value="com.mysql.jdbc.Driver" />
            <property name= "url" value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8" />
            <property name="username" value="root" />
            <property name="password" value="mysql" />
         </dataSource>

      </environment>
   </environments>
</configuration>

根据用户id（主键）查询用户信息

创建po类

• Po类作为mybatis进行sql映射使用，po类通常与数据库表对应，User.java如下：

Public class User {
   private int id;
   private String username;// 用户姓名
   private String sex;// 性别
   private Date birthday;// 生日
   private String address;// 地址

get/set... toString

映射文件

• 映射文件命名：

  • User.xml（原始ibatis命名）
  • MyBatis的mapper代理开发映射文件名称叫XXXMapper.xml
    
    • 比如：UserMapper.xml、ItemsMapper.xml

• 在映射文件中配置sql语句

  • 在classpath下的sqlmap目录下创建sql映射文件Users.xml：
  • namespace ： 命名空间，用于隔离sql语句，后面会讲另一层非常重要的作用。

• 配置参数说明

  • id：标识 映射文件中的 sql 将sql语句封装到mappedStatement对象中，所以将id称为statement的id
  • parameterType：指定输入 参数的类型，这里指定int型
  • #{}表示一个占位符号
    
    • #{id}：其中的id表示接收输入 的参数，参数名称就是id，如果输入 参数是简单类型，#{}中的参数名可以任意，可以value或其它名称
  • resultType：指定sql输出结果的所映射的java对象类型，select指定resultType表示将单条记录映射成的java对象。

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

<!-- namespace命名空间，作用就是对sql进行分类化管理，理解sql隔离 注意：使用mapper代理方法开发，namespace有特殊重要的作用 -->
<mapper namespace="test">

    <!-- 在 映射文件中配置很多sql语句 -->
    <!-- 需求：通过id查询用户表的记录 -->
    <!-- 通过 select执行数据库查询 id：标识 映射文件中的 sql 将sql语句封装到mappedStatement对象中，所以将id称为statement的id parameterType：指定输入 参数的类型，这里指定int型 #{}表示一个占位符号 #{id}：其中的id表示接收输入 的参数，参数名称就是id，如果输入 参数是简单类型，#{}中的参数名可以任意，可以value或其它名称 resultType：指定sql输出结果 的所映射的java对象类型，select指定resultType表示将单条记录映射成的java对象。 -->
    <select id="findUserById" parameterType="int" resultType="cn.itcast.mybatis.po.User">
        SELECT * FROM USER WHERE id=#{value}
    </select>

在SqlMapConfig.xml加载映射文件

• 在sqlMapConfig.xml中加载User.xml;
• parameterType：定义输入到sql中的映射类型，#{id}表示使用preparedstatement设置占位符号并将输入变量id传到sql。
• resultType：定义结果映射类型。

<!-- 加载 映射文件 -->
    <mappers>
        <mapper resource="sqlmap/User.xml"/>

        <!--通过resource方法一次加载一个映射文件 -->
        <!-- <mapper resource="mapper/UserMapper.xml"/> -->
    </mappers>

测试程序编写

public class MybatisFirst {

    // 根据id查询用户信息，得到一条记录结果
    @Test
    public void findUserByIdTest() throws IOException {

        // mybatis配置文件
        String resource = "SqlMapConfig.xml";
        // 得到配置文件流
        InputStream inputStream = Resources.getResourceAsStream(resource);

        // 创建会话工厂，传入mybatis的配置文件信息
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
                .build(inputStream);

        // 通过工厂得到SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();

        // 通过SqlSession操作数据库
        // 第一个参数：映射文件中statement的id，等于=namespace+"."+statement的id
        // 第二个参数：指定和映射文件中所匹配的parameterType类型的参数
        // sqlSession.selectOne结果 是与映射文件中所匹配的resultType类型的对象
        // selectOne查询出一条记录
        User user = sqlSession.selectOne("test.findUserById", 1);

        System.out.println(user);

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

    }
}

根据用户名称模糊查询用户信息

映射文件

• 使用User.xml，添加根据用户名称模糊查询用户信息的sql语句。
  
  • resultType：指定就是单条记录所映射的java对象 类型
  • ${}:表示拼接sql串，将接收到参数的内容不加任何修饰拼接在sql中。
    
    • 使用${}拼接sql,会引起sql注入
  • value：接收输入参数的内容，如果传入类型是简单类型， {}中只能使用value

<!-- 根据用户名称模糊查询用户信息，可能返回多条 resultType：指定就是单条记录所映射的java对象 类型 ${}:表示拼接sql串，将接收到参数的内容不加任何修饰拼接在sql中。 使用${}拼接sql，引起 sql注入 ${value}：接收输入 参数的内容，如果传入类型是简单类型，${}中只能使用value -->
    <select id="findUserByName" parameterType="java.lang.String" resultType="cn.itcast.mybatis.po.User">
        SELECT * FROM USER WHERE username LIKE '%${value}%'
    </select>

程序代码

// 根据用户名称模糊查询用户列表
    @Test
    public void findUserByNameTest() throws IOException {
        // mybatis配置文件
        String resource = "SqlMapConfig.xml";
        // 得到配置文件流
        InputStream inputStream = Resources.getResourceAsStream(resource);

        // 创建会话工厂，传入mybatis的配置文件信息
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
                .build(inputStream);

        // 通过工厂得到SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();
        // list中的user和映射文件中resultType所指定的类型一致
        List<User> list = sqlSession.selectList("test.findUserByName", "小明");
        System.out.println(list);
        sqlSession.close();

    }

• 知识点回顾

• #{}和${}

  • #{}表示一个占位符号，通过#{}可以实现preparedStatement向占位符中设置值，自动进行java类型和jdbc类型转换，#{}可以有效防止sql注入。 #{}可以接收简单类型值或pojo属性值。 如果parameterType传输单个简单类型值，#{}括号中可以是value或其它名称。
  • ${}表示拼接sql串，通过${}可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换， ${}可以接收简单类型值或pojo属性值，如果parameterType传输单个简单类型值，${}括号中只能是value。

• parameterType和resultType

  • parameterType：指定输入参数类型，mybatis通过ognl从输入对象中获取参数值拼接在sql中。
  • resultType：指定输出结果类型，mybatis将sql查询结果的一行记录数据映射为resultType指定类型的对象。

• selectOne和selectList

  • selectOne查询一条记录，如果使用selectOne查询多条记录则抛出异常：
    
    • org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 3 at org.apache.ibatis.session.defaults.DefaultSqlSession.selectOne(DefaultSqlSession.java:70)
  • selectList可以查询一条或多条记录。

添加用户

• 在 User.xml中配置添加用户的Statement
  

• 程序代码

// 添加用户信息
    @Test
    public void insertUserTest() throws IOException {
        // mybatis配置文件
        String resource = "SqlMapConfig.xml";
        // 得到配置文件流
        InputStream inputStream = Resources.getResourceAsStream(resource);

        // 创建会话工厂，传入mybatis的配置文件信息
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
                .build(inputStream);

        // 通过工厂得到SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();
        // 插入用户对象
        User user = new User();
        user.setUsername("王小军");
        user.setBirthday(new Date());
        user.setSex("1");
        user.setAddress("河南郑州");

        sqlSession.insert("test.insertUser", user);

        // 提交事务
        sqlSession.commit();

        // 获取用户信息主键
        System.out.println(user.getId());
        // 关闭会话
        sqlSession.close();

    }

• 自增主键返回
• mysql自增主键，执行insert提交之前自动生成一个自增主键。

• 通过mysql函数获取到刚插入记录的自增主键：

  • LAST_INSERT_ID()
  • 是insert之后调用此函数。

• 将插入数据的主键返回，返回到user对象中

  • SELECT LAST_INSERT_ID()：得到刚insert进去记录的主键值，只适用与自增主键
  • keyProperty：将查询到主键值设置到parameterType指定的对象的哪个属性
  • order：SELECT LAST_INSERT_ID()执行顺序，相对于insert语句来说它的执行顺序
  • resultType：指定SELECT LAST_INSERT_ID()的结果类型

• 修改insertUser定义：

    <!-- 添加用户 parameterType：指定输入 参数类型是pojo（包括 用户信息） #{}中指定pojo的属性名，接收到pojo对象的属性值，mybatis通过OGNL获取对象的属性值 -->
    <insert id="insertUser" parameterType="cn.itcast.mybatis.po.User">
        <!-- 将插入数据的主键返回，返回到user对象中 SELECT LAST_INSERT_ID()：得到刚insert进去记录的主键值，只适用与自增主键 keyProperty：将查询到主键值设置到parameterType指定的对象的哪个属性 order：SELECT LAST_INSERT_ID()执行顺序，相对于insert语句来说它的执行顺序 resultType：指定SELECT LAST_INSERT_ID()的结果类型 -->
        <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
            SELECT LAST_INSERT_ID()
        </selectKey>
        insert into user ( username,birthday,sex,address) value(#{username},#{birthday},#{sex},#{address})

    </insert>

• 非自增主键返回(使用uuid())

• 使用mysql的uuid()函数生成主键，需要修改表中id字段类型为string，长度设置成35位。

• 执行思路：

  • 先通过uuid()查询到主键，将主键输入 到sql语句中。
  • 执行uuid()语句顺序相对于insert语句之前执行。

<!-- 使用mysql的uuid（）生成主键 执行过程： 首先通过uuid()得到主键，将主键设置到user对象的id属性中 其次在insert执行时，从user对象中取出id属性值 -->
<selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">
    SELECT uuid()
</selectKey>
insert into user ( id,username,birthday,sex,address) value(#{id},#{username},#{birthday},#{sex},#{address})

• 通过oracle的序列生成主键：

<selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">
SELECT 序列名.nextval()
</selectKey>
insert into user ( id,username,birthday,sex,address) value(#{id},#{username},#{birthday},#{sex},#{address})

删除用户

• 映射文件

    <!-- 删除 用户 根据id删除用户，需要输入 id值 -->
    <delete id="deleteUser" parameterType="java.lang.Integer">
        delete from user where id=#{id}
    </delete>

• 代码

// 根据id删除 用户信息
    @Test
    public void deleteUserTest() throws IOException {
        // mybatis配置文件
        String resource = "SqlMapConfig.xml";
        // 得到配置文件流
        InputStream inputStream = Resources.getResourceAsStream(resource);

        // 创建会话工厂，传入mybatis的配置文件信息
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
                .build(inputStream);

        // 通过工厂得到SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();

        // 传入id删除 用户
        sqlSession.delete("test.deleteUser", 39);

        // 提交事务
        sqlSession.commit();

        // 关闭会话
        sqlSession.close();

    }

更新用户

• 映射文件

<!-- 根据id更新用户
分析：
需要传入用户的id
需要传入用户的更新信息
parameterType指定user对象，包括 id和更新信息，注意：id必须存在
#{id}：从输入 user对象中获取id属性值
 --> <update id="updateUser" parameterType="cn.itcast.mybatis.po.User">
    update user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address} 
     where id=#{id}
</update>

• 代码

    // 更新用户信息
    @Test
    public void updateUserTest() throws IOException {
        // mybatis配置文件
        String resource = "SqlMapConfig.xml";
        // 得到配置文件流
        InputStream inputStream = Resources.getResourceAsStream(resource);

        // 创建会话工厂，传入mybatis的配置文件信息
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder()
                .build(inputStream);

        // 通过工厂得到SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();
        // 更新用户信息

        User user = new User();
        //必须设置id
        user.setId(41);
        user.setUsername("王大军");
        user.setBirthday(new Date());
        user.setSex("2");
        user.setAddress("河南郑州");

        sqlSession.update("test.updateUser", user);

        // 提交事务
        sqlSession.commit();

        // 关闭会话
        sqlSession.close();

    }

入门程序总结

• parameterType
  
  • 在映射文件中通过parameterType指定输入 参数的类型。

• resultType

  • 在映射文件中通过resultType指定输出结果的类型。

• #{}和${}

  • #{}表示一个占位符号，#{}接收输入参数，类型可以是简单类型，pojo、hashmap。
    
    • 如果接收简单类型，#{}中可以写成value或其它名称。
  • #{}接收pojo对象值，通过OGNL读取对象中的属性值，通过属性.属性.属性…的方式获取对象属性值。
  • ${}表示一个拼接符号，会引用sql注入，所以不建议使用${}。
  • ${}接收输入参数，类型可以是简单类型，pojo、hashmap。
  • 如果接收简单类型，${}中只能写成value。
  • ${}接收pojo对象值，通过OGNL读取对象中的属性值，通过属性.属性.属性…的方式获取对象属性值。

mybatis和hibernate本质区别和应用场景

• hibernate：是一个标准ORM框架（对象关系映射）。入门门槛较高的，不需要程序写sql，sql语句自动生成了。对sql语句进行优化、修改比较困难的。

• 应用场景：

  • 适用与需求变化不多的中小型项目，比如：后台管理系统，erp、orm、oa。。

• mybatis：专注是sql本身，需要程序员自己编写sql语句，sql修改、优化比较方便。mybatis是一个不完全 的ORM框架，虽然程序员自己写sql，mybatis 也可以实现映射（输入映射、输出映射）。

• 应用场景：

  • 适用与需求变化较多的项目，比如：互联网项目。

• 企业进行技术选型，以低成本 高回报作为技术选型的原则，根据项目组的技术力量进行选择。