Mybatis 入门

一、Mybatis 介绍

MyBatis 本是 apache 的一个开源项目 iBatis, 2010年这个项目由 apache software foundation 迁移到了 google code，并且改名为 MyBatis 。2013年11月迁移到 Github。

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

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

二、使用 JDBC 编程问题总结

  • JDBC 编程步骤
  1. 注册数据库驱动
  2. 创建并获取数据库连接 connection
  3. 创建 jdbc statement 对象
  4. 书写 sql 语句
  5. 设置 sql 语句中的参数（使用 preparedStatement）
  6. 通过 statement 执行 sql 并获取结果
  7. 对 sql 执行结果进行解析处理
  8. 释放资源 （resultSet、preparedStatement、connection）
  • JDBC 程序示例
 public static void main(String[] args) {
    Connection connection = null;
    PreparedStatement preparedStatement = null;
    ResultSet resultSet = null;
    try {
       // 注册数据库驱动
       Class.forName("com.mysql.jdbc.Driver");
       // 通过驱动管理类获取数据库连接
       connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8", "root", "root");
       // 定义sql语句  ?表示占位符
       String sql = "select * from user where username = ?";
       // 获取预处理statement
       preparedStatement = connection.prepareStatement(sql);
       // 设置参数，第一个参数为sql语句中参数的序号（从1开始），第二个参数为设置的参数值
       preparedStatement.setString(1, "王五");
       // 向数据库发出sql执行查询，查询出结果集
       resultSet = preparedStatement.executeQuery();
       // 遍历查询结果集
       while (resultSet.next()) {
           System.out.println(resultSet.getString("id") + "  " + resultSet.getString("username"));
       }
    } catch (Exception e) {
       e.printStackTrace();
    } finally {
       // 释放资源
       if (resultSet != null) {
           try {
              resultSet.close();
           } catch (SQLException e) {
              // TODO Auto-generated catch block
              e.printStackTrace();
           }
       }
       if (preparedStatement != null) {
           try {
              preparedStatement.close();
           } catch (SQLException e) {
              // TODO Auto-generated catch block
              e.printStackTrace();
           }
       }
       if (connection != null) {
           try {
              connection.close();
           } catch (SQLException e) {
              // TODO Auto-generated catch block
              e.printStackTrace();
           }
       }
    }
}

上边使用jdbc的原始方法（未经封装）实现了查询数据库表记录的操作。

  • JDBC 问题总结如下：
  1. 数据库连接创建、释放频繁造成系统资源浪费，从而影响系统性能。可使用数据库连接池解决此问题。
  2. Sql语句在代码中硬编码，造成代码不易维护，实际应用中sql变化的可能较大，sql变动需要改变java代码。
  3. 使用preparedStatement向占位符传参数存在硬编码，因为sql语句的where条件不一定，可能多也可能少，修改sql还要修改代码，系统不易维护。
  4. 对结果集解析存在硬编码（查询列名），sql变化导致解析代码变化，系统不易维护，如果能将数据库记录封装成pojo对象解析比较方便。

三、Mybatis 架构

  1. mybaits 配置 ------> SqlMapConfig.xml，此文件作为 mybaits 的全局配置文件，配置了 mybatis 的运行环境等信息。mapper.xml 文件即 sql 映射文件，文件中配置了操作数据库的 sql 语句。此文件需要在 SqlMapConfig.xml 中加载。
  2. 通过mybatis环境等配置信息构造SqlSessionFactory（会话工厂）。
  3. 由会话工厂创建sqlSession（会话），操作数据库需要通过sqlSession进行。
  4. mybaits底层自定义了 Executor执行器接口操作数据库，Executor接口有两个实现，一个是基本执行器、一个是缓存执行器。
  5. Mapped Statement也是mybatis一个底层封装对象，它包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个Mapped Statement对象，sql的id即是Mapped statement的id。
  6. Mapped Statement对sql执行输入参数进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。
  7. Mapped Statement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。
  • jar包介绍 （mybatis核心包、mybatis依赖包、数据库驱动包）
mybatis核心包
mybaits依赖包
  • 配置文件参考

log4j.properties，mybatis默认使用log4j作为输出日志信息。

# 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

db.properties

 jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8
jdbc.username=root
jdbc.password=root

SqlMapConfig.xml，mybatis核心配置文件，配置文件内容为数据源、事务管理。(引用db.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">
<configuration>
    <!-- 使用resource属性加载外部配置文件 -->
    <properties resource="db.properties">
       <!-- 在properties内部用property定义属性 -->
       <!-- 如果外部配置文件有该属性，则内部定义属性被外部属性覆盖 -->
       <property name="jdbc.username" value="root123" />
       <property name="jdbc.password" value="root123" />
    </properties>

    <typeAliases>
       <!-- 单个别名定义 -->
       <typeAlias alias="user" type="cn.itcast.mybatis.pojo.User" />
       <!-- 批量别名定义，扫描整个包下的类，别名为类名（大小写不敏感） -->
       <package name="cn.itcast.mybatis.pojo" />
       <package name="其它包" />
    </typeAliases>

    <!-- 和spring整合后 environments配置将废除 -->
    <environments default="development">
       <environment id="development">
           <!-- 使用jdbc事务管理 -->
           <transactionManager type="JDBC" />
           <!-- 数据库连接池 -->
           <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="sqlmap/User.xml" />
       <mapper resource="mapper/UserMapper.xml" />
    </mappers>
</configuration>
  • MyBatis 将按照下面的顺序来加载属性：
    1)、在 properties 元素体内定义的属性首先被读取。
    2)、然后会读取properties 元素中resource或 url 加载的属性，它会覆盖已读取的同名属性。
  • 在mapper.xml配置文件中，就可以使用设置的别名了。（别名大小写不敏感）

sql映射文件，需要 在SqlMapConfig中加载

<?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：
        1.命名空间，用于隔离sql，
        2.使用动态代理开发DAO，namespace必须和Mapper接口类路径一致。 -->
<mapper namespace="test">
    <!-- id:statement的id 或者叫做sql的id-->
    <!-- parameterType:声明输入参数的类型 -->
    <!-- resultType:声明输出结果的类型，应该填写pojo的全路径 -->
    <!-- #{}：输入参数的占位符，相当于jdbc的？ -->
    <select id="queryUserById" parameterType="int" resultType="cn.itcast.mybatis.pojo.User">
       SELECT * FROM `user` WHERE id  = #{id}
    </select>

    <!-- 如果返回多个结果，mybatis会自动把返回的结果放在list容器中 -->
    <!-- resultType的配置和返回一个结果的配置一样 -->
    <select id="queryUserByUsername1" parameterType="string" resultType="cn.itcast.mybatis.pojo.User">
       SELECT * FROM `user` WHERE username LIKE #{username}
    </select>

    <!-- 如果传入的参数是简单数据类型，${}里面必须写value -->
    <select id="queryUserByUsername2" parameterType="string" resultType="cn.itcast.mybatis.pojo.User">
       SELECT * FROM `user` WHERE username LIKE '%${value}%'
    </select>

    <!-- 保存用户 -->
    <insert id="saveUser" parameterType="cn.itcast.mybatis.pojo.User">
       INSERT INTO `user` (username,birthday,sex,address) VALUES
       (#{username},#{birthday},#{sex},#{address})
    </insert>

    <!-- 保存用户 自增主键返回-->
    <insert id="saveUser1" parameterType="cn.itcast.mybatis.pojo.User">
       <!-- selectKey 标签实现主键返回 -->
       <!-- keyColumn:主键对应的表中的哪一列 -->
       <!-- keyProperty：主键对应的pojo中的哪一个属性 -->
       <!-- order：设置在执行insert语句前执行查询id的sql，孩纸在执行insert语句之后执行查询id的sql -->
       <!-- resultType：设置返回的id的类型 -->
       <selectKey keyColumn="id" keyProperty="id" order="AFTER" resultType="int">
           SELECT LAST_INSERT_ID()
       </selectKey>
       INSERT INTO `user` (username,birthday,sex,address) VALUES
       (#{username},#{birthday},#{sex},#{address})
    </insert>

    <!-- 保存用户 使用 uuid实现主键-->
    <insert id="saveUser2" parameterType="cn.itcast.mybatis.pojo.User">
        <!-- selectKey 标签实现主键返回 -->
        <!-- keyColumn:主键对应的表中的哪一列 -->
        <!-- keyProperty：主键对应的pojo中的哪一个属性 -->
        <!-- order：设置在执行insert语句前执行查询id的sql，孩纸在执行insert语句之后执行查询id的sql -->
        <!-- resultType：设置返回的id的类型 -->
        <selectKey keyColumn="id" keyProperty="id" order="BEFORE" resultType="string">
           SELECT LAST_INSERT_ID()
        </selectKey>
        INSERT INTO `user` (username,birthday,sex,address) VALUES
        (#{username},#{birthday},#{sex},#{address})
    </insert>

    <!-- 更新用户 -->
    <update id="updateUserById" parameterType="cn.itcast.mybatis.pojo.User">
        UPDATE `user` SET username = #{username} WHERE id = #{id}
    </update>

    <!-- 删除用户 -->
    <delete id="deleteUserById" parameterType="int">
       delete from user where id=#{id}
    </delete>
</mapper>

四、需要注意的点

  1. #{} 与 ${}

  2. parameterType 与 resultType
    parameterType：指定输入参数类型，mybatis通过ognl从输入对象中获取参数值拼接在sql中。
    resultType：指定输出结果类型，mybatis将sql查询结果的一行记录数据映射为resultType指定类型的对象。如果有多条数据，则分别进行映射，并把对象放到容器List中

  3. 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：可以查询一条或多条记录。

  4. 加载sql映射文件的方式

  • <mapper resource=" " />
    使用相对于类路径的资源（常用方式）
    如：<mapper resource="sqlmap/User.xml" />

  • <mapper class=" " />
    使用mapper接口类路径
    如：<mapper class="cn.itcast.mybatis.mapper.UserMapper"/>
    注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

  • <package name=""/>
    注册指定包下的所有mapper接口
    如：<package name="cn.itcast.mybatis.mapper"/>
    注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

五、Mybatis解决jdbc编程的问题

  1. 数据库连接创建、释放频繁造成系统资源浪费从而影响系统性能，如果使用数据库连接池可解决此问题。
    解决：在SqlMapConfig.xml中配置数据连接池，使用连接池管理数据库链接。
  2. Sql语句写在代码中造成代码不易维护，实际应用sql变化的可能较大，sql变动需要改变java代码。
    解决：将Sql语句配置在XXXXmapper.xml文件中与java代码分离。
  3. 向sql语句传参数麻烦，因为sql语句的where条件不一定，可能多也可能少，占位符需要和参数一一对应。
    解决：Mybatis自动将java对象映射至sql语句，通过statement中的parameterType定义输入参数的类型。
  4. 对结果集解析麻烦，sql变化导致解析代码变化，且解析前需要遍历，如果能将数据库记录封装成pojo对象解析比较方便。
    解决：Mybatis自动将sql执行结果映射至java对象，通过statement中的resultType定义输出结果的类型。

六、mybatis与hibernate不同

  1. Mybatis和hibernate不同，它不完全是一个ORM框架，因为MyBatis需要程序员自己编写Sql语句。mybatis可以通过XML或注解方式灵活配置要运行的sql语句，并将java对象和sql语句映射生成最终执行的sql，最后将sql执行的结果再映射生成java对象。

  2. Mybatis学习门槛低，简单易学，程序员直接编写原生态sql，可严格控制sql执行性能，灵活度高，非常适合对关系数据模型要求不高的软件开发，例如互联网软件、企业运营类软件等，因为这类软件需求变化频繁，一但需求变化要求成果输出迅速。但是灵活的前提是mybatis无法做到数据库无关性，如果需要实现支持多种数据库的软件则需要自定义多套sql映射文件，工作量大。
    Hibernate对象/关系映射能力强，数据库无关性好，对于关系模型要求高的软件（例如需求固定的定制化软件）如果用hibernate开发可以节省很多代码，提高效率。但是Hibernate的学习门槛高，要精通门槛更高，而且怎么设计O/R映射，在性能和对象模型之间如何权衡，以及怎样用好Hibernate需要具有很强的经验和能力才行。

  3. 总之，按照用户的需求在有限的资源环境下只要能做出维护性、扩展性良好的软件架构都是好架构，所以框架只有适合才是最好。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 212,029评论 6赞 492
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 90,395评论 3赞 385
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 157,570评论 0赞 348
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 56,535评论 1赞 284
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 65,650评论 6赞 386
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,850评论 1赞 290
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 39,006评论 3赞 408
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,747评论 0赞 268
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 44,207评论 1赞 303
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,536评论 2赞 327
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,683评论 1赞 341
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 34,342评论 4赞 330
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,964评论 3赞 315
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,772评论 0赞 21
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,004评论 1赞 266
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 46,401评论 2赞 360
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 43,566评论 2赞 349