package org.agt.module.infra.service.demo;

import java.util.*;
import javax.validation.*;
import org.agt.module.infra.controller.admin.demo.vo.*;
import org.agt.module.infra.dal.dataobject.demo.InfraStudentDO;
import org.agt.module.infra.dal.dataobject.demo.InfraStudentContactDO;
import org.agt.module.infra.dal.dataobject.demo.InfraStudentTeacherDO;
import org.agt.framework.common.pojo.PageResult;
import org.agt.framework.common.pojo.PageParam;

/**
 * 学生 Service 接口
 *
 * @author 千通源码
 */
public interface InfraStudentService {

    /**
     * 创建学生
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createStudent(@Valid InfraStudentSaveReqVO createReqVO);

    /**
     * 更新学生
     *
     * @param updateReqVO 更新信息
     */
    void updateStudent(@Valid InfraStudentSaveReqVO updateReqVO);

    /**
     * 删除学生
     *
     * @param id 编号
     */
    void deleteStudent(Long id);

    /**
     * 获得学生
     *
     * @param id 编号
     * @return 学生
     */
    InfraStudentDO getStudent(Long id);

    /**
     * 获得学生分页
     *
     * @param pageReqVO 分页查询
     * @return 学生分页
     */
    PageResult<InfraStudentDO> getStudentPage(InfraStudentPageReqVO pageReqVO);

    // ==================== 子表（学生联系人） ====================

    /**
     * 获得学生联系人列表
     *
     * @param studentId 学生编号
     * @return 学生联系人列表
     */
    List<InfraStudentContactDO> getStudentContactListByStudentId(Long studentId);

    // ==================== 子表（学生班主任） ====================

    /**
     * 获得学生班主任
     *
     * @param studentId 学生编号
     * @return 学生班主任
     */
    InfraStudentTeacherDO getStudentTeacherByStudentId(Long studentId);

}