基础：映射文件Mapper.xml

关于

Mapper.xml映射文件中定义了操作数据库的sql，每个sql是一个statement，映射文件是mybatis的核心。

1. 输入映射的类型可以是简单类型、hashmap、pojo的包装类型；
2. 输出映射的类型可以是简单类型、hashmap、pojo的包装类型；

输入映射

parameterType

简单类型

略

pojo对象

• Mybatis使用ognl表达式解析对象字段的值

UserMapper.xml：

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

UserMapperTest.java：

	Public void testFindUserByUser()throws Exception{
		//获取session
		SqlSession session = sqlSessionFactory.openSession();
		//获限mapper接口实例
		UserMapper userMapper = session.getMapper(UserMapper.class);
        
		//构造查询条件user对象
		User user = new User();
		user.setId(1);
		user.setUsername("管理员");
		//传递user对象查询用户列表
		List<User>list = userMapper.findUserByUser(user);
        
		//关闭session
		session.close();
	}

Note：

1. Mapper中#{}或${}中的内容，与pojo对象的属性对应；

pojo包装对象

开发中通过pojo传递查询条件 ，查询条件是综合查询条件，这时可以使用包装对象传递输入参数。
如，将用户信息、用户购买商品信息都作为查询条件：

User.java：
（用户类，略）

UserCustom.java：（用户扩展类）

public class UserCustom extends User{
	//可以扩展用户的信息
}

UserQueryVo.java：（包装类）

public class UserQueryVo {
	
	//用户信息
	private User user;
	
	//自定义用户扩展类
	private UserCustom userCustom;
	
	//可以包装其它的查询条件，订单、商品
	//....
}

UserMapper.xml：

	<!— 查询用户列表 -->
	<select id="findUserList" parameterType="UserQueryVo" resultType="user">
	   select * from user where username = #{user.username} and sex = #{user.sex}
	</select>

UserMapperTest.java：
（测试类，略）

Note：

1. “UserQueryVo”、“user”均为设置的别名；
2. “#{user.username}”中，user即是传入的包装对象的属性，username为user的属性；

hashmap

UserMapper.xml：

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

UserMapperTest.java：

	Public void testFindUserByHashmap()throws Exception{
		//获取session
		SqlSession session = sqlSessionFactory.openSession();
		//获限mapper接口实例
		UserMapper userMapper = session.getMapper(UserMapper.class);
        
		//构造查询条件Hashmap对象
		HashMap<String, Object> map = new HashMap<String, Object>();
		map.put("id", 1);
		map.put("username", "管理员");
		
		//传递Hashmap对象查询用户列表
		List<User>list = userMapper.findUserByHashmap(map);
		//关闭session
		session.close();
	}

Note：

1. 传入参数类型“parameterType”为“hashmap”；
2. “#{id}”、“${username}%”分别为hashmap的两个键值对；
3. 测试类中的接口参数为“HashMap”；

输出映射

resultType

• 生成的动态代理对象（接口实现类）：根据mapper方法的返回值类型，确定调用selectOne还是selectList。

简单类型

略

pojo对象

略

pojo列表

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

UserMapper.xml：

	<!-- 根据名称模糊查询用户信息 -->
	<select id="findUserByUsername" parameterType="string" resultType="user">
	   select * from user where username like '%${value}%'
	</select>

UserMapper.java：（接口方法）

	public List<User> findUserByUsername(String username) throws Exception;

UserMapperTest.java：

	Public void testFindUserByUsername()throws Exception{
		//获取session
		SqlSession session = sqlSessionFactory.openSession();
		//获限mapper接口实例
		UserMapper userMapper = session.getMapper(UserMapper.class);
        
		//如果使用占位符号则必须人为在传参数中加%
		//List<User> list = userMapper.selectUserByName("%管理员%");
		//如果使用${}原始符号则不用人为在参数中加%
		List<User> list = userMapper.findUserByUsername("管理员");
        
		//关闭session
		session.close();
	}

Note：

1. 如果使用#{}占位符号则必须在传参数中加%：userMapper.selectUserByName("%管理员%");
2. 如果使用${}原始符号则不用在参数中加%：userMapper.findUserByUsername("管理员");

hashmap

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

【？？？】
UserMapper.xml：【？？？】

	<!-- 根据id查询用户信息 -->
	<select id="findUserNameById" parameterType="int" resultType="hashmap">
		select username from user where id = #{id}
	</select>

UserMapper.java：

	public HashMap<String, String> findUserNameById(int id) throws Exception;

UserMapperTest.java：【？？？】

	Public HashMap<String, String> testFindUserNameById() throws Exception {
		//获取session
		SqlSession session = sqlSessionFactory.openSession();
        
		//获限mapper接口实例
		UserMapper userMapper = session.getMapper(UserMapper.class);
		//通过mapper接口调用statement
		HashMap<String, String> map = userMapper.findUserNameById(1);
		System.out.println(map.get("username"));
        
		//关闭session
		session.close();
	}

resultMap

resultType可以指定pojo将查询结果映射为pojo，但需要pojo的属性名和sql查询的列名一致方可映射成功。
    
如果sql查询字段名和pojo的属性名不一致，可以通过resultMap将字段名和属性名作一个对应关系 ，resultMap实质上还需要将查询结果映射到pojo对象中。
resultMap可以实现将查询结果映射为复杂类型的pojo，比如在查询结果映射对象中包括pojo和list实现一对一查询和一对多查询。

UserMapper.xml：

	<!-- 定义resultMap -->
	<resultMap type="user" id="userResultMap">
	 	<id column="id_" property="id"/>
		<result column="username_" property="username"/>
	</resultMap>

	...

	<!-- 使用resultMap进行输出映射 -->
	<select id="findUserByIdResultMap" parameterType="int" resultMap="userResultMap">
		SELECT id id_,username username_ FROM USER WHERE id=#{value}
	</select>

UserMapperTest.java：

	public List<User> findUserListResultMap() throws Exception;

Note：

标签	说明
<select id="" parameterType="" resultMap="">	resultMap：引用resultMap的id 如果这个resultMap在其它的mapper文件，前边需要加namespace
<resultMap type="" id="">	type：最终映射的pojo对象类型，可以使用别名 id：唯一标识resultMap
<id column="" property=""/>	<id ...>：定义唯一标识映射 <result ...>：定义普通名映射 column：sql语句的列名 property：最终映射的pojo对象类型（type="xxx"）的属性名
<result column="" property=""/>

动态sql

动态sql是mybatis核心，通过mybatis提供的各种标签方法实现动态拼接sql。

动态sql的标签

标签	说明	示例
<if>	判断 test：判断语句	UserMapper.xml： <sql id="query_user_where"> <where> <if test="userCustom!=null"> <if test="userCustom.sex!=null and userCustom.sex!=''"> and user.sex = #{userCustom.sex} </if> <if test="userCustom.username!=null and userCustom.username!=''"> and user.username LIKE '%${userCustom.username}%' </if> <if test="ids!=null"> <foreach collection="ids" item="user_id" open="AND (" close=")" separator="or"> <!-- 每次遍历需要拼接的串 --> id=#{user_id} </foreach> </if> </if> <where> </sql> ... <!-- 用户信息综合查询 --> <select id="findUserList" parameterType="UserQueryVo" resultType="UserCustom"> SELECT * FROM USER <!-- 引用一个或多个sql片段 --> <include refid="query_user_where"></include> </select> UserQueryVo.java： public class UserQueryVo { private User user; //用户扩展类 private UserCustom userCustom; //传入多个用户id private List<Integer> ids; ... }
<where>	条件标识 <where>可以自动去掉第一个and
<foreach>	使用foreach遍历传入sql的数组或List collection：指定输入对象中集合属性 item：遍历的对象 open：开始遍历时拼接的串 close：结束遍历时拼接的串 separator：遍历中的两个对象之间需要拼接的串
<sql>块	将重复的sql提取出来，使用时用include引用即可，最终达到sql重用的目的 id：块唯一标识sql
<include>	引用<sql>块 refid：引用的sql块id，格式“namespace.sql片段id” （sql块可以位于其他namespace）