组织架构详细设计.doc

此文档收集于网络，如有侵权，请联系网站删除1 DAO层接口说明1.1 BaseDAO说明：/* * 根据参数持久对象对数据库进行增加或修改操作。 * * param functionID功能编号 * param obj实体类对象 * return 保存是否成功 */public boolean saveObj(String functionID, Object obj);/* * 根据参数持久对象对数据库进行修改操作。 * * param functionID功能编号 * param obj实体类对象 * return 保存是否成功 */public boolean updateObj(String functionID, Object obj);/* * 根据参数持久对象列表对数据库进行批量增加或修改操作。 * * param functionID功能编号 * param list实体类对象列表 * return 操作是否成功 */public boolean updateBatch(String functionID, List list);/* * 根据参数持久对象对数据库进行删除操作。 * * param functionID功能编号 * param obj实体类对象 * return 删除是否成功 */public boolean deleteObj(String functionID, Object obj);/* * 根据参数持久对象列表对数据库进行批量删除操作。 * * param list实体类对象列表 * return 批量删除是否成功 */public boolean deleteBatch(String functionID, List list);/* * 根据参数持久对象所对应的名称及OID（唯一标识符）对数据库进行查询操作。 * * param className实体类对象名称 * param id唯一标识符 * return 返回对应的实体类对象 */public Object findById(java.lang.String className, java.lang.String id);/* * 根据参数持久对象所对应的名称及具体的对象对数据库进行查询操作。 * * param className实体类对象名称 * param obj实体类对象 * return 返回对应的实体类对象 */public List findByExample(java.lang.String className, Object obj);/* * 根据参数持久对象所对应的名称取该持久化对象的数目。 当返回结果为-1时代表产生了异常。 * * param className实体类对象名称 * return 持久化对象的数目 */public int getObjectCount(java.lang.String className);/* * 取得用户列表 hqlHQL语句 firstResult游标初始位置 maxResults查询记录数 * args参数数组，如果没有参数，就传一个null。 */public List findObjectList(String hql, int firstResult, int maxResults,Object args);1.2 OrgFrameDAO的说明：/* * 返回数据库中id为userId的TOrgFrame，并加载其positionSet和userSet集合 * param orgId * return */public TOrgFrame fetchOrgFrame(String orgId);/* * 根据参数组织ID从数据库返回 TOrgFrame 实体类对象实例 * param orgId组织ID * return TOrgFrame 实体类对象 */public TOrgFrame findOrgFrameById(String orgId);/* * 根据参数组织名称从数据库返回 TOrgFrame * param orgName组织名称 * return TOrgFrame */public TOrgFrame findOrgFrameByName(String orgName);/* * 根据参数treeCode从数据库返回 TOrgFrame 实体类对象实例 * param treeCode组织名称 * return TOrgFrame 实体类对象 */public TOrgFrame findOrgFrameByTreeCode(String treeCode);/* * 根据参数机构代码从数据库返回 TOrgFrame 实体类对象实例 * param orgCode机构代码 * return 实体类对象 */public TOrgFrame findOrgFrameByOrgCode(String orgCode);/* * 根据参数领导ID从数据库返回 该领导ID负责的 TOrgFrame 列表 * param leaderId领导ID * return List */public List findOrgFramesByLeader(String leaderId);/* * 根据参数orgTypeId从数据库返回某种类型的 TOrgFrame 列表 * param orgTypeId * return List */public List findOrgFramesByOrgType(String orgTypeId);/* * 根据参数orgLevel从数据库返回某种级别的 TOrgFrame 列表 * param orgLevel * return List */public List findOrgFramesByOrgLevel(String orgLevel);/* * 根据参数orgId从数据库返回组织的所有子部门的 TOrgFrame 列表 * param orgId * return List */public List findChildrenOrgFrames(String orgId);/* * 根据参数orgId从数据库返回组织的所有子部门的 TOrgFrame 列表 * param state * param orgId * return List */public List findChildrenOrgFrames(String state,String orgId);/* * 根据参数orgId从数据库分页返回组织的子部门的 TOrgFrame 列表 * param state * param orgId * param firstResult游标初始位置 * param maxResults查询记录数 * return List */public List findChildrenOrgFrames(String state,String orgId,int firstResult,int maxResults);/* * 根据参数state从数据库返回状态为state的组织列表 * 从数据库返回所有的 TOrgFrame 列表 * return List */public List findOrgFrames(String state);/* * 根据参数state从数据库分页返回状态为state的TOrgFrame 列表 * param firstResult游标初始位置 * param maxResults查询记录数 * return List */public List findOrgFrames(String state,int firstResult,int maxResults);1.3 OrgPositionDAO的说明：/* * 返回数据库中id为positionId的TOrgPosition，并加载其userSet集合 * param positionId * return */public TOrgPosition fetchOrgPosition(String positionId);/* * 根据参数positionName返回TOrgPosition实体对象，如果不存在则返回null; * param positionName * return TOrgPosition */public TOrgPosition findOrgPositionByName(String positionName);/* * 返回数据库中所有的部门职位对象 * return List */public List findOrgPositions();/* * 分页返回数据库中所有的部门职位对象 * param firstResult * param maxResults * return List */public List findOrgPositions(int firstResult,int maxResults);/* * 根据参数orgId从数据库返回某部门的 TOrgPosition 列表 * param orgId * return List */public List findOrgPositionsByOrg(String orgId);/* * 根据参数orgId从数据库分页返回某部门的的 TOrgPosition 列表 * param orgId * param firstResult游标初始位置 * param maxResults查询记录数 * return List */public List findOrgPositionsByOrg(String orgId,int firstResult,int maxResults);1.4 OrgTypeDAO的说明：/* * 根据参数类型名称返回TOrgType实体对象，如果不存在则返回null; * param typeName * return TOrgType */public TOrgType findOrgTypeByName(String typeName);/* * 返回数据库中所有的部门类型对象 * return List */public List findOrgTypes();/* * 分页返回数据库中所有的部门类型对象 * param firstResult * param maxResults * return List */public List findOrgTypes(int firstResult,int maxResults);1.5 SecretaryDAO的说明：/* * 根据用户编号,userId，查找TSecretary实体对象 * param userId * return TSecretary实体对象 */public TSecretary findByUserId(String userId);/* * 返回数据库中所有的秘书对象 * return List */public List findSecretaries();/* * 分页返回数据库中所有的秘书对象 * param firstResult * param maxResults * return List */public List findSecretaries(int firstResult,int maxResults);1.6 SysGroupDAO的说明：/* * 返回数据库中id为groupId的TSysGroup，并加载其roleSet集合 * param groupId * return */public TSysGroup fetchSysGroup(String groupId);/* * 根据参数name从数据库返回TSysGroup 实体对象 * param name * return TSysGroup */public TSysGroup findSysGroupByName(String name);/* * 根据参数state从数据库返回所有的 TSysGroup 实体对象 * param state * return List */public List findSysGroups(String state);/* * 根据参数state从数据库分页返回 TSysGroup 实体对象 * param state * param firstResult游标初始位置 * param maxResults查询记录数 * return List TSysGroup列表 */public List findSysGroups(String state,int firstResult,int maxResults);/* * 根据参数state,orgId从数据库返回所有orgId部门下的 TSysGroup 列表 * param state * param orgId * return List TSysGroup列表 */public List findSysGroupsByOrg(String state,String orgId);/* * 根据参数state,orgId从数据库分页返回orgId部门下的 TSysGroup 列表 * param state * param orgId * param firstResult游标初始位置 * param maxResults查询记录数 * return List */public List findSysGroupsByOrg(String state,String orgId,int firstResult,int maxResults);1.7 SysLoginLogDAO的说明：/* * 根据用户名返回用户时间上最近的一条登陆记录 * param username 用户名 * return List */public TSysLoginLog findLastSysLoginLog(String username);/* * 返回数据库中所有的登陆日志对象 * return List */public List findSysLoginLogs();/* * 分页返回数据库中所有的登陆日志对象 * param firstResult * param maxResults * return List */public List findSysLoginLogs(int firstResult,int maxResults);1.8 SysMenuDAO的说明：/* * 返回数据库中id为menuId的TSysMenu，并加载其roleSet集合 * param menuId * return */public TSysMenu fetchSysMenu(String menuId);/* * 根据参数组织名称从数据库返回 TSysMenu 列表 * param menuName菜单名称 * return List */public List findSysMenuByName(String menuName);/* * 根据参数treeCode从数据库返回 TSysMenu 实体类对象实例 * param treeCode * return TSysMenu 实体类对象 */public TSysMenu findSysMenuByTreeCode(String treeCode);/* * 根据参数机构代码从数据库返回 TSysMenu 实体类对象实例 * param menuUrl * return 实体类对象 */public TSysMenu findSysMenuByUrl(String menuUrl);/* * 根据参数menuType从数据库返回某种类型的 TSysMenu 列表 * param menuType * return List */public List findSysMenusByMenuType(String menuType);/* * 根据参数roleId从数据库返回某角色的 TSysMenu 列表 * param roleId * return List */public List findSysMenusByRole(String roleId);/* * 根据参数menuId从数据库返回组织的所有子TSysMenu 列表 * param menuId * return List */public List findChildrenSysMenus(String menuId);/* * 根据参数state,menuId从数据库返回组织的所有子部门的 TSysMenu 列表 * param state * param menuId * return List */public List findChildrenSysMenus(String state,String menuId);/* * 根据参数menuId从数据库分页返回组织的子部门的 TSysMenu 列表 * param state * param menuId * param firstResult游标初始位置 * param maxResults查询记录数 * return List */public List findChildrenSysMenus(String state,String menuId,int firstResult,int maxResults);/* * 从数据库分页返回所有 TSysMenu 列表 * return List */public List findSysMenus();1.9 SysPermissionDAO的说明：/* * 根据参数permissionId返回TSysPermission实体对象及其roleSet * param permissionId * return TSysPermission */public TSysPermission fetchSysPermission(String permissionId);/* * 根据参数permissionName返回TSysPermission实体对象，如果不存在则返回null; * param permissionName * return TSysPermission */public TSysPermission findSysPermissionByName(String permissionName);/* * 返回数据库中所有的TSysPermission对象 * return List */public List findSysPermissions();/* * 分页返回数据库中所有的TSysPermission对象 * param firstResult * param maxResults * return List */public List findSysPermissions(int firstResult,int maxResults);/* * 根据参数roleId从数据库分页返回某角色的 TSysPermission 列表 * param roleId * 返回数据库中所有的TSysPermission对象 * return List */public List findSysPermissionsByRole(String roleId);/* * 根据参数roleId从数据库分页返回某角色的 TSysPermission 列表 * param roleId * param firstResult * param maxResults * return List */public List findSysPermissionsByRole(String roleId,int firstResult,int maxResults);1.10 SysRoleDAO的说明：/* * 返回数据库中id为roleId的角色，并加载其permissionSet和menuSet集合 * param roleId * return */public TSysRole fetchSysRole(String roleId);/* * 返回数据库中名称为roleName的角色 * param roleName * return */public TSysRole findSysRoleByName(String roleName);/* * 返回数据库中所有的系统用户对象 * return List */public List findSysRoles();/* * 分页返回数据库中所有的系统用户对象 * param firstResult * param maxResults * return List */public List findSysRoles(int firstResult,int maxResults);/* * 根据参数userId从数据库分页返回某用户的 TSysRole 列表 * param userId * return List */public List findSysRolesByUser(String userId);/* * 根据参数userId从数据库分页返回某用户的 TSysRole 列表 * param userId * param firstResult * param maxResults * return List */public List findSysRolesByUser(String userId,int firstResult,int maxResults);/* * 根据参数groupId从数据库分页返回某群组的的 TSysRole 列表 * param groupId * return List */public List findSysRolesByGroup(String groupId);/* * 根据参数groupId从数据库分页返回某群组的的 TSysRole 列表 * param groupId * param firstResult * param maxResults * return List */public List findSysRolesByGroup(String groupId,int firstResult,int maxResults);/* * 根据参数userId从数据库分页返回某用户的 TSysRole 列表,包括用户所在群组的角色 * param userId * return List */public List findAllSysRolesByUser(String userId);/* * 根据参数userId从数据库分页返回某用户的 TSysRole 列表,包括用户所在群组的角色 * param userId * param firstResult * param maxResults * return List */public List findAllSysRolesByUser(String userId,int firstResult,int maxResults);1.11 SysUserDAO的说明：/* * 根据参数userName取得一个TSysUser实体类对象，如果不存在返回null * param userName * return TSysUser 或 null */public TSysUser findSysUserByUserName(String userName);/* * 返回数据库中所有的系统用户对象 * param state * return List */public List findSysUsers(String state);/* * 分页返回数据库中所有的系统用户对象 * param state * param firstResult * param maxResults * return List */public List findSysUsers(String state,int firstResult,int maxResults);/* * 根据参数orgId从数据库返回某部门的 TSysUser 列表 * param orgId * param state * return List */public List findSysUsersByOrg(String orgId,String state);/* * 根据参数orgId从数据库分页返回某部门的的 TSysUser 列表 * param orgId * param state * param firstResult游标初始位置 * param maxResults查询记录数 * return List */public List findSysUsersByOrg(String orgId,String state,int firstResult,int maxResults);/* * 根据参数positionId从数据库返回某部门的 TSysUser 列表 * param positionId * return List */public List findSysUsersByPosition(String positionId);/* * 根据参数positionId从数据库分页返回某部门的的 TSysUser 列表 * param positionId * param firstResult游标初始位置 * param maxResults查询记录数 * return List */public List findSysUsersByPosition(String positionId,int firstResult,int maxResults);/* * 根据参数roleId从数据库返回某部门的 TSysUser 列表 * param roleId * return List */public List findSysUsersByRole(String roleId);/* * 根据参数roleId从数据库分页返回某部门的的 TSysUser 列表 * param roleId * param firstResult游标初始位置 * param maxResults查询记录数 * return List */public List findSysUsersByRole(String roleId,int firstResult,int maxResults);/* * 根据参数groupId从数据库返回某部门的 TSysUser 列表 * param groupId * return List */public List findSysUsersByGroup(String groupId);/* * 根据参数groupId从数据库分页返回某部门的 TSysUser 列表 * param groupId * param firstResult游标初始位置 * param maxResults查询记录数 * return List */public List findSysUsersByGroup(String groupId,int firstResult,int maxResults);/* * 依据机构ID、职务ID得到具体的人员 * param orgId * param positionId * return */public List findUserByOrgAndPos(String orgId, String positionId);/* * 返回数据库中id为userId的TSysUser，并加载其positionSet和roleSet集合 * param userId * return */public TSysUser fetchSysUser(final String userId);2 Service层接口说明2.1 OrgFrameManager的说明1)、UML图2)、描述/* * 保存一个TOrgFrame实体类对象 * param obj组织实体对象 * return 保存是否成功 */public boolean saveOrgFrame(TOrgFrame obj);/* * 更新一个TOrgFrame实体类对象 * param obj组织实体对象 * return 更新是否成功 */public boolean updateOrgFrame(TOrgFrame obj);/* * 根据参数orgIds删除一个（多个）TOrgFrame实体类对象 * param orgIds组织ID或组织ID数组 * return 删除是否成功 */public boolean deleteOrgFrame(String. orgIds);/* * 根据参数orgId取得一个TOrgFrame实体类对象，如果不存在返回null * param orgId组织ID * return TOrgFrame 或 null */public TOrgFrame findOrgFrame(String orgId);/* * 重置一个机构状态 * param orgId组织ID * return 是否成功 */public boolean enableOrgFrame(String orgId,String resumeId);/* * 移动一个机构到新的上级部门下面 * param orgId组织ID * param parentOrgId上级组织ID * return 是否成功 */public boolean changeParentOrgFrame(String orgId,String parentOrgId);/* * 根据参数orgIdl,查询相应的机构下是否存在用户,包括子机构是否存在用户 * param orgId * return 是否存在用户 */public boolean hasUsers(String orgId);/* * 根据参数orgIdl删除机构及其下面的所有子机构 * param orgId组织ID * param invalidationId操作人员ID * return 成功删除的机构列表 */public List disableOrgFrame(String orgId,String invalidationId);/* * 根据参数treeCode取得一 TOrgFrame 实体类对象实例 * param treeCode组treeCode名称 * return TOrgFrame 实体类对象 */public TOrgFrame findOrgFrameByTreeCode(String treeCode);/* * 根据参数组织名称从数据库返回 TOrgFrame * param orgName组织名称 * return TOrgFrame */public TOrgFrame findOrgFrameByName(String orgName);/* * 根据参数orgId返回组织的所有子部门的 TOrgFrame 列表 * param state * param orgId * return List TOrgFrame列表 */public List findChildrenOrgFrames(String state,String orgId);/* * 根据参数orgId分页返回组织的子部门的 TOrgFrame 列表 * param state * param orgId * param firstResult游标初始位置 * param maxResults查询记录数 * return List TOrgFrame列表 */public List findChildrenOrgFrames(String state,String orgId,int firstResult,int maxResults);/* * 查找机构 * param controls -查找条件,比如controls.put(orgName,公司),查找名称为公司的部门 * return */public List searchOrgFrames(Map controls);/* * 根据参数state从数据库返回状态为state的组织列表 * 从数据库返回所有的 TOrgFrame 列表 * return List */public List findOrgFrames(String state);/* * 根据参数state从数据库分页返回状态为state的TOrgFrame 列表 * param firstResult游标初始位置 * param maxResults查询记录数 * return List */public List findOrgFrames(String state,int firstResult,int maxResults);/* * 返回部门及其子部门下的所有用户列表 * param orgId -要查找人员的部门I