package org.yeeku.service;

import java.util.List;
import org.yeeku.model.*;
import org.yeeku.exception.ExamException;

/**
 * @author  yeeku.H.lee kongyeeku@163.com
 * @version  1.0
 * <br>Copyright (C), 2005-2008, yeeku.H.Lee
 * <br>This program is protected by copyright laws.
 * <br>Program Name:
 * <br>Date: 
 */
public interface ExamService
{
	int STUDENT_PAGE_SIZE = 2;
	int QUESTION_PAGE_SIZE = 3;

	/**
	 * 增加一個學生實例，對應為增加一條學生的記錄
	 * @param stuNumber 學生學號。
	 * @param name 學生學號。
	 * @param classname 學生學號。
	 * @param humanId 學生學號。
	 * @param email 學生學號。
	 * @param address 學生地址。
	 * @param phone 學生電話。
	 * @return 新增學生的主鍵
	 */
	int addStudent(String stuNumber , String name , 
		String classname , String humanId , String email ,
		String address , String phone) throws ExamException;

	/**
	 * 根據學生Id刪除學生
	 * @param id 需要刪除的學生的主鍵。
	 */
	void deleteStudent(int id) throws ExamException;

	/**
	 * 根據頁碼列出學生列表
	 * @param pageNo 頁碼
	 * return 列出的學生列表
	 */
	List<Student> listStudent(int pageNo) throws ExamException;


	/**
	 * 增加一個試題，增加一條試題記錄
	 * @param quTitle 試題題目。
	 * @param quHard 試題難度。
	 * @param quScore 試題分數。
	 * @param quAnswer 試題答案。
	 * @param quType 試題類型。
	 * @param selectOption 試題選項。
	 * @param examTypeId 試題對應的考試類型
	 * @return 新增試題的主鍵
	 */
	int addQuestion(String quTitle,String quHard,String quScore,
		String quAnswer,String quType,String selectOption , int examTypeId) throws ExamException;

	/**
	 * 根據試題ID刪除試題
	 * @param id 需要刪除的試題的主鍵。
	 */
	void deleteQuestion(int id) throws ExamException;	

	/**
	 * 根據頁碼列出試題列表
	 * @param pageNo 頁碼
	 * return 列出的試題列表
	 */
	List<Question> listQuestion(int pageNo) throws ExamException;

	/**
	 * 根據考試類型ID刪除考試類型
	 * @param id 需要刪除的考試類型的主鍵。
	 */
	void deleteExamType(int id) throws ExamException;

	/**
	 * 新增考試類型
	 * @param testName 新增的考試名稱。
	 * @param testTime 新增的考試時間
	 * @return 新增的考試類型的ID
	 */
	int addExamType(String testName , String testTime) throws ExamException;

	/**
	 * 獲取所有考試類型
	 * @return 所有考試類型
	 */
	List<ExamType> getAllExamType() throws ExamException;

	/**
	 * 根據用戶名和密碼判斷用戶是否可以成功登錄
	 * @param user 登錄用的用戶名
	 * @param pass 登錄用的密碼
	 */
	boolean adminLogin(String user , String pass) throws ExamException;

	/**
	 * 獲取學生數量
	 * @return 學生的個數
	 */
	int getStudentCount()throws ExamException;

	/**
	 * 獲取試題數量
	 * @return 試題的個數
	 */
	int getQuestionCount()throws ExamException;

	/**
	 * 根據每頁記錄數，總記錄數獲取總頁數
	 * @param count 總記錄數
	 * @param pageSize 每頁顯示的記錄數
	 * @return 計算得到的總頁數
	 */
	int getPageCount(int count , int pageSize);

	/**
	 * 判斷學生是否可以成功登錄。
	 * @param name 登錄用的學生姓名
	 * @param stuNumber 登錄用的學號
	 */
	String studentLogin(String name , String stuNumber)throws ExamException;

	/**
	 * 根據考試類型ID獲取下一個試題
	 * @param already 已經回答的試題ID
	 * @param examTypeId 考試類型ID
	 * return 該考試類型的下一個試題
	 */
	Question getNextQuestion(List<Integer> alreadys , int examTypeId)throws ExamException;

	/**
	 * 根據試題ID獲取實體
	 * @param id 試題ID
	 * return 該ID對應的試題
	 */
	Question getQuestionById(int id)throws ExamException;

	/**
	 * 根據考試類型ID獲取考試類型
	 * @param typeId 考試類型ID
	 * return 該ID對應的考試類型名
	 */
	String getExamTypeName(int typeId)throws ExamException;

}