程序包 net.risesoft.y9public.service.role

接口 Y9RoleService

  • 所有已知实现类:
    Y9RoleServiceImpl
    public interface Y9RoleService
    作者:
    dingzhaojun, qinman, mengjuhua
    Date:
    2022/2/10

    • 方法详细资料

      • createRole

        Y9Role createRole​(Y9Role y9Role)
        新建角色
        参数:
        y9Role - 角色对象
        返回:
        Y9Role

      • delete

        void delete​(String id)
        根据主键id移除角色节点实例(如果是角色，移除角色内的/机构/部门/用户组/岗位/人员)
        参数:
        id - 唯一标识

      • findByCustomIdAndParentId

        Optional<Y9Role> findByCustomIdAndParentId​(String customId,
                                           String parentId)
        对于流程角色节点下面的角色customId为taskDefineKey 同一个流程角色下customId是唯一的， 但是不同的流程角色下，customId可能会有多个
        参数:
        customId - 自定义id
        parentId - 父节点id
        返回:
        Optional<Y9Role>

      • findById

        Optional<Y9Role> findById​(String id)
        根据主键获取角色节点对象
        参数:
        id - 唯一标识
        返回:
        Optional<Y9Role>角色对象 或 null

      • findTopByRoleId

        Y9Role findTopByRoleId​(String id)
        根据给定节点id，查找顶级节点
        参数:
        id - 唯一标识
        返回:
        Y9Role

      • getById

        Y9Role getById​(String roleId)
        根据id获取角色
        参数:
        roleId - role id
        返回:
        Y9Role
        抛出:
        net.risesoft.y9.exception.Y9NotFoundException - id 对应的记录不存在的情况

      • listByName

        List<Y9Role> listByName​(String name)
        根据角色名称查找
        参数:
        name - 角色名
        返回:
        List<Y9Role>

      • listByOrgUnitId

        List<Y9Role> listByOrgUnitId​(String orgUnitId)
        根据orgUnitId获取角色列表
        参数:
        orgUnitId - 组织节点id
        返回:
        List<Y9Role>

      • listByOrgUnitIdWithoutNegative

        List<Y9Role> listByOrgUnitIdWithoutNegative​(String orgUnitId)
        根据orgUnitId获取拥有正权限关联的角色列表
        参数:
        orgUnitId - 组织节点id
        返回:
        List<Y9Role>

      • listByParentId

        List<Y9Role> listByParentId​(String parentId)
        根据父节点id,获取本层级的角色节点列表
        参数:
        parentId - 父节点id
        返回:
        List<Y9Role>

      • listByParentIdAndName

        List<Y9Role> listByParentIdAndName​(String parentId,
                                   String roleName)
        根据父节点id和角色名称，获取角色列表
        参数:
        parentId - 父节点id
        roleName - 角色名称
        返回:
        List<Y9Role>

      • listByParentIdIsNull

        List<Y9Role> listByParentIdIsNull()
        查询parentId为null的角色集合
        返回:
        List<Y9Role>

      • listOrgUnitIdRecursively

        List<String> listOrgUnitIdRecursively​(String orgUnitId)
        从给定节点开始，向上递归，返回递归链上所有的节点id(如果是人员，会包括所在组，岗位id)
        参数:
        orgUnitId - 组织节点id
        返回:
        List<String>

      • listOrgUnitRelatedWithoutNegative

        List<Y9Role> listOrgUnitRelatedWithoutNegative​(String orgUnitId)
        根据组织节点id获取所有关联的角色列表（已排除掉负关联） 对于组织机构到组织根节点及所有中间组织节点关联的角色也包含在内
        参数:
        orgUnitId - 组织节点id
        返回:
        List<Y9Role>

      • move

        void move​(String id,
          String newParentId)
        保存移动后的角色信息
        参数:
        id - 唯一标识
        newParentId - 新的父节点id

      • saveOrUpdate

        Y9Role saveOrUpdate​(Y9Role y9Role)
        新增或修改角色
        参数:
        y9Role - 角色对象
        返回:
        Y9Role

      • saveOrder

        void saveOrder​(List<String> ids)
        保存新的角色节点排序
        参数:
        ids - id数组

      • saveProperties

        Y9Role saveProperties​(String id,
                      String properties)
        保存或者更新角色节点扩展信息
        参数:
        id - 唯一标识
        properties - 扩展熟悉
        返回:
        Y9Role

      • treeSearch

        List<Y9Role> treeSearch​(String name)
        根据name查询角色节点
        参数:
        name - 角色名
        返回:
        List<Y9Role>