mybatis学习笔记（五）- MyBatis 映射文件(参数处理)

注意：本篇笔记内容承接上一篇

参数处理

1. 单个参数&多个参数&命名参数

简介

1. 单个参数：mybatis不会做特殊处理，

   • #{参数名/任意名}：取出参数值。

2. 多个参数：mybatis会做特殊处理。

   • 多个参数会被封装成 一个map，

     • key：param1…paramN,或者参数的索引也可以
     • value：传入的参数值

   • #{}就是从map中获取指定的key的值；

   • 异常：
     org.apache.ibatis.binding.BindingException:
     Parameter ‘id’ not found.
     Available parameters are [1, 0, param1, param2]

   • 操作：

     • 方法：public Employee getEmpByIdAndLastName(Integer id,String lastName);
     • 取值：#{id},#{lastName}

3. 【命名参数】：

   • 明确指定封装参数时map的key；@Param(“id”)
     多个参数会被封装成 一个map，
     • key：使用@Param注解指定的值
     • value：参数值
   • #{指定的key}取出对应的参数值

具体操作

1. 在上述 EmployeeMapper 中添加

    public Employee getEmpByIdAndLastName(@Param("id")Integer id,@Param("lastName")String lastName);

2. 在 EmployeeMapper.xml 中加入：

   <!--  public Employee getEmpByIdAndLastName(Integer id,String lastName);-->
   <select id="getEmpByIdAndLastName" resultType="www.xq.mybatis.bean.Employee">
   	select * from tbl_employee where id = #{id} and last_name=#{lastName}
   </select>
   

3. 测试：

@Test
public void test() throws IOException{
		SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();
		SqlSession openSession = sqlSessionFactory.openSession();
		try {
			EmployeeMapper mapper = openSession.getMapper(EmployeeMapper.class);
			Employee employee = mapper.getEmpByIdAndLastName(1,"Tom");
			System.out.println(employee);
		} finally {
			openSession.close();
		}
}

2. POJO&Map&TO

1. 在上述 EmployeeMapper 中添加

    public Employee getEmpByMap(Map<String, Object> map);

2. 在 EmployeeMapper.xml 中加入:

<select id="getEmpByMap" resultType="www.xq.mybatis.bean.Employee">
 		select * from ${tableName} where id=${id} and last_name=#{lastName}
 	</select>

3. 在 EmployeeMapper.xml 中加入

@Test
public void test() throws IOException{
		SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();
		SqlSession openSession = sqlSessionFactory.openSession();
		try {
			EmployeeMapper mapper = openSession.getMapper(EmployeeMapper.class);
			Map<String, Object> map = new HashMap<>();
			map.put("id", 2);
			map.put("lastName", "Tom");
			map.put("tableName", "tbl_employee");
			Employee employee = mapper.getEmpByMap(map);
			System.out.println(employee);
		} finally {
			openSession.close();
		}
}

4. 总结

• POJO：
  • 如果多个参数正好是我们业务逻辑的数据模型，我们就可以直接传入pojo；
  • #{属性名}：取出传入的pojo的属性值
• Map：
  • 如果多个参数不是业务模型中的数据，没有对应的pojo，不经常使用，为了方便，我们也可以传入map
  • #{key}：取出map中对应的值
• TO：
  • 如果多个参数不是业务模型中的数据，但是经常要使用，推荐来编写一个TO（Transfer Object）数据传输对象
  • Page{
    int index;
    int size;
    }

3. 参数值的获取

1. #与$取值区别

1. #{}：可以获取map中的值或者pojo对象属性的值；
2. ${}：可以获取map中的值或者pojo对象属性的值；
3. 举例：
   • select * from tbl_employee where id=${id} and last_name=#{lastName}
   • Preparing: select * from tbl_employee where id=2 and last_name=?
4. 区别：
   • #{}:是以预编译的形式，将参数设置到sql语句中；PreparedStatement；防止sql注入
   • ${}:取出的值直接拼装在sql语句中；会有安全问题；
   • 大多情况下，我们去参数的值都应该去使用#{}；
5. 原生jdbc不支持占位符的地方我们就可以使用${}进行取值
   比如分表、排序。。。；按照年份分表拆分
   select * from ${year}_salary where xxx;
   select * from tbl_employee order by ${f_name} ${order}

2. #{} 更丰富的用法

• 规定参数的一些规则：
  • javaType、 jdbcType、 mode（存储过程）、 numericScale、
    resultMap、 typeHandler、 jdbcTypeName、 expression（未来准备支持的功能）；
  • jdbcType通常需要在某种特定的条件下被设置：
    在我们数据为null的时候，有些数据库可能不能识别mybatis对null的默认处理。比如Oracle（报错）；
  • JdbcType OTHER：无效的类型；因为mybatis对所有的null都映射的是原生Jdbc的OTHER类型，oracle不能正确处理;
• 由于全局配置中：jdbcTypeForNull=OTHER；oracle不支持；两种办法
  1. #{email,jdbcType=OTHER};
  2. jdbcTypeForNull=NULL