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);
}