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属性名之间作一个映射关系。
