<?php 
/**
 * 班級群組管理類別檔案
 */

namespace UElearning\User;

require_once UELEARNING_LIB_ROOT.'/Database/DBUser.php';
require_once UELEARNING_LIB_ROOT.'/Exception.php';
use UElearning\Database;
use UElearning\Exception;

/**
 * 管理班級群組的操作
 * 
 * @author          Yuan Chiu <chyuaner@gmail.com>
 * @version         2.0.0
 * @package         UElearning
 * @subpackage      User
 */ 
class ClassGroupAdmin {
    
    /**
     * 建立班級
     * 
     * 建立班級群組範例:
     * 
     *     try {
     *         $groupAdmin = new User\ClassGroupAdmin();
     *         $newId = null;
     *         $newId = $groupAdmin->create(
     *             array( 'name' => '學生',
     *                    'memo' => null
     *         ));
     *         echo '你剛建立:'.$newId;
     *     }
     *     // 若已有重複班級ID
     *     catch (Exception\ClassIdExistException $e) {
     *         echo 'Is exist class: ',  $e->getGroupId();
     *     }
     * 
     * @param array $classGroupArray 班級群組資訊陣列，格式為:
     *     array( 'class_id'              => 12,
     *            'name'                  => '學生',
     *            'memo'                  => null )
     * @return int 剛剛新增進去的ID
     * @throw UElearning\Exception\ClassIdExistException
     * @since 2.0.0
     */ 
    public function create($classGroupArray) {
        
        // 檢查有無填寫
        if(isset($classGroupArray)) {
            
            // 若此id已存在
            if( isset($classGroupArray['class_id']) && 
                      $this->isExist($classGroupArray['class_id']) ) {
                
                throw new Exception\ClassIdExistException(
                    $classGroupArray['class_id'] );
            }
            // 沒有問題
            else {
                // 處理未帶入的資料
                if( !isset($classGroupArray['class_id']) ){
                    $classGroupArray['class_id'] = null;
                }
                
                // 處理未帶入的資料
                if( !isset($classGroupArray['name']) ){
                    $classGroupArray['name'] = null;
                }
                // 處理未帶入的資料
                if( !isset($classGroupArray['memo']) ){
                    $classGroupArray['memo'] = null;
                }
                
                // 新增一筆使用者資料進資料庫
                $db = new Database\DBUser();
                $id = $db->insertClassGroup(
                    $classGroupArray['class_id'], 
                    $classGroupArray['name'], 
                    $classGroupArray['memo']
                );
                
                // 回傳剛剛新增的ID
                return $id;
            }
        }
        else throw Exception\NoDataException();
    }
    
    /**
     * 是否已有相同名稱的班級ID
     * 
     * @param  int  $class_id 班級ID
     * @return bool 已有相同的班級ID
     * @since 2.0.0
     */ 
    public function isExist($class_id) {
        
        $db = new Database\DBUser();
        $info = $db->queryClassGroup($class_id);
        
        if( $info != null ) return true;
        else return false;
    }
    
    /**
     * 移除此班級
     * 
     * 範例: 
     * 
     *     try {
     *         $groupAdmin = new User\ClassGroupAdmin();
     *         $groupAdmin->remove(2);
     *     
     *     }
     *     catch (Exception\ClassNoFoundException $e) {
     *         echo 'No Found class: ',  $e->getGroupId(); 
     *     }
     *
     * @param int $class_id 班級ID
     * @throw UElearning\Exception\ClassNoFoundException
     * @since 2.0.0
     */ 
    public function remove($class_id) {
        
        // 若有此使用者
        if($this->isExist($class_id)) {
            
            // TODO: 檢查所有關聯的資料，確認是否可以移除
            
            // 移除資料庫中的使用者
            $db = new Database\DBUser();
            $db->deleteClassGroup($class_id);
        }
        // 若沒有這位使用者
        else {
            throw new Exception\ClassNoFoundException($class_id);
        }
        
    }

}