admindao.java

一个关于tlms的一个小程序 看看能否帮助到别人

/**
 * ================================================================
 * Copyright 2006 szmx
 * <p/>
 * Change Revision
 * ---------------------------------------------------------------
 * Date               Author            Remarks
 * Mar 22, 2006       BZhang      Create class com.szmx.tlms.admin.dao.AdminDAO
 * ================================================================
 */
package com.szmx.tlms.admin.dao;

import com.szmx.framework.base.dao.BaseDao;
import com.szmx.framework.base.model.Pagination;
import com.szmx.tlms.admin.model.*;

import java.util.List;
import java.util.Map;

public interface AdminDAO extends BaseDao {

    // Employee Managerment: ----------------------------------------

    /**
     * This method is for admin to search employee based on
     * search criteria with pagination and sort.
     *
     * @param pagination (the pagination object)
     * @param paraMap    (map)[should contains properties]
     *                   empId : String
     *                   status : String
     *                   name : String
     * @return Employee list for search result
     */
    public Pagination searchEmployees(Pagination pagination, Map paraMap);

    /**
     * This method is for admin to get the employee based on special Long id.
     *
     * @param id (the physic id of the employee : Long)
     * @return Employee object for search result
     */
    public Employee getEmployee(Long id);

    /**
     * This method is for admin to get the employee based on special String employee id.
     *
     * @param empId (the company employee id of the employee : String)
     * @return Employee object for search result
     */
    public Employee getEmployee(String empId);

    /**
     * This method is for admin to save the employee based on special employee object.
     *
     * @param employee (Employee object)
     */
    public void saveEmployee(Employee employee);

    /**
     * This method is for admin to remove the employees based on checked employee.
     *
     * @param id (the id of Employee , Long value.)
     */
    public void removeEmployee(Long id);

    // Role Managerment: ----------------------------------------

    /**
     * This method is for admin to search role based on
     * search criteria with pagination and sort.
     *
     * @param pagination (the pagination object)
     * @param paraMap    (map)[should contains properties]
     *                   roleName : String
     * @return Role list for search result
     */
    public Pagination searchRoles(Pagination pagination, Map paraMap);

    /**
     * This method is for admin to search assigned roles(roles which has employee)
     *
     * @param roleId (Long value)
     * @return Role list for search result
     */
    public List searchAssignedRoles(Long roleId);

    /**
     * This method is for admin to search unassigned roles(roles which has no employee)
     *
     * @param roleId (Long value)
     * @return Role list for search result
     */
    public List searchNotAssignedRoles(Long roleId);

    /**
     * This method is for admin to search role with roleId
     *
     * @param id (Long value)
     * @return Role for search result
     */
    public Role getRole(Long id);

    /**
     * This method is for admin to search role with roleId
     *
     * @param name (String)
     * @return Role for search result
     */
    public Role getRoleByName(String name);

    /**
     * This method is for admin to save role with role object
     *
     * @param role (Role object)
     */
    public void saveRole(Role role);

    /**
     * This method is for admin to remove the role with specific role id
     *
     * @param id (Long value)
     */
    public void removeRole(Long id);

    /**
     * This method is for admin to remove the employee's role relation with specific employee id
     *
     * @param empId (Long value)
     */
    public int removeEmpRoleRelation(Long empId);

    /**
     * This method is for admin to search the role and employee's relation with specific role id
     *
     * @param roleId (Long value)
     */
    public List searchEmpRoleRelation(Long roleId);

    // Resource for role -----------------------------------------------

    /**
     * This method is for admin to get resource which has assigned to the specific role id
     *
     * @param roleId (Long value)
     */
    public List getRoleResource(Long roleId);

    /**
     * This method is for admin to add resource for the role
     *
     * @param relrr (RelRoleResource object, include roleId and resourceId)
     */
    public void addResourceForRole(RelRoleResource relrr);

    /**
     * This method is for admin to add basic resource for the role
     *
     * @param roleId (Long value)
     */
    public void addBasicResForRole(Long roleId);

    /**
     * This method is for admin to remove all resource from the role
     *
     * @param roleId (Long value)
     */
    public int removeAllResFromRole(Long roleId);

    /**
     * This method is for admin to get resource belonged to the specific module
     *
     * @param modId (Long value)
     */
    public Resource getResourceModByModId(Long modId);

    // Department Managerment: ----------------------------------------

    /**
     * This method is for admin to get all departments
     *
     * @param pagination (the pagination object)
     * @param paraMap    (map)[empty map to get all department]
     */
    public Pagination searchDepartment(Pagination pagination, Map paraMap);

    /**
     * This method is for admin to get all departments
     *
     * @return (List)
     */
    public List getDepartmentList();

    // Resource Managerment: ----------------------------------------

    /**
     * This method is for admin to get all resource
     *
     * @param pagination (the pagination object)
     * @param paraMap    (Map)  [should contains properties]
     *                   roleId        String
     *                   status        String
     */
    public Pagination searchResources(Pagination pagination, Map paraMap);

    /**
     * This method is for admin to get the resource by the specific resource id
     *
     * @param id (Long value)
     * @return (Resource object)
     */
    public Resource getResource(Long id);

    /**
     * This method is for admin to save resource
     *
     * @param resource (Resource object)
     */
    public void saveResource(Resource resource);

    /**
     * This method is for admin to remove resource by the specific resource id
     *
     * @param id (Long value)
     */
    public void removeResource(Long id);

}