rolemanager.java

基于java的组号查询模块

package com.lily.dap.service.right;

import java.util.Collection;
import java.util.List;
import java.util.Set;

import com.lily.dap.model.right.Permission;
import com.lily.dap.model.right.Role;
import com.lily.dap.service.Manager;
import com.lily.dap.service.core.exception.DataContentRepeatException;
import com.lily.dap.service.core.exception.DataHaveIncludeException;
import com.lily.dap.service.core.exception.DataHaveUsedException;
import com.lily.dap.service.core.exception.DataNotExistException;
import com.lily.dap.service.core.exception.DataNotIncludeException;
/**
 * 
 * RoleManager.java
 * 
 * <br>作者： 刘鹏
 *
 * <br>日期： 2006-3-6
 *
 * <br>版权所有：淄博百合软件
 */
public interface RoleManager extends Manager {
	/**
	 * 根据角色编号获取指定的角色
	 * 
	 * @param code 角色编号
	 * @return Role
	 * @throws DataNotExistException 角色不存在异常
	 */
	public Role getRole(String code) throws DataNotExistException;
	
	/**
	 * 获取角色包含的所有角色信息，包括本身的角色,以及嵌套的子角色
	 * 
	 * @param role_id 角色id
	 * @param isOnlyPublicRole 是否只检索公共角色
	 * @return Set{Role}
	 */
	public Set getHaveAllRoles(long role_id, boolean isOnlyPublicRole);
	
	/**
	 * 获取角色包含的所有许可信息，包括本身的许可,以及包含的所有子角色的许可
	 * 
	 * @param role_id
	 * @return Set{Permission}
	 */
	public Set getHaveAllPermissions(long role_id);
	
	/**
	 * 获取角色直接拥有的公共角色列表
	 * <p>前置条件：
	 * <p>1、角色必须存在
	 * 
	 * @param role_id 角色id
	 * @return List{Role}
	 */
	public List getHavePublicRoles(long role_id);
	
	/**
	 * 获取角色直接拥有的许可列表
	 * <p>前置条件：
	 * <p>1、角色必须存在；
	 * 
	 * @param role_id 角色id
	 * @return List{Permission}
	 */
	public List getHavePermissions(long role_id);
	
	
	/**
	 * 创建一个公共角色
	 * <p>前置条件：
	 * <p>1、角色的编号不能与现有的角色编号重复；
	 * 
	 * @param code 角色编号
	 * @param name 角色名称
	 * @param des 角色描述
	 * @return Role
	 * @throws DataContentRepeatException 角色编号重复异常
	 */
	public Role createPublicRole(String code, String name, String des) throws DataContentRepeatException;
	
	/**
	 * 创建一个私有角色
	 * 私有角色的名称由系统随机生成
	 * 
	 * @param des 角色描述
	 * @return Role
	 */
	public Role createPrivateRole(String des);
	
	/**
	 * 修改角色信息
	 * <p>前置条件:
	 * <p>1、角色必须存在；
	 * 
	 * @param role_id 角色id
	 * @param name 角色名称
	 * @param des 角色描述
	 * @throws DataNotExistException 角色不存在异常
	 */
	public void modifyRole(long role_id, String name, String des)  throws DataNotExistException;
	
	/**
	 * 给现有的角色添加角色
	 * <p>前置条件：
	 * <p>1、角色必须存在；
	 * <p>2、被添加的角色必须存在；
	 * <p>3、被添加的角色(have_role_id)以及其(have_role_id)子角色不能包含现有的角色(role_id)
	 * 
	 * @param role_id 已有的角色id
	 * @param have_role_id 被添加的角色id
	 */
	public void addHaveRole(long role_id, long have_role_id) throws DataNotExistException, DataHaveIncludeException;
	
	/**
	 * 删除角色信息
	 * <p>前置条件：
	 * <p>1、角色不能被包含
	 * 
	 * @param role_id 角色id
	 */
	public void removeRole(long role_id)  throws DataNotExistException, DataHaveUsedException;
    
	/**
	 * 去除角色拥有的子角色
	 * <p>前置条件：
	 * <p>1、角色和拥有的角色必须存在；
	 * 
	 * @param role_id 角色id
	 * @param have_role_id 拥有的角色id
	 */
    public void removeHaveRole(long role_id, long have_role_id) throws DataNotExistException, DataNotIncludeException;
	
	/**
	 * 给现有的角色添加许可
	 * <p>前置条件：
	 * <p>1、角色必须存在；
	 * <p>后置条件：
	 * <p>1、直接加入许可信息，允许对一个权限对象，进行多次操作的添加；
	 * 
	 * @param role_id 角色id
	 * @param object_code 对象代码
	 * @param operation_code[] 对象的操作代码数组
	 * @param des 许可的描述信息
	 * @return Permission
	 */
	public Permission addPermission(long role_id, String object_code, String[] operation_code, String des)  throws DataNotExistException;
	
	/**
	 * 修改角色拥有的许可信息
	 * <p>前置条件：
	 * <p>1、角色必须存在；
	 * <p>2、许可必须存在;
	 * <p>后置条件：
	 * <p>1、改变一个许可的权限对象，以及此权限对象所对应的操作；
	 * <p>或者改变现有许可的权限对象操作；
	 * 
	 * @param role_id 角色id
	 * @param permission_id 许可id
	 * @param object_code 权限对象code
	 * @param operation_code 权限对象操作
	 * @param des 许可说明信息
	 */
	public void modifyPermission(long permission_id, String object_code, String[] operation_code, String des)  throws DataNotExistException;
	
	/**
	 * 设置许可对象的全名称（设置fullName为：系统对象:读,写）
	 * 
	 * @param permission 
	 * @return
	 */
	public Permission fillPermissionFullName(Permission permission);
	
	/**
	 * 设置列表内的许可对象集合的全名称（设置fullName为：系统对象:读,写）
	 * 
	 * @param permissions 包含许可对象的集合列表
	 * @return
	 */
	public Collection fillPermissionFullName(Collection permissions);
}