Mybatis的核心组成部分-SQL映射文件揭秘

Mybatis真正强大的地方在于SQL映射语句，这也是它的魅力所在。相对于它强大的功能，SQL映射文件的配置却很是简单，我上篇文章语句讲了Mybatis的搭建以及核心配置的讲解，接下来我们就一块儿来看看Mybatis另外一个重要的元素-SQL映射文件
首先先介绍一下SQL映射文件的几个顶级元素配置

顶级元素配置

• Mapper：映射文件的根元素节点，只有一个属性namespace（命名空间），其做用以下
  • 用于区分不一样的mapper，全局惟一
  • 绑定DAO接口，即面向接口编程。当namespace绑定某一接口以后，就能够不用写该接口的实现类，Mybatis会经过接口的完整限定名查找到对应的mapper配置来执行SQL语句。所以namespace的命名必需要跟接口名同名
• cache：配置给定命名空间引用缓存。
• cache-ref：从其余命名空间引用缓存配置
• resultMap：用来描述数据库结果集和对象的对象关系（键值对）
• sql：能够重用的sql块，也能够被其余语句引用。
• insert：映射插入的语句
• update：映射更新的语句
• delete：映射删除的语句
• select：映射查询的语句

接下来我就逐一的为你们介绍

select：映射查询语句

<!--根据用户名称查询用户列表（模糊查询）-->
    <select id="getUserListByUserName" resultType="User" parameterType="string">
        select * from user_info where userName like CONCAT('%',#{userName},'%')
    </select>

上面这段代码是一个id为getUserListByUserName的映射语句，参数类型为string，返回结果的类型是User，注意参数的传递使用#{参数名},它告诉Mybatis生成PreparedStatement参数，对于JDBC，该参数会被标识为“？”，若采用JDBC来实现，那代码就得换一下方式了

String sql="select * from user_info where userName like CONCAT('%',?,'%')";
    PreparedStatement ps=conn.preparedStatement(sql);
    ps.setString(1,userName);

从上面两端代码我相信你们都能看出区别，Mybatis节省了大量的代码，我相信你们会喜欢上它的
接下来我来介绍一下select映射语句中的家庭成员吧！

• id：命名空间中惟一的标识符，能够被用来引用这条语句
• parameter：表示查询语句传递参数的类型的彻底限定名或别名。它支持基础数据类型和复杂数据类型，就好比我们上面用到的string就是一个基础数据类型，固然你会发现这的string的s是小写，其实它只是一个别名，仍是表明String，只不过它属于一个内建的类型别名，那么以此类推，对于普通的Java类型，也有许多的内建类型别名，而且它们对大小写不明感，介意你们去阅读如下Mybatis的帮助文档。
• resultType:查询语句返回结果类型的彻底限定名或别名，别名的使用方式与parameterType的使用方式是一致的

接下来我就用一个实例来向你们演示一下
首先我弄了一个以用户名、用户角色来查询用户列表的功能，我们先建立UserMapper.java文件

public interface UserMapper {
        public List<User> getUserList(Map<String,String> userMap);
    }

从上面你们能够看到我用来一个集合来接受返回的结果集，而且传递的参数是一个user对象

下面再来编写UserMapper.xml文件的主体内容

<!--查询用户列表（参数：对象入参）-->
        <select id="getUserList" resultType="user" parameterType="Map">
                select u.*,r.roleName from smbms_user u,smbms_role r
                where u.userName like CONCAT('%',#{userName},'%')
                and u.userRole=#{userRole} and u.userRole=r.id
        </select>

上面即是我们这次测试的查询映射语句了，这和我在上面说的映射语句区别不大，惟一大点的区别就在于参数类型，这的参数类型我换成了一个Map集合。
接下来就能够去测试了。

@Test
    public void getUserList(){
        SqlSession sqlSession=null;
        List<User> userList=new ArrayList<User>();
        try{
            sqlSession=MyBatisUtil.createSqlSession();
            Map<String,String> userMap=new HashMap<String,String>();
            userMap.put("uName","赵");
            userMap.put("uRole","3");
            userList=sqlSession.getMapper(UserMapper.class).getUserListMap(userMap);
        }catch(Exception e){
            e.printStackTrace();
        }finally{
            MyBatisUtil,closeSqlSession(sqlSession);
        }
        for(User user:userList){
            logger.debug("testGetUserList userCode:"+user.getUserCode()+"and userName:"+user.getUserName());
        }
    }

resultMap

接下来讲说resultMap，咱们为何要用resultMap呢？
用小编的话说：当咱们要使用的查询映射语句是须要关联多表的时候，那么一个实体类的字段就不够用了，好比User表中有一个部门ID，而部门ID又对应了部门表，咱们想查询部门名称而不是查询部门ID，这时候咱们就要在User实体类中加入一个部门名称属性，且该属性的类型为部门实体类， 到这咱们就须要使用resultMap了

<select id="getUserList" resultMap="user" parameterType="Map">
                select u.*,r.roleName from smbms_user u,smbms_role r
                where u.userName like CONCAT('%',#{userName},'%')
                and u.userRole=#{userRole} and u.userRole=r.id
    </select>
        
    <resultMap id="userList" type="User">
                <result property="userRole" column="roleName"/>
    </resultMap>

resultMap元素用来描述如何将结果集映射到java对象，此处使用resultMap对列表展现所需的必要字段来进行自由映射。接下来看看resultMap元素的属性值和子节点吧

• id属性：惟一标识符，此id值用于select元素resultMap属性的引用
• type属性：表示该result的映射结果类型
• result子节点：用于标识一些简单属性，其中column属性表示从数据库中查询的字段名，property则表示查询出来的字段对应的值赋给实体对象的哪一个属性。

Mybatis中对查询进行select映射的时候，返回类型能够用resultType，也能够用resultMap，那么resultType和resultMap到底有何关联呢？接下里小编就作一下详细的讲解

resultType

resultType直接表示返回类型，包括基础数据库类型和复杂数据类型

resultMap

resultMap则是对外部resultMap定义的引用，对外部resultMap的ID，表示返回结果映射到哪个resultMap上，它的应用场景通常是：数据库字段信息与对象属性不一致或者须要作复杂的联合查询以便自由控制映射结果。

resultType与resultMap的关联

在Mybatis的select元素中，resultType和resultMap本质上是同样的，都是Map数据结构，但须要明确的一点：resultType属性和resultMap属性绝对不能同时存在，只能两者选其一。

接下来讲说使用Mybatis实现增删改的操做，其实这几个操做都大同小异（小编认为的）。

insert

<insert id="add" parameterType="User">
        INSERT INTO `smbms`.`smbms_user`(`userCode`, `userName`, `userPassword`, `gender`, `birthday`, `phone`, `address`, `userRole`, `createdBy`, `creationDate`)
        VALUES (#{userCode}, #{userName}, #{userPassword}, #{gender}, #{birthday}, #{phone}, #{address}, #{userRole}, #{createdBy}, #{creationDate})
    </insert>

update

<update id="modify" parameterType="User">
		update smbms_user set userCode=#{userCode} where id=#{uId}
</update>

delete

<delete id="del" parameterType="User">
		delete from smbms_user where id=#{id}
	</delete>

从上面的操做中能够看出其实这三种操做都差很少，其中的属性也都见过哈！那么小编在这就很少作介绍了，上面我所说的都是SQL映射文件最基础的一些东西，后面还有动态SQL之类的我在这就不作介绍了，感兴趣的童鞋能够去查查（我以为阔以），ok，以上就是本章所介绍的，感谢你们的观赏！