Mybatis3 框架理解

　　最近工作比较闲，维护一个政府机关的短信发送平台，大部分业务逻辑都在Oracle数据库上，但自己明明应聘的是Java开发啊！！！整天写存储过程的我还是有一颗写高级语言的心啊！！！好吧！！！先找个数据库方面的框架学起来吧！

　　手头项目比较老，还在用ibatis，就找了它的后继者Mybatis3来学习（3.3.0 released,24 May 2015）。

　　学习的期望是：

1. 理解Mybatis相比JDBC最大的优点。
2. 自己动手搭建Mybatis框架。

　　从这几个部分理解：

1. Mybatis与ibatis的不同
2. XML配置
3. XML映射文件
4. 动态SQL

　　没耐心的可以直接跳到最后看总结。 

　　找来官方文档（还好有中文的）就读起来。

每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为中心的。我们可以从 SqlSessionFactory 中获取 SqlSession ，SqlSession 完全包含了面向数据库执行 SQL 命令所需的所有方法。

　　我认为 SqlSessionFactory 相当于 ibatis中的SqlMapClient ，因为后者的方法中也有一个openSession()。SqlSession 相当于ibatis中的 SqlMapSession。

　　相比之下，Mybatis采用更清晰并且类型安全的方式来执行SQL映射。

SqlSession session = sqlSessionFactory.openSession();
try {
  BlogMapper mapper = session.getMapper(BlogMapper.class);
  Blog blog = mapper.selectBlog(101);
} finally {
  session.close();
}

　　对于简单的增删改查，这只需要在Java中添加注解（复杂的映射文档中说了最好还是在XML中定义）

package org.mybatis.example;
public interface BlogMapper {
  @Select("SELECT * FROM blog WHERE id = #{id}")
  Blog selectBlog(int id);
}

　　当然，在ibatis中通过XML定义SQL语句映射的方式也是支持的。

　　XML映射文件是mybatis的重点。

<select id="selectPerson" parameterType="int" resultType="hashmap">
  SELECT * FROM PERSON WHERE ID = #{id}
</select>

　　跟ibatis很像有木有~不同的是这里用#{parameter}来表示映射字段 而ibatis中是#patameter#。而在JDBC中，你需要像这样来映射字段，并且在得到结果集后一一手动映射到对象。这就是Mybatis框架可以节省代码的地方。

　　在JDBC中是这样子的：

String selectPerson = "SELECT * FROM PERSON WHERE ID=? and name = ? and age = ?";
PreparedStatement ps = conn.prepareStatement(selectPerson);
ps.setInt(1,id);
ps.setString(2,name);
ps.setInt(3,age);
ResultSet res = ps.executeQuery();
while(res.next()){
　　Student stu = new Student();
　　stu.setId(res.getInt(1));
　　stu.setName(res.getString(2));
　　stu.setAge(res.getInt(3));
}

　　而Mybatis中是这样子的：

<typeAliases>
  <typeAlias alias="stu" type="domain.Student"/>
</typeAliases>
<select id="selectStudent" resultType="stu">
  select id, username, password
  from users
  where id = #{id}
</select>

　　除去标签占去的代码行数，当映射对象的属性更多时，代码量差距会更加明显。

　　select中可以设置属性，常用的就是id（命名空间中的唯一标识符，用来被引用）、parameterType（传入参数的完整包名或别名）、resultType（返回结果的完整报名或别名，不和resultMap同时使用）、resultMap（外部resultMap的命名引用，稍后会详细讲）、flushCache（清空缓存）、useCache（使用缓存）、timeout（等待数据库返回结果的最大时间）

　　对于Oracle，一般在插入中都需要获得主键，可以使用<selectKey>标签来获得主键ID。

<!--Mybatis中Oracle的主键使用方法 -->
<insert id="insertSMSInpojo" parameterType="SMSINPojo">
     <selectKey keyProperty="id" resultType="int">
          select s_sms_in.nextval from dual
     </selectKey>
     insert into sms_in(
            msgContent,
            mobile,
            destNO,
            linkId,
            curTime
     ) values(
            #msgContent#,
            #mobile#,
            #destNO#,
            #linkId#,
            #curTime#
     )
</insert>

　　对于参数映射，Mybatis中提供了强大的resultMap来支持。对于简单的查询(列名与属性名一一对应)，你可以使用hashmap或pojo类来实现

<!-- In mybatis-config.xml file -->
<typeAlias type="com.someapp.model.User" alias="User"/>

<!-- In SQL Mapping XML file -->
<select id="selectUsers" resultType="User">
  select id, username, hashedPassword
  from some_table
  where id = #{id}
</select>

or use this 

<select id="selectUsers" resultType="map">
  select id, username, hashedPassword
  from some_table
  where id = #{id}
</select>

　　如果列明没有精确匹配，可以通过 as 来设置别名

<select id="selectUsers" resultType="User">
  select
    user_id             as "id",
    user_name           as "userName",
    hashed_password     as "hashedPassword"
  from some_table
  where id = #{id}
</select>

　　或是通过更强大的resultMap来解决，因为实现了列名和属性名分离，更易于在不同语句中重用。

<resultMap id="userResultMap" type="User">
  <id property="id" column="user_id" />
  <result property="username" column="user_name"/>
  <result property="password" column="hashed_password"/>
</resultMap>

<select id="selectUsers" resultMap="userResultMap">
  select user_id, user_name, hashed_password
  from some_table
  where id = #{id}
</select>

　　

　　而且不仅是代码量的差距，我也相信你一定维护过像这样 逗号，拼接 的代码：

public void insertIntoHddx(TbSmsSync tbsyncpojo, SmsTaskPojo smstask, int num, String optionList) {
        String hddxSql = "insert into sms_hddx values(";
        hddxSql += tbsyncpojo.getTaskId() + ",";
        hddxSql += "'" + smstask.getTaskName() + "',";
        hddxSql += "'" + tbsyncpojo.getMsgContent() + "',";
        hddxSql += "0 ,";
        hddxSql += "to_date('" + smstask.getSendTime() + "','yyyy-mm-dd hh24:mi:ss') ,";
        hddxSql += num + ")";
        String[] items = optionList.split(";");
        for (String item : items) {
            String[] itemIdAndName = item.split(",");
            String itemId = itemIdAndName[0];
            String itemName = itemIdAndName[1];
            String searchItemSql = "insert into sms_hddx_option values(";
            searchItemSql += "'" + itemId + "',";
            searchItemSql += "'" + itemName + "',";
            searchItemSql += "0,";
            searchItemSql += tbsyncpojo.getTaskId() + ")";
            JdbcTemplate template = dbTemplate.getJdbcTemplate();
            template.execute(searchItemSql);
        }
        JdbcTemplate template = dbTemplate.getJdbcTemplate();
        template.execute(hddxSql);
    }

　　或是这样 #动态字段映射# 的代码

public PageInfo showTasks(SearchSMS searchSMS, int page) {
        String sql = "select id from SMS_TASK sms_task where id = ? " 
        }
        if (StringUtils.isNotBlank(searchSMS.getEndtime())) {
            sql += "and   createtime < to_date('" + searchSMS.getEndtime() + "','yyyy-mm-dd') + 1 ";
        }
        if (StringUtils.isNotBlank(searchSMS.getSendContent())) {
            sql += "and id in (select TASKID from SMS_SYNC where TASKID=sms_task.id  and msgcontent like '%" + searchSMS.getSendContent() + "%')";
        }
        if (StringUtils.isNotBlank(searchSMS.getSendPhone())) {
            sql += "and id in (select TASKID from SMS_SYNC where TASKID=sms_task.id  and mobile like '%" + searchSMS.getSendPhone() + "%')";
}

　　你一定感受过为了一个逗号而抓狂的经历，拼接的时候提醒自己一定不能忘了添加前后的空格和删除句末的逗号。

　　幸运的是，通过动态SQL这样的问题在Mybatis中不复存在。通过<where>来智能识别语句前后的and/or，<set>来识别语句前后的逗号，或使用<trim>来自定义实现。

　　通过<if test>来判断字段是否为空，<choose><when><otherwise>来实现类似switch……case的效果，<foreach>来实现集合的遍历，这里介绍了动态SQL。

　  总结：Mybatis框架优越之处在于使用XML映射文件替代了JDBC中手工设置属性，降低SQL代码耦合性，将动态SQL与其他Java代码分离，使得代码看起来更加整洁并有利于重用；提供缓存、自动映射功能，并通过一系列设置合理的默认值来简化开发者的工作。