mybatis简单案例源码详细【注释全面】——Dao层接口（UserMapper.java）

 /**  
* @Title: IUserDao.java
* @Package org.dao
* @Description: TODO该方法的主要作用：
* @author A18ccms A18ccms_gmail_com  
* @date 2017-10-5 下午8:59:34
* @version V1.0  
*/
package org.dao;

import java.util.Date;
import java.util.List;
import java.util.Map;

import org.apache.ibatis.annotations.Param;
import org.entity.Users;

 /**   
 *    
 * 项目名称：ssm_chop1   
 * 类名称：IUserDao   
 * 类描述：   
 * 创建人：Mu Xiongxiong  
 * 创建时间：2017-10-5 下午8:59:34   
 * 修改人：Mu Xiongxiong   
 * 修改时间：2017-10-5 下午8:59:34   
 * 修改备注：   
 * @version    
 *    
 */
public interface UserMapper {
	/**
	 * 
	* @Description: 该方法的主要作用：查询所有的记录数
	* @Title: count
	* @param  @return 设定文件  
	* @return  返回类型：int   
	* @throws
	 */
	int count();

	/**
	 * 
	* @Description: 该方法的主要作用：查询所有的用户
	* @Title: getUserList
	* @param  @return 设定文件  
	* @return  返回类型：List<Users>   
	* @throws
	 */
	List<Users> getUserList();
	
	/**
	 * 
	* @Description: 该方法的主要作用：根据用户名进行模糊查询信息
	* @Title: getUsersByName
	* @param  @param name
	* @param  @return 设定文件  
	* @return  返回类型：Users   
	* @throws
	 */
	Users getUsersByName(String name);
	
	/**
	 * 
	* @Description: 该方法的主要作用：查询用户列表（参数是对象）
	* @Title: getUserListByUser
	* @param  @return 设定文件  
	* @return  返回类型：List<Users>   
	* @throws
	 */
	List<Users> getUserListByUser(Users users);
	
	/**
	 * 
	* @Description: 该方法的主要作用：查询用户列表（参数是Map集合）
	* @Title: getUsersListByMap
	* @param  @param userMap
	* @param  @return 设定文件  
	* @return  返回类型：List<Users>   
	* @throws
	 */
	List<Users> getUsersListByMap(Map<String, String> userMap);

	/**
	 * 
	* @Description: 该方法的主要作用：通过用户表和角色表进行连接查询
	* @Title: getUserListAndRole
	* @param  @param users
	* @param  @return 设定文件  
	* @return  返回类型：List<Users>   
	* @throws
	 */
	List<Users> getUserListAndRole(Users users);

	/**
	 * 
	* @Description: 该方法的主要作用：添加用户
	* @Title: saveUser
	* @param  @param users
	* @param  @return 设定文件  
	* @return  返回类型：int   
	* @throws
	 */
	int saveUser(Users users);
	
	/**
	 * 
	* @Description: 该方法的主要作用：根据编号修改
	* @Title: updateUser
	* @param  @param users
	* @param  @return 设定文件  
	* @return  返回类型：int   
	* @throws
	 */
	int updateUser(Users users);
	
	/**
	 * 
	* @Description: 该方法的主要作用：根据编号进行删除数据
	* @Title: delUser
	* @param  @param id
	* @param  @return 设定文件  
	* @return  返回类型：int   
	* @throws
	 */
	int delUser(int id);
	
	/**
	 * 
	* @Description: 该方法的主要作用：根据id查询用户信息
	* @Title: getUsersById
	* @param  @param id
	* @param  @return 设定文件  
	* @return  返回类型：Users   
	* @throws
	 */
	Users getUsersById(int id);
	
	/**
	 * 
	* @Description: 该方法的主要作用：根据用户角色获取用户信息
	* @Title: getUsersByRoleId
	* @param  @param id
	* @param  @return 设定文件  
	* @return  返回类型：Users   
	* @throws
	 */
	List<Users> getUsersByRoleId(@Param("userrole")int id);
	 
	 /**
	  * 
	 * @Description: 该方法的主要作用：根据用户名和角色编号动态查询用户信息
	 * @Title: getUsersListByUserNameAndRole_if
	 * @param  @param userName
	 * @param  @param usertole
	 * @param  @return 设定文件  
	 * @return  返回类型：List<Users>   
	 * @throws
	  */
	 List<Users> getUsersListByUserNameAndRole_if(@Param("userName")String userName,@Param("userrole")Integer usertole);
	 
	 /**
	  * 
	 * @Description: 该方法的主要作用：动态根据用户名和角色id查询用户列表，where and|or
	 * @Title: getUsersListByUserNameAndRole_ifAndwhere
	 * @param  @param userName
	 * @param  @param usertole
	 * @param  @return 设定文件  
	 * @return  返回类型：List<Users>   
	 * @throws
	  */
	 List<Users> getUsersListByUserNameAndRole_ifAndwhere(@Param("userName")String userName,@Param("userrole")Integer usertole);

	 /**
	  * 
	 * @Description: 该方法的主要作用：使用if+set动态修改用户表信息
	 * @Title: updateUser_ifAndSet
	 * @param  @param users
	 * @param  @return 设定文件  
	 * @return  返回类型：int   
	 * @throws
	  */
	 int updateUser_ifAndSet(Users users);
	 
	 /**
	  * 
	 * @Description: 该方法的主要作用：使用trim进行查询用户信息
	 * @Title: getUsersListByUserNameAndRole_ifAndwhere_trim
	 * @param  @param userName
	 * @param  @param usertole
	 * @param  @return 设定文件  
	 * @return  返回类型：List<Users>   
	 * @throws
	  */
	 List<Users> getUsersListByUserNameAndRole_ifAndwhere_trim(@Param("userName")String userName,@Param("userrole")Integer usertole);
	 
	 /**
	  * 
	 * @Description: 该方法的主要作用：使用trim代替set进行动态修改用户信息
	 * @Title: updateUser_ifAndTrim
	 * @param  @param users
	 * @param  @return 设定文件  
	 * @return  返回类型：int   
	 * @throws
	  */
	 int updateUser_ifAndTrim(Users users);
	 
	 /**
	  * 
	 * @Description: 该方法的主要作用：根据用户角色列表，获取该角色刘表下用户列表信息foreach_array
	 * @Title: getUsersByRoleId_foreach_array
	 * @param  @param roleids
	 * @param  @return 设定文件  
	 * @return  返回类型：List<Users>   
	 * @throws
	  */
	 List<Users> getUsersByRoleId_foreach_array(Integer [] roleids);
	 
	 /**
	  * 
	 * @Description: 该方法的主要作用：根据用户角色列表，获取该角色刘表下用户列表信息foreach_list
	 * @Title: getUsersByRoleId_foreach_list
	 * @param  @param roleids
	 * @param  @return 设定文件  
	 * @return  返回类型：List<Users>   
	 * @throws
	  */
	 List<Users> getUsersByRoleId_foreach_list(List<Integer> roleids);
	 
	 /**
	  * 
	 * @Description: 该方法的主要作用：根据用户角色列表和性别（多参数），获取该角色刘表下用户列表信息foreach_map
	 * @Title: getUsersByRoleId_foreach_map
	 * @param  @param roleids
	 * @param  @return 设定文件  
	 * @return  返回类型：List<Users>   
	 * @throws
	  */
	 List<Users> getUsersByRoleId_foreach_many_map(Map<String, Object> conditionmap);
	 
	 /**
	  * 
	 * @Description: 该方法的主要作用：根据用户角色列表（单参数），获取该角色刘表下用户列表信息foreach_map
	 * @Title: getUsersByRoleId_foreach_one_map
	 * @param  @param conditionmap
	 * @param  @return 设定文件  
	 * @return  返回类型：List<Users>   
	 * @throws
	  */
	 List<Users> getUsersByRoleId_foreach_one_map(Map<String, Object> conditionmap);
	 
	 /**
	  * 
	 * @Description: 该方法的主要作用：查询用户列表，使用choose
	 * @Title: getUsersList_choose
	 * @param  @param userName
	 * @param  @param userrole
	 * @param  @param userCode
	 * @param  @return 设定文件  
	 * @return  返回类型：List<Users>   
	 * @throws
	  */
	 List<Users> getUsersList_choose(@Param("userName")String userName,
			 						 @Param("userrole")Integer userrole,
			 						 @Param("userCode")String userCode,
			 						 @Param("creationDate")Date creationDate
			 							);

	 /**
	  * 
	 * @Description: 该方法的主要作用：分页显示用户信息
	 * @Title: getUserList_page
	 * @param  @return 设定文件  
	 * @return  返回类型：List<Users>   
	 * @throws
	  */
	 List<Users> getUserList_page(@Param("from")Integer from,@Param("pageSize")Integer pageSize);
}