Source/plt-web/plt-web-parent/plt-web/src/main/java/com/vci/frameworkcore/compatibility/SmUserQueryServiceI.java

@@ -1,13 +1,12 @@
package com.vci.frameworkcore.compatibility;

import com.vci.frameworkcore.pagemodel.SmPasswordStrategyVO;
import com.vci.frameworkcore.pagemodel.SmUserVO;
import com.vci.dto.SmUserDTO;
import com.vci.corba.common.PLException;
import com.vci.pagemodel.SmUserVO;
import com.vci.starter.web.exception.VciBaseException;
import com.vci.starter.web.pagemodel.DataGrid;
import com.vci.starter.web.pagemodel.PageHelper;
import com.vci.starter.web.pagemodel.Tree;
import com.vci.starter.web.pagemodel.TreeQueryObject;
import com.vci.starter.web.pagemodel.*;

import java.io.File;
import java.util.Collection;
import java.util.List;
import java.util.Map;
@@ -20,6 +19,14 @@
 * @date 2020/3/1
 */
public interface SmUserQueryServiceI{

    /**
     * 检查用户是否存在，可以根据用户名，也可以根据用户oid
     * @param userName  传null，即用oid作为检查条件
     * @param oid    传null，即用userName作为检查条件
     * @return true存在，false不存在
     */
    boolean checkUserExist(String userName,String oid) throws PLException;

    /**
     *  根据用户名获取用户的对象，不区分大小写
@@ -54,13 +61,12 @@
    List<SmUserVO> listUserByUserOids(Collection<String> userOidCollections) throws VciBaseException;

    /**
     * 获取用户的列表，默认会以用户名升序排列，用户的编辑页面列表不要使用这个接口
     * @param queryMap 查询条件
     * @param pageHelper 分页和排序的信息，在兼容老平台的时候会自动兼容，如果属性不存在会自动忽略
     * @return 用户的显示对象列表
     * @throws VciBaseException 参数为空的时候会抛出异常
     * 用户管理界面分页查询
     * @param conditionMap 查询条件
     * @param pageHelper 分页参数
     * @return
     */
    DataGrid<SmUserVO> gridUsers(Map<String, String> queryMap, PageHelper pageHelper) throws VciBaseException;
    DataGrid<SmUserVO> getDataGridUsers(Map<String, String> conditionMap, PageHelper pageHelper) throws PLException;

    /**
     * 根据用户名获取用户的姓名
@@ -77,6 +83,23 @@
    String getUserNameByUserOid(String userOid);

    /**
     * 批量根据部门的主键获取用户
     * @param deptOidCollection 部门的主键集合
     * @return 部门主键和对应的用户显示对象列表的映射，key部门的主键，value是这个部门下的用户
     * @throws VciBaseException 参数为空或者查询出错的时候会抛出异常
     */
    Map<String,List<SmUserVO>> batchListUserByDeptOids(Collection<String> deptOidCollection) throws VciBaseException;

    /**
     * 统计部门下的用户：包含子部门下的用户
     * @param deptOid
     * @param queryMap
     * @return
     * @throws VciBaseException
     */
    List<SmUserVO> countSmUserByDeptOid(String deptOid, Map<String, String> queryMap) throws VciBaseException;

    /**
     * 查询某个部门下的用户对象
     * @param deptOid 部门的主键
     * @param queryMap 查询条件，如果是部门的某个属性作为查询条件，则可以使用pkDepartment.xxx这样的方式
@@ -84,24 +107,6 @@
     * @throws VciBaseException 参数为空或者查询出错的时候会抛出异常
     */
    List<SmUserVO> listUserByDeptOid(String deptOid, Map<String, String> queryMap) throws VciBaseException;

    /**
     * 查询某个部门下的用户对象列表
     * @param deptOid 部门的主键
     * @param queryMap 查询条件，如果是部门的某个属性作为查询条件，则可以使用pkDepartment.xxx这样的方式
     * @param pageHelper 分页和排序信息，默认使用用户名升序排列
     * @return 用户的显示对象列表，默认使用用户名升序排列
     * @throws VciBaseException 参数为空或者查询出错的时候会抛出异常
     */
    DataGrid<SmUserVO> gridUserByDeptOid(String deptOid, Map<String, String> queryMap, PageHelper pageHelper) throws VciBaseException;

    /**
     * 批量根据部门的主键获取用户
     * @param deptOidCollection 部门的主键集合
     * @return 部门主键和对应的用户显示对象列表的映射，key部门的主键，value是这个部门下的用户
     * @throws VciBaseException 参数为空或者查询出错的时候会抛出异常
     */
    Map<String,List<SmUserVO>> batchListUserByDeptOids(Collection<String> deptOidCollection) throws VciBaseException;

    /**
     * 查询不在某个部门下的用户对象列表
@@ -113,33 +118,13 @@
    List<SmUserVO> listUserUnInDeptOid(String deptOid, Map<String, String> queryMap) throws VciBaseException;

    /**
     * 查询不在某个部门下的用户对象列表
     * @param deptOid 部门的主键
     * @param queryMap 查询条件，如果是部门的某个属性作为查询条件，则可以使用pkDepartment.xxx这样的方式
     * @param pageHelper 分页和排序信息，默认使用用户名升序排列
     * @return 用户的显示对象列表，默认使用用户名升序排列
     * @throws VciBaseException 参数为空或者查询出错的时候会抛出异常
     */
    DataGrid<SmUserVO> gridUserUnInDeptOid(String deptOid, Map<String, String> queryMap, PageHelper pageHelper) throws VciBaseException;

    /**
     * 查询某个角色下的用户对象
     *  查询某个角色下的用户对象列表
     * @param roleOid 角色的主键
     * @param queryMap 查询条件，如果是角色的某个属性作为查询条件，则可以使用pkRole.xxx这样的方式
     * @return 用户的显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候会抛出异常
     */
    List<SmUserVO> listUserByRoleOid(String roleOid, Map<String, String> queryMap) throws VciBaseException;

    /**
     * 查询某个角色下的用户对象列表
     * @param roleOid 角色的主键
     * @param queryMap 查询条件，如果是角色的某个属性作为查询条件，则可以使用pkRole.xxx这样的方式
     * @param pageHelper 分页和排序信息，默认使用用户名升序排列
     * @return 用户的显示对象列表，默认使用用户名升序排列
     * @throws VciBaseException 参数为空或者查询出错的时候会抛出异常
     */
    DataGrid<SmUserVO> gridUserByRoleOid(String roleOid, Map<String, String> queryMap, PageHelper pageHelper) throws VciBaseException;

    /**
     * 查询不在某个角色下的用户对象列表
@@ -149,16 +134,6 @@
     * @throws VciBaseException 参数为空或者查询出错的时候会抛出异常
     */
    List<SmUserVO> listUserUnInRoleOid(String roleOid, Map<String, String> queryMap) throws VciBaseException;

    /**
     * 查询不在某个角色下的用户对象列表
     * @param roleOid 角色的主键
     * @param queryMap 查询条件，如果是角色的某个属性作为查询条件，则可以使用pkRole.xxx这样的方式
     * @param pageHelper 分页和排序信息，默认使用用户名升序排列
     * @return 用户的显示对象列表，默认使用用户名升序排列
     * @throws VciBaseException 参数为空或者查询出错的时候会抛出异常
     */
    DataGrid<SmUserVO> gridUserUnInRoleOid(String roleOid, Map<String, String> queryMap, PageHelper pageHelper) throws VciBaseException;

    /**
     * 批量根据角色的主键获取用户
@@ -184,6 +159,16 @@
     * @throws VciBaseException 查询出错的时候会抛出异常
     */
    List<Tree> refTreeUsers(TreeQueryObject treeQueryObject) throws VciBaseException;

    /***
     * 人员权限选择树
     * @param treeQueryObject
     * @return
     * @throws VciBaseException
     */
    List<Tree> refPersonOrgTree(TreeQueryObject treeQueryObject) throws VciBaseException;


    /**
     * 校验密码是否相同，在新平台中存储的密码是两次md5
     * @param userOid 用户主键
@@ -201,14 +186,6 @@
    boolean checkUserLock(SmUserVO smUserVO, Integer wrongCount);

    /**
     * 根据用户的主键，获取用户的密码安全策略
     * @param userOid 用户的主键
     * @return 密码安全策略的显示对象，如果不存在则会返回Null
     * @throws VciBaseException 参数为空或者数据库查询出错的时候会抛出异常
     */
    SmPasswordStrategyVO getPasswordStrategyVOByUserOid(String userOid) throws VciBaseException;

    /**
     * 设置某个用户是锁定状态
     * @param userId 用户名
     */
@@ -223,10 +200,11 @@
    /**
     * 修改密码
     * @param userOid 用户主键
     * @param oldPassword 旧的密码
     * @param password 新的密码
     * @param confirmPassword 确认密码
     */
    void changePassword(String userOid, String password, String confirmPassword) throws VciBaseException;
    boolean changePassword(String userOid,String oldPassword, String password, String confirmPassword) throws Exception;

    /**
     * 更新用户的密码错误次数
@@ -243,4 +221,48 @@
     */
    void updateUserLoginTime(String userOid) throws VciBaseException;

    /**
     * 添加用户
     * @param smUserDTO
     * @return
     */
    boolean addUser(SmUserDTO smUserDTO) throws PLException;

    /**
     * 修改用户
     * @param smUserDTO
     * @return
     */
    boolean updateUser(SmUserDTO smUserDTO) throws PLException;

    /**
     * 删除用户
     * @param ids
     * @return
     */
    boolean deleteUser(String[] ids) throws PLException;

    /**
     * 用户停用/启用
     * @param ids
     * @param flag
     * @return
     */
    boolean stopUsers(String[] ids,boolean flag) throws PLException;

    /**
     * 下载导入人员的excel模板。
     * @param downloadFileName
     * @return
     */
    String downloadImportTemplate(String downloadFileName);

    /**
     * 导入成员
     * @param file
     * @return
     * @throws VciBaseException
     */
    BaseResult importUser(File file) throws Exception;

}