icoursemanager.cs

guan yu pai ke xi tong de ruan jian

using System;
using System.Collections.Generic;
using System.Text;

using Y2T03.CourseScheduler.CourseModel;

namespace Y2T03.CourseScheduler.IDAL
{
    /// <summary>
    /// 接口类 ICourseManager
    /// </summary>
    public interface ICourseManager
    {

        /// <summary>
        /// 新增课程
        /// </summary>
        /// <param name="course">课程实体对象</param>
        /// <returns>true = 成功, false = 失败.</returns>
        bool Create(Course course);

        /// <summary>
        /// 终止课程
        /// </summary>
        /// <param name="courseId">课程编号</param>
        /// <returns>true = 成功, false = 失败.</returns>
        bool Delete(int courseId);

        /// <summary>
        /// 修改课程
        /// </summary>
        /// <param name="course">课程实体对象</param>
        /// <returns>true = 成功, false = 失败.</returns>
        bool Update(Course course);

        /// <summary>
        /// 获得教学产品列表
        /// </summary>
        /// <returns>教学产品列表</returns>
        IList<Product> GetProducts();

        /// <summary>
        /// 获得教学产品
        /// </summary>
        /// <param name="productId">产品编号</param>
        /// <returns>教学产品实体对象</returns>
        Product GetProduct(int productId);

        /// <summary>
        /// 获得学习阶段列表
        /// </summary>
        /// <returns>学习阶段列表</returns>
        IList<Section> GetSections();

        /// <summary>
        /// 获得学习阶段
        /// </summary>
        /// <param name="sectionCode">阶段编码</param>
        /// <returns>学习阶段实体对象</returns>
        Section GetSection(string sectionCode);

        /// <summary>
        /// 获得专业技术方向列表
        /// </summary>
        /// <returns>专业技术方向列表</returns>
        IList<Speciality> GetSpecialities();

        /// <summary>
        /// 获得专业技术方向
        /// </summary>
        /// <param name="specialityId">技术方向编号</param>
        /// <returns>专业技术方向实体对象</returns>
        Speciality GetSpeciality(int specialityId);

        /// <summary>
        /// 获得某教学产品的指定学习阶段的所有课程
        /// </summary>
        /// <param name="productId">产品版本</param>
        /// <param name="sectionCode">学习阶段</param>
        /// <returns>课程列表</returns>
        IList<Course> GetCourses(int productId, string sectionCode);

        /// <summary>
        /// 根据课程编号获取课程
        /// </summary>
        /// <param name="courseId">课程编号</param>
        /// <returns>课程实体对象</returns>
        Course GetCourse(int courseId);

        /// <summary>
        /// 获得课程名称列表
        /// </summary>
        /// <returns>课程名称列表</returns>
        IList<Course> GetCourses();

        /// <summary>
        /// 插入时检查课程名称是否存在
        /// </summary>
        /// <param name="title">课程名称</param>
        /// <param name="productId">产品名称</param>
        /// <param name="sectionCode">阶段名称</param>
        /// <returns>true = 有, false = 没有.</returns>
        bool CheckIsExits(string title, int productId, string sectionCode);
    }
}