MyBatis框架使用解析!数据库相关API的基本介绍-阿里云开发者社区

开发者社区> 攻城狮Chova> 正文

MyBatis框架使用解析!数据库相关API的基本介绍

简介: 本篇文章中对MyBatis框架中的具体使用进行了详细的分析说明。介绍了在Java项目使用的各种API的基本方式。包括动态SQL,多数据库支持,脚本语言,Java中各种语句执行方法,SELECT语句的高级使用,清除批量更新的方法以及事务控制的方法。
+关注继续查看

动态SQL

if

  • 根据条件包含where子句的一部分
<select id="findActiveBlogLike" resultType="Blog">
    SELECT * FROM BLOG WHERE state = 'ACTIVE'
    <where>
        <if test="title != null">
            AND title like #{title}
        </if>
        <if test="author != null and author.name != null">
            AND author_name like #{author.name}
        </if>
    </where>
</select>
  • 紧接着 < where > 的第一个条件不要加AND

choose-when-otherwise

  • 不使用所有的条件,只是想从多个条件中选择一个使用
<select id="findActiveBlogLike" resultType="Blog">
    SELECT * FROM BLOG WHERE state = 'ACTIVE'
    <choose>
        <when tset="title != null">
            AND title like #{title}
        </when>
        <when test="author != null and author.name != null">
            AND author_name like #{author.name}
        </when>
        <otherwise>
            AND featured = 1
        </otherwise>
    </choose>
</select>

where

  • where元素只会在子元素返回内容的情况下才会插入WHRER的子语句
  • 若子语句的开头为AND或者OR,where元素会将这些去除
<select id="findActiveBlogLike" resultType="Blog">
    SELECT * FROM BLOG
    <where>
        <if test="state != null">
            state = #{state}
        </if>
        <if test="title != null">
            AND title like #{title}
        </if>
        <if test="author != null and author.name != null">
            AND author_name like #{author.name}
        </if>
    </where>
</select>

trim

  • 可以通过自定义trim元素来定制where元素的功能

    • 比如和where元素等价的自定义trim元素.会移除所有prefixOverrides属性中指定的内容,并且插入prefix属性中指定的内容:

       <trim prefix="WHERE" prefixOverrides="AND |OR">
           ...
       </trim>

      prefixOverrides属性会忽略通过管道符分割的文本序列 ,不同的文本序列之间必须要有空格.

      • set元素等价的自定义trim元素. 覆盖了后缀值设置,并且自定义前缀值:
      <trim prefix="SET" suffixOverrides=",">
          ...
      </trim>

set

  • 用于动态更新语句的叫作set
  • set元素可以用于动态包含需要更新的列,忽略不更新的列
<update id="updateAuthorIfNecessary">
    update Author
        <set>
            <if test="username != null">
                username = #{username},
            </if>
            <if test="password != null">
                password = #{password},
            </if>
            <if test="email != null">
                email = #{email},
            </if>
            <if test="bio != null">
                bio = #{bio}
            </if>
        </set>
    where id = #{id}
</update>
  • set元素会动态地进行行首插入SET关键字,并会删掉额外的逗号,这些逗号是在使用条件语句给列赋值时引入的

foreach

  • 对集合进行遍历的时候使用foreach, 特别是在构建IN条件语句的时候
<select id="selectPostIn" resultType="domain.blog.Post">
    SELECT * 
    FROM POST p
    WHERE ID IN
    <foreach item="item" index="index" collection="list" open="(" separator="," close=")">
        #{item}
    </foreach> 
</select>
  • foreach允许指定一个集合:

    • 声明可以在元素体内使用的集合项item和索引index变量
    • 指定开头open与结尾close的字符串以及集合项迭代之间的分隔符separator
    • foreach不会错误地添加多余的分隔符
  • 使用foreach时:

    • 可以将任何可迭代对象,比如List,Set,Map对象或者数组对象作为集合参数传递给foreach
    • 当使用可迭代对象或者数组时:

      • index是当前迭代的序号
      • item的值是本次迭代获取到的元素
    • 当使用Map对象或者Map.Entry对象的集合

      • index是键
      • item是值

script

  • 要是想要在带注解的接口类中使用动态SQL语句,可以使用script元素
@update({"<script>",
            "update Author",
                "<set>",
                    "<if test='username != null'>username=#{username},</if>",
                    "<if test='password != null'>password=#{password},</if>",
                    "<if test='email != null'>email=#{email},</if>",    
                "</set>",
                "where id=#{id}",
                "</script>"})    
})
void updateAuthorValues(Author author);

bind

  • 可以使用bind元素在OGNL表达式以外创建一个变量,并绑定到上下文中
<select id="selectBlogsLike" resultType="Blog">
    <bind name="pattern" value="'%' + _parameter.getTitle() + '%'" />
    SELECT * FROM BLOG
    WHERE title LIKE #{pattern}
</select>

多数据库支持

  • 如果配置了databaseIdProvider, 就可以在动态代码中使用名为 "_databaseId" 的变量来为不同的数据库构建特定的语句
<insert id="insert">
    <selectKey keyProperty="id" resultType="int" order="BEFORE">
        <if test="_databaseId == 'oracle'">
            select seq_users.nextval from dual
        </if>
        <if test="_databaseId == 'db2'">
            select nextval for seq_users from sysibm.sysdummy1
        </if>
    </selectKey>
    insert into users values (#{id}, #{name})
</insert>

动态SQL中插入脚本语言

  • MyBatis 3.2版本开始支持插入脚本语言
  • 允许插入一种语言驱动,并基于这种语言来编写动态SQL查询语句
  • 通过实现LanguageDriver接口插入语言:
public interface LanguageDriver {
    ParameterHandler createParameterHandler(MappedStatement mappedStatement, Object parameterObject, BoundSql boundSql);
    
    SqlSource createSqlSource(Configuration configuration, XNode script, Class<?> parameterType);
    SqlSource crateSqlSource(Configuration configuration, String script, Class<?> parameterType);
}
  • 实现自定义语言驱动后,可以在mybatis-config.xml文件中设置为默认语言:
<typeAliases>
    <typeAliase type="com.oxford.MyLanguageDriver" alias="myLanguage" />
</typeAliases>
<settings>
    <setting name="defaultScriptingLanguage" value="myLanguage" />
</settings>
  • 也可以使用lang属性为特定的语句指定语言:
<select id="selectBlog" lang="myLanguage">
    SELECT * FROM BLOG
</select>
  • 或者在mapper接口上使用 @Lang注解:
public interface Mapper {
    @Lang(MyLanguageDriver.class)
    @Select("SELECT * FROM BLOG")
    List<Blog> selectBlog();
}
  • MyBatis中的xml文件中的所有xml标签都由默认MyBatis语言提供,是由语言驱动org.apache.ibatis.scripting.xmltags.XmlLanguageDriver, 别名为xml. 提供的.

Java API

  • MyBatis的执行方法在SqlSession类中

语句执行方法

  • 这些方法被用来执行定义在SQL映射XML文件中的SELECT,INSERT,UPDATE和DELETE语句

    • 每一个方法都接收语句的ID以及参数对象
    • 参数可以是原始类型(支持自动装箱),包装类,JavaBean,POJO或者Map
selectOne
<T> T selectOne(String statement, Object parameter);
selectList
<E> List<E> selectList(String statement, Object parameter);
  • selectOne和selectList的不同点是:

    • selectOne必须返回一个对象或者null值, 如果返回值多于一个就会抛出异常
    • 如果不清楚返回对象会有多少个,就使用selectList
selectCursor
<T> Cursor<T> selectCursor(String statement, Object parameter);
  • 游标Cursor与列表List返回的结果相同,不同的是: 游标借助迭代器实现了数据的惰性加载
try (Cursor<Entity> entities = session.selectCursor(statement, param)) {
    for (Entity entity : entities) {
        // 处理单个实体
    }
}
     
selectMap
<K,V> Map<K,V> selectMap(String statement, Object parameter, String mapKey); 
  • selectMap会将返回对象的其中一个属性作为key值,将对象作为value值,从而将多个结果集转为Map类型值
insert
int insert(String statement, Object parameter);
update
int update(String statement, Object parameter);
delete
int delete(String statement, Obejct parameter);
  • 如果需要查看某个对象是否存在, 最好的办法就是查询一个count值,使用0或者1
  • 由于不是所有语句都需要参数,所以这些方法都具有一个不需要参数的重载形式
  • insert, updatedelete方法返回值表示受该语句影响的行数

select高级版本

  • 允许限制返回行数的范围
  • 提供自定义结果处理逻辑
  • 通常是在数据集非常庞大的情形下使用
selectList
<E> List<E> selectList(String statement, Object parameter, RowBounds rowBounds);
selectCursor
<T> List<T> selectCursor(String statement, Object parameter, RowBounds rowBounds);
selectMap
<K, V> Map<K,V> selectMap(String statement, Object parameter, String mapKey, RowBounds rowBounds);
select
void select(String statement, Object parameter, ResultHandler<T> handler);
select
void select(String statement Object parameter, RowBounds rowBounds, ResultHandler<T> handler);
  • RowBounds参数:

    • 指定MyBatis略过指定数量的记录,并限制返回结果的数量
    • RowBounds类的offset和limit值只有在构造函数时才能传入,其他时候是不能修改的
    int offset = 100;
    int limit = 25;
    RowBounds rowBounds = new RowBounds(offset, limit);
  • ResultHandler参数:

    • 允许自定义每行结果的处理过程
    • 可以添加到List中,创建Map和Set. 甚至丢弃每个返回值,只保留计算后的统计结果
  • ResultHandler接口:
package org.apache.ibatis.session;
public interface ResultHandler<T> {
    void handlerResult(ResultContext<? extends T> context);
}
  • ResultContext参数:

    • 允许访问结果对象和当前已被创建的对象数目
    • 提供一个返回值为Booleanstop方法,可以使用这个stop方法来停止MyBatis加载更多的结果
  • 使用ResultHandler要注意两条限制:

    • 使用带ResultHandler参数的方法时,收到的数据不会被缓存
    • 当使用高级的结果映射集resultMap,MyBatis很可能需要数行结果来构造一个对象.如果这时使用了ResultHandler, 可能会接收到关联association或者集合collection中尚未被完整填充的对象

清除批量更新方法

  • ExecutorType设置为ExecutorType.BATCH时,可以使用flushStatements清除缓存在JDBC驱动类中的批量更新语句
flushStatements
List<BatchResult> flushStatements();

事务控制方法

  • 控制事务作用域的方法有四个,如果已经设置了自动提交或者使用了外部事务管理器, 就不需要使用这些方法
  • 如果正在使用Connection实例控制的JDBC事务管理器,就可以使用以下的四个方法:
void commit();

void commit(boolean force);

void rollback();

void rollback(boolean force);
  • 默认情况下 ,MyBatis不会自动提交事务,除非发现到调用了插入,更新或删除方法改变了数据库
  • 如果没有使用这些方法提交修改,那么就可以在commitrollback方法参数传入true值来保证事务被正常提交

    • 注意: 在自动提交模式或者使用了外部事务管理器的情况下,设置force值对session无效
  • 大部分情况下,无需调用rollback(), 因为MyBatis会在没有调用commit() 时完成回滚操作
  • 但是,当要在一个可能多次提交或回滚的session中详细控制事务,就要使用到回滚rollback操作

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
数据同步框架MS Sync Framework-不同场景使用例子和简要分析
上一篇http://www.cnblogs.com/2018/archive/2011/02/22/1961654.html 对这个框架一个总体介绍,这篇通过SDK内带的例子和一个综合的例子描述一下这个框架的使用 [例子基于SDK2.
838 0
关于ssm框架使用mysql控制台出现警告问题
使用MySQL时,总会时不时出现这种警告信息 警告信息:WARN: Establishing SSL connection without server's identity verification is not recommended.   出现这个警告的原因是: MySQL在高版本需要指明是否进行SSL连接。
959 0
iOS网络编程之六——数据缓存类NSURLCache使用解析
iOS网络编程之六——数据缓存类NSURLCache使用解析
17 0
Android Studio 通过一个登录功能介绍SQLite数据库的使用
前言:         SQLite简介:是一款轻型的数据库,是遵守ACID的关系型数据库管理系统,它包含在一个相对小的C库中。它是D.RichardHipp建立的公有领域项目。它的设计目标是嵌入式的,而且目前已经在很多嵌入式产品中使用了它,它占用资源非常的低,在嵌入式设备中,可能只需要几百K的内存就够了。
4227 0
使用iOS原生sqlite3框架对sqlite数据库进行操作(五)
使用iOS原生sqlite3框架对sqlite数据库进行操作
23 0
FFMPEG音频开发: Linux下采集摄像头(使用V4L2框架)数据录制成MP4视频保存到本地
FFMPEG音频开发: Linux下采集摄像头(使用V4L2框架)数据录制成MP4视频保存到本地
21 0
SSM框架——使用 MyBatis Generator 生成代码,包括:Model、Dao、Mapping
基于 SSM 框架开发,Mybatis 属于半自动 ORM,如果每个数据表相关的 Model、Dao、Mapping 都要自己动手去写,是不是很麻烦呢?工作量最大的就是书写Mapping的映射文件,而且手动书写很容易出错。
1154 0
+关注
攻城狮Chova
一位有自我修养的攻城狮。 2006年《时代》周刊年度人物, 2008年感动中国组委会特别奖获得者。 专注分享技术干货,面试经验和攻城狮故事~ 欢迎点赞关注支持,是我持续进步的动力!
77
文章
0
问答
文章排行榜
最热
最新
相关电子书
更多
《2021云上架构与运维峰会演讲合集》
立即下载
《零基础CSS入门教程》
立即下载
《零基础HTML入门教程》
立即下载