Spring+SpringMVC+MyBatis深入学习及搭建(四)——MyBatis输入映射与输出映射

转载请注明出处：http://www.cnblogs.com/Joanna-Yan/p/6878529.html 

前面有讲到Spring+SpringMVC+MyBatis深入学习及搭建(三)——MyBatis全局配置文件解析

1. 输入映射

通过parameterType指定输入参数的类型，类型可以是简单类型、hashmap、pojo的包装类型。

1.1 #{}与${}

#{}实现的是向prepareStatement中的预处理语句设置参数值，sql语句中#{}表示一个占位符即?

<select id="findUserById" parameterType="int" resultType="user">
   select * from user where id=#{id}
</select>

使用占位符#{}可以有效防止sql注入，在使用时不需要关系参数值的类型，mybatis会自动进行java类型和jdbc类型的转换。#{}可以接收简单类型值或pojo属性值，如果parameterType传输单个类型值，#{}括号可以是value或其它名称。

${}和#{}不同，通过${}可以将parameterType传入的内容拼接在sql中且不进行jdbc类型转换，${}可以接收简单类型值或pojo属性值，如果parameterType传输单个简单类型值，${}括号中只能是value。使用${}不能防止sql注入，但是有时用${}会非常方便，如下例子：

    <select id="findUserByName" parameterType="java.lang.String" resultType="joanna.yan.mybatis.entity.User">
        select * from user where username LIKE '%${value}%'
    </select>

如果本例子使用#{}则传入的字符串中必须要有%，而%是人为拼接在参数中，显然有点麻烦，如果采用${}在sql中拼接为%的方式则在调用mapper接口传递参数就方便很多。

//如果使用占位符号则必须人为在传参数中加%
List<User> list = userMapper.selectUserByName("%管理员%");

//如果使用${}原始符号则不用人为在参数中加%
List<User>list = userMapper.selectUserByName("管理员");

再比如order by排序，如果将列名通过参数传入sql，根据传的列名进行排序，应该写为：ORDER BY ${columnName}

如果使用#{}将无法实现此功能。

1.2 传递简单类型

参考上边的例子。

1.3 传递pojo对象

mybatis使用ognl表达式解析对象字段的值，如下例子：

     <!--传递pojo对象综合查询用户信息  -->
     <select id="findUserByUser" parameterType="user" resultType="user">
         select * from user where id=#{id} and username like '%${username}%'
     </select>

sql中红色标注的是user对象中的字段名称。

测试：

    @Test
    public void findUserByUserTest() throws Exception{
        SqlSession sqlSession=sqlSessionFactory.openSession();
        UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
        User user=new User();
        user.setId(10);
        user.setUsername("张三");
        List<User> list=userMapper.findUserByUser(user);
        System.out.println(list);
        sqlSession.close();
    }

1.4 传递pojo包装对象

开发中通过pojo传递查询条件，查询条件是综合的查询条件，不仅包括用户查询条件，还包括其它的查询条件（比如将用户购买的商品信息也作为查询条件），这时可以使用包装对象传递输入参数。

1.4.1 需求

完成用户信息的综合查询，需要传入查询条件很复杂（可能包括用户信息、其它信息，比如商品、订单等）

1.4.2 定义包装类型pojo

针对上边需求，建议使用自定义的包装类型的pojo，在包装类型的pojo中将复杂的查询条件包装进去。

/**
 * 包装类型
 * @author Joanna.Yan
 *
 */
public class UserQueryVo {
    //在这里包装所需要的查询条件
    
    //用户查询条件
    private UserCustom userCustom;

    public UserCustom getUserCustom() {
        return userCustom;
    }

    public void setUserCustom(UserCustom userCustom) {
        this.userCustom = userCustom;
    }
    
    //可以包装其它的查询条件，订单、商品
    //......
}

1.4.3 mapper.xml

 在UserMapper.xml中定义用户信息综合查询（查询条件复杂，通过高级查询进行复杂关联查询）

    <!--用户信息综合查询 
    UserQueryVo中定义了userCustom属性
    #{userCustom.sex}:取出pojo包装对象中性别值
    ${userCustom.username}:取出pojo包装对象中用户名称
     -->
    <select id="findUserList" parameterType="joanna.yan.mybatis.entity.UserQueryVo" resultType="joanna.yan.mybatis.entity.UserCustom">
        SELECT * FROM USER WHERE user.sex=#{userCustom.sex} AND user.username LIKE '%${userCustom.username}%'
    </select>

1.4.4 mapper.java

//用户信息综合查询
public List<UserCustom> findUserList(UserQueryVo userQueryVo) throws Exception;

1.4.5 测试代码

    @Test
    public void findUserListTest() throws Exception{
        SqlSession sqlSession=sqlSessionFactory.openSession();
        UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
        //创建包装对象，设置查询条件
        UserQueryVo userQueryVo=new UserQueryVo();
        UserCustom userCustom=new UserCustom();
        userCustom.setSex("1");
        userCustom.setUsername("张三丰");
        userQueryVo.setUserCustom(userCustom);
        List<UserCustom> list=userMapper.findUserList(userQueryVo);
        System.out.println(list);
    }

1.5 传递hashmap

sql映射文件定义如下：

    <!--传递hashmap综合查询用户信息  -->
    <select id="findUserByHashmap" parameterType="hashmap" resultType="user">
        select * from user where id=#{id} and username like '%${username}%'
    </select>

sql中红的标注的是hashmap的key。

mapper.java:

//传递hashmap综合查询用户信息
 public List<User> findUserByHashmap(HashMap<String, Object> map) throws Exception;

测试：

    @Test
    public void findUserByHashmapTest() throws Exception{
        SqlSession sqlSession=sqlSessionFactory.openSession();
        UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
        //构造查询条件HashMap对象
        HashMap<String, Object> map=new HashMap<>();
        map.put("id", 10);
        map.put("username", "张三");
        //传递HashMap对象查询用户列表
        List<User> list=userMapper.findUserByHashmap(map);
        System.out.println(list);
        sqlSession.close();
    }

传递的map中的key和sql中解析的key不一致时，不会报错，只是通过key获取的值为空。

2. 输出映射

2.1 输出简单类型

看下边的例子，输出整型，mapper.xml文件：

    <!--获取用户列表总数  -->
    <select id="findUserCount" parameterType="user" resultType="int">
        select count(*) from user
    </select>

mapper接口：

public interface UserMapper {
    //获取用户列表总数
    public int findUserCount(User user) throws Exception;
}

测试：

　　@Test
    public void findUserCountTest() throws Exception{
        SqlSession sqlSession=sqlSessionFactory.openSession();
        //创建UserMapper对象，mybatis自动生成mapper代理对象
        UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
        User user=new User();
        user.setUsername("yan");
        //调用userMapper的方法
        int count=userMapper.findUserCount(user);
        System.out.println(count);
        sqlSession.close();
    }

总结：

查询出来的结果集只有一行且一列，可以使用简单类型进行输出映射。

2.2 输出pojo对象和pojo列表

不管是输出的pojo单个对象还是一个列表（list中包括pojo），在mapper.xml中resultType指定的类型是一样的。

在mapper.java指定的方法返回值类型不一样：

（1）输出单个pojo对象，方法返回值是单个对象类型。

（2）输出pojo对象list，方法返回值是List<POJO>

生成的动态代理对象中是根据mapper方法的返回值类型确定是调用session.selectOne（返回单个对象调用）还是session.selectList（返回集合对象调用）。

2.3 resultType总结

使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。

如果查询出来的列名和pojo中的属性名全部不一致，则不会创建pojo对象。

只要查询出来的列名和pojo中的属性有一个一致，就会创建pojo对象。

2.4 输出hashmap

输出pojo对象可以改用hashmap输出类型，将输出的字段名称作为map的key，value为字段值。

2.5 resultMap

resultType可以指定将查询结果映射为pojo，但需要pojo的属性名和sql查询的列名一致才可映射成功。

如果sql查询字段名和pojo的属性名不一致，可以通过resultMap将字段名和属性名作一个对应关系，resultMap实质上还需要将查询结果映射到pojo对象中。

resultMap可以实现将查询结果映射为复杂类型的pojo，比如在查询结果映射对象中包括pojo和list实现实现一对一查询和一对多查询。

2.5.1 resultMap使用方法

如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。

（1）定义resultMap

（2）使用resultMap作为statement的输出映射类型。

2.5.2 将下边的sql使用User完成映射

SELECT id id_,username username_ FROM USER WHERE id=#{value}

改sql对查询结果的列名进行了重新命名:

User类中属性名和上边查询列名不一致。

2.5.2.1 定义resultMap

    <!--定义resultMap
        将SELECT id id_,username username_ FROM USER和User类中的属性作一个映射关系。
          type:resultMap最终映射的java对象类型，可以使用别名
          id:对resultMap的唯一标识
      -->
    <resultMap type="user" id="userResultMap">
        <!--id表示查询结果集中唯一标识
            column：查询出来的列名
            property：type指定的pojo类型中的属性名
                    最终resultMap对column和property作一个映射关系（对应关系）
          -->
        <id column="id_" property="id"/>
        <!--result:对普通名映射定义
            column:查询出来的列名
            property：type指定的pojo类型中的属性名
                    最终resultMap对column和property作一个映射关系（对应关系）
          -->
        <result column="username_" property="username"/>
    </resultMap>

2.5.2.2 使用resultMap作为statement的输出映射类型

    <!--使用resultMap进行输出映射
        resultMap：指定定义的resultMap的id,如果这个resultMap在其它的mapper文件，前边需要加namespace
      -->
    <select id="findUserByIdResultMap" parameterType="int" resultMap="userResultMap">
        SELECT id id_,username username_ FROM USER WHERE id=#{value}
    </select>

2.5.2.3 mapper.java

    //根据id查询用户信息，使用resultMap输出
    public User findUserByIdResultMap(int id) throws Exception;

2.5.2.4 测试

    @Test
    public void findUserByIdResultMapTest() throws Exception{
        SqlSession sqlSession=sqlSessionFactory.openSession();
        UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
        User user=userMapper.findUserByIdResultMap(1);
        System.out.println(user);
        sqlSession.close();
    }

2.6 小结

使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。

如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。

如果此文对您有帮助，微信打赏我一下吧~