organizequery.java

基于java的组号查询模块

package com.lily.dap.service.organize;

import java.util.Collection;

import com.lily.dap.model.organize.Department;
import com.lily.dap.model.organize.Group;
import com.lily.dap.model.organize.Person;
import com.lily.dap.model.organize.Post;
import com.lily.dap.service.core.exception.DataNotExistException;

public interface OrganizeQuery {
	/**
	 * 获取群组
	 * @param group_id
	 * @return Group
	 * @throws DataNotExistException 如果群组不存在，抛出此异常
	 */
	public abstract Group getGroup(long group_id) throws DataNotExistException;
	
	/**
	 * 获取所有的群组
	 * 
	 * @return Collection{Group}
	 */
	public abstract Collection getGroups();
	
	/**
	 * 获取根部门
	 * @return Department
	 * @throws DataNotExistException
	 */
	public abstract Department getRootDepartment() throws DataNotExistException;

	/**
	 * 根据部门ID获取部门信息
	 * @param depart_id
	 * @return Department
	 * @throws DataNotExistException
	 */
	public abstract Department getDepartment(long depart_id)
			throws DataNotExistException;

	/**
	 * 获取部门类型为type的部门列表
	 * @param type
	 * @return Collection{Department}
	 */
	public abstract Collection getDepartments(int type);

	/**
	 * 根据部门ID获取下的子部门列表
	 * @param depart_id
	 * @return Collection{Department}
	 * @throws DataNotExistException
	 */
	public abstract Collection getChildDepartments(long depart_id)
			throws DataNotExistException;

	/**
	 * 获取父部门（包括父部门）下面的所有部门（级联子部门） 
	 * @param parent_id
	 * @return Collection{Department}
	 */
	public abstract Collection getAllDepartmentsByParent(long parent_id)
			throws DataNotExistException;

	/**
	 * 根据岗位ID获取岗位信息
	 * @param post_id
	 * @return Post
	 * @throws DataNotExistException
	 */
	public abstract Post getPost(long post_id) throws DataNotExistException;

	/**
	 * 获取部门下面的所有直接岗位列表
	 * @param depart_id
	 * @return Collection{Post}
	 * @throws DataNotExistException
	 */
	public abstract Collection getPosts(long depart_id) throws DataNotExistException;

	/**
	 * 获取人员所在的岗位列表
	 * @param person_id
	 * @return Collection{Post}
	 * @throws DataNotExistException
	 */
	public abstract Collection getPostsByPerson(long person_id)
			throws DataNotExistException;

	/**
	 * 获取所有的岗位列表
	 * @return Collection{Post}
	 */
	public abstract Collection getAllPosts();

	/**
	 * 根据人员ID获取人员信息
	 * @param person_id
	 * @return Person
	 * @throws DataNotExistException
	 */
	public abstract Person getPerson(long person_id)
			throws DataNotExistException;

	/**
	 * 根据人员登陆用户获取人员信息
	 * 
	 * @param username
	 * @return
	 * @throws DataNotExistException
	 */
	public abstract Person getPerson(String username)
			throws DataNotExistException;

	public abstract Collection getPersonsByGroup(long group_id);
	
	/**
	 * 获取某岗位下的所有人员信息
	 * @param post_id 岗位id
	 * @return Collection{Person}
	 */
	public abstract Collection getPersonsByPost(long post_id);

	/**
	 * 获取系统中所有人员
	 * @return Collection{Person}
	 */
	public abstract Collection getAllPersons();
	
	/**
	 * 获取部门下的所有人员
	 * @param depart_id 部门id
	 * @param include_sub_department 是否包含子部门
	 * @return Collection{Person}
	 */
	public abstract Collection getPersonsByDepartments(long depart_id,
			boolean include_sub_department);

	/**
	 * 获取所有子部门
	 * @param parent_id 父部门
	 * @return Collection{Department}
	 */
	public abstract Collection getAllChildDeparts(long parent_id);
}