From 157b621c9af244ea5eb75f2f2a60cdf1da9ae1ef Mon Sep 17 00:00:00 2001 From: lxb <1079052079@qq.com> Date: Tue, 17 Dec 2024 17:04:06 +0800 Subject: [PATCH] zzx --- src/dao/AdminDao.java | 26 +- src/dao/CDCDao.java | 28 +- src/dao/ComplaintDao.java | 18 +- src/dao/CourseDao.java | 22 +- src/dao/NotifyDao.java | 29 +- src/dao/PhotoDao.java | 22 +- src/dao/SelectCourseDao.java | 28 +- src/dao/StudentDao.java | 93 +++++- src/dao/TeacherDao.java | 70 ++++- src/dao/impl/AdminDaoImpl.java | 59 +++- src/dao/impl/CDCDaoImpl.java | 68 +++-- src/dao/impl/ComplaintDaoImpl.java | 42 ++- src/dao/impl/CourseDaoImpl.java | 53 +++- src/dao/impl/NotifyDaoImpl.java | 66 ++-- src/dao/impl/PhotoDaoImpl.java | 57 +++- src/dao/impl/SelectCourseDaoImpl.java | 76 +++-- src/dao/impl/StudentDaoImpl.java | 283 ++++++++++++------ src/dao/impl/TeacherDaoImpl.java | 166 +++++++--- src/domain/Admin.java | 36 ++- src/domain/CDC.java | 47 ++- src/domain/Complaint.java | 48 ++- src/domain/Course.java | 102 ++++--- src/domain/FileClass.java | 48 ++- src/domain/Notify.java | 47 ++- src/domain/PageBean.java | 72 ++++- src/domain/Photo.java | 30 +- src/domain/SelectCourse.java | 108 ++++++- src/domain/Student.java | 144 ++++++++- src/domain/Teacher.java | 84 +++++- src/service/impl/AdminServiceImpl.java | 39 ++- src/service/impl/CDCServiceImpl.java | 45 ++- src/service/impl/ComplaintServiceImpl.java | 31 +- src/service/impl/CourseServiceImpl.java | 38 ++- src/service/impl/NotifyServiceImpl.java | 43 ++- src/service/impl/PhotoServiceImpl.java | 37 ++- src/service/impl/SelectCourseServiceImpl.java | 41 ++- src/service/impl/StudentServiceImpl.java | 146 +++++++-- src/service/impl/TeacherServiceImpl.java | 99 ++++-- 38 files changed, 2002 insertions(+), 489 deletions(-) diff --git a/src/dao/AdminDao.java b/src/dao/AdminDao.java index fc5d1bc..4989a09 100644 --- a/src/dao/AdminDao.java +++ b/src/dao/AdminDao.java @@ -1,12 +1,34 @@ package dao; -import domain.Admin; +import domain.Admin; // 引入 Admin 类，表示管理员数据 +/** + * AdminDao 接口，定义了管理员信息的数据库访问方法。 + */ public interface AdminDao { + + /** + * 根据管理员 ID 和密码查询管理员信息。 + * + * @param id 管理员 ID + * @param password 管理员密码 + * @return 如果匹配成功，返回管理员对象；否则返回 null + */ Admin findAdminidAndPassword(String id, String password); + /** + * 更新管理员密码。 + * + * @param adminid 管理员 ID + * @param newpassword 新密码 + */ void updatePassword(String adminid, String newpassword); + /** + * 根据管理员 ID 查询管理员信息。 + * + * @param a_id 管理员 ID + * @return 如果存在，返回管理员对象；否则返回 null + */ Admin findAdminById(String a_id); } -//dashdhasd diff --git a/src/dao/CDCDao.java b/src/dao/CDCDao.java index 9e0791c..5c71a32 100644 --- a/src/dao/CDCDao.java +++ b/src/dao/CDCDao.java @@ -1,15 +1,39 @@ package dao; -import domain.CDC; +import domain.CDC; // 引入 CDC 类，表示学院、部门和班级的数据 -import java.util.List; +import java.util.List; // 引入 List 类，用于存储返回的查询结果 +/** + * CDCDao 接口，定义了对学院、部门和班级等数据的数据库访问方法。 + */ public interface CDCDao { + + /** + * 查询所有学院信息。 + * + * @return 返回所有学院的列表 + */ List findAllCollege(); + /** + * 查询所有部门信息。 + * + * @return 返回所有部门的列表 + */ List findAllDepartment(); + /** + * 查询所有班级信息。 + * + * @return 返回所有班级的列表 + */ List findAllClass(); + /** + * 查询所有学院、部门和班级的综合信息。 + * + * @return 返回所有学院、部门和班级的列表 + */ List findAll(); } diff --git a/src/dao/ComplaintDao.java b/src/dao/ComplaintDao.java index c36553f..1be231f 100644 --- a/src/dao/ComplaintDao.java +++ b/src/dao/ComplaintDao.java @@ -1,11 +1,25 @@ package dao; -import domain.Complaint; +import domain.Complaint; // 引入 Complaint 类，表示投诉数据 -import java.util.List; +import java.util.List; // 引入 List 类，用于存储返回的投诉列表 +/** + * ComplaintDao 接口，定义了对投诉数据的数据库访问方法。 + */ public interface ComplaintDao { + + /** + * 查询所有的投诉记录。 + * + * @return 返回所有投诉的列表 + */ List findAllComplaint(); + /** + * 添加一条投诉记录。 + * + * @param complaint 需要添加的投诉对象 + */ void addComplaint(Complaint complaint); } diff --git a/src/dao/CourseDao.java b/src/dao/CourseDao.java index 69cf044..f38a18c 100644 --- a/src/dao/CourseDao.java +++ b/src/dao/CourseDao.java @@ -1,11 +1,31 @@ package dao; -import domain.Course; +import domain.Course; // 引入 Course 类，表示课程数据 +/** + * CourseDao 接口，定义了对课程数据的数据库访问方法。 + */ public interface CourseDao { + + /** + * 添加一门选修课程。 + * + * @param course 需要添加的课程对象 + */ void addOptionalCourse(Course course); + /** + * 根据课程 ID 查询课程信息。 + * + * @param cid 课程 ID + * @return 返回对应课程的 Course 对象，若未找到，则返回 null + */ Course findSelectCourseByCourseId(String cid); + /** + * 根据课程 ID 删除课程记录。 + * + * @param cid 课程 ID + */ void deleteServiceById(String cid); } diff --git a/src/dao/NotifyDao.java b/src/dao/NotifyDao.java index 40bd8d9..a95f1f4 100644 --- a/src/dao/NotifyDao.java +++ b/src/dao/NotifyDao.java @@ -1,16 +1,39 @@ package dao; -import domain.Notify; +import domain.Notify; // 引入 Notify 类，表示通知数据 -import java.util.List; +import java.util.List; // 引入 List 类，表示通知列表 +/** + * NotifyDao 接口，定义了对通知数据的数据库访问方法。 + */ public interface NotifyDao { + + /** + * 添加一条通知记录。 + * + * @param notify 需要添加的通知对象 + */ void add(Notify notify); + /** + * 查询最新的 3 条通知。 + * + * @return 返回包含最新 3 条通知的 List 列表 + */ List findNotify(); + /** + * 查询所有通知，按通知 ID 降序排列。 + * + * @return 返回所有通知的 List 列表 + */ List findAllNotify(); + /** + * 根据通知 ID 删除通知记录。 + * + * @param notifyid 通知的 ID + */ void deleteNotifyById(String notifyid); - } diff --git a/src/dao/PhotoDao.java b/src/dao/PhotoDao.java index 68fafd9..58c5758 100644 --- a/src/dao/PhotoDao.java +++ b/src/dao/PhotoDao.java @@ -1,11 +1,31 @@ package dao; -import domain.Photo; +import domain.Photo; // 引入 Photo 类，表示照片数据 +/** + * PhotoDao 接口，定义了与照片数据相关的数据库访问方法。 + */ public interface PhotoDao { + + /** + * 添加一张照片。 + * + * @param photo 需要添加的照片对象 + */ void addPhoto(Photo photo); + /** + * 根据照片 ID 查找对应的照片。 + * + * @param id 照片的 ID + * @return 返回对应的 Photo 对象，如果没有找到则返回 null + */ Photo findPhotoByPhotoId(String id); + /** + * 更新照片的信息。 + * + * @param photo 包含新信息的照片对象 + */ void updatePhoto(Photo photo); } diff --git a/src/dao/SelectCourseDao.java b/src/dao/SelectCourseDao.java index ef5167b..f9c575d 100644 --- a/src/dao/SelectCourseDao.java +++ b/src/dao/SelectCourseDao.java @@ -1,13 +1,37 @@ package dao; -import domain.SelectCourse; +import domain.SelectCourse; // 引入 SelectCourse 类，表示学生选课数据 -import java.util.List; +import java.util.List; // 引入 List 类，用于返回多个选课记录 +/** + * SelectCourseDao 接口，定义了与学生选课相关的数据库访问方法。 + */ public interface SelectCourseDao { + + /** + * 根据课程 ID 查找已选择该课程的所有学生。 + * + * @param cid 课程的 ID + * @return 返回选修该课程的学生列表，每个学生的选课信息包含课程 ID、学生 ID、学生姓名等 + */ List findStudentSelectedCourseByCourseId(String cid); + /** + * 根据课程 ID 和学生 ID 查找该学生在该课程中的成绩。 + * + * @param cid 课程的 ID + * @param sid 学生的 ID + * @return 返回该学生在该课程中的选课信息，包括成绩等 + */ SelectCourse findScoreByCourseIdAndStudentId(String cid, String sid); + /** + * 更新学生在某课程中的成绩。 + * + * @param cid 课程的 ID + * @param sid 学生的 ID + * @param sScore 学生在该课程中的新成绩 + */ void upDateScoreByCidAndSid(String cid, String sid, String sScore); } diff --git a/src/dao/StudentDao.java b/src/dao/StudentDao.java index 1d9bf0f..392da56 100644 --- a/src/dao/StudentDao.java +++ b/src/dao/StudentDao.java @@ -1,41 +1,122 @@ package dao; -import domain.Course; -import domain.SelectCourse; -import domain.Student; +import domain.Course; // 引入 Course 类，表示课程信息 +import domain.SelectCourse; // 引入 SelectCourse 类，表示学生的选课信息 +import domain.Student; // 引入 Student 类，表示学生信息 -import java.util.List; -import java.util.Map; +import java.util.List; // 引入 List 类，用于返回多个学生或选课记录 +import java.util.Map; // 引入 Map 类，用于接收条件查询参数 /** - * 学生操作的DAO + * 学生操作的DAO接口，定义了与学生信息、选课等相关的数据库操作方法。 */ public interface StudentDao { + + /** + * 根据分页条件和查询条件获取学生列表。 + * + * @param start 起始位置（分页） + * @param rows 每页显示的学生数 + * @param condition 查询条件的 Map 集合（如：学生姓名、学号等） + * @return 返回符合条件的学生列表 + */ List findByPage(int start, int rows, Map condition); + /** + * 获取所有学生信息。 + * + * @return 返回所有学生的列表 + */ List findAll(); + /** + * 根据学生 ID 和密码查询学生信息。 + * + * @param id 学生的学号 + * @param password 学生的密码 + * @return 如果匹配成功，返回学生对象；否则返回 null + */ Student findStudentidAndPassword(String id, String password); + /** + * 根据学生 ID 查找学生信息。 + * + * @param s_id 学生的学号 + * @return 返回学生对象 + */ Student findStudentById(String s_id); + /** + * 添加新学生信息。 + * + * @param student 学生对象，包含要插入的学生信息 + */ void addStudent(Student student); + /** + * 更新学生信息。 + * + * @param student 学生对象，包含要更新的学生信息 + */ void updateInfo(Student student); + /** + * 更新学生密码。 + * + * @param studentid 学生的学号 + * @param newpassword 新的密码 + */ void updatePassword(String studentid, String newpassword); + /** + * 查找学生已选的所有课程信息。 + * + * @param studentid 学生的学号 + * @return 返回该学生已选课程的列表 + */ List findAllSelectCourse(String studentid); + /** + * 查找所有可选课程。 + * + * @return 返回所有可选课程的列表 + */ List findAllOptionalCourse(); + /** + * 为学生添加一门课程。 + * + * @param studentid 学生的学号 + * @param courseid 课程的 ID + */ void addSelectCourse(String studentid, String courseid); + /** + * 根据学生 ID 删除学生。 + * + * @param studentid 学生的学号 + */ void deleteStudentById(String studentid); + /** + * 根据查询条件统计学生总数。 + * + * @param condition 查询条件的 Map 集合 + * @return 返回符合条件的学生总数 + */ int findTotalCount(Map condition); + /** + * 添加包含完整信息的新学生。 + * + * @param updateStudent 学生对象，包含要插入的完整学生信息 + */ void addStudentAllInfo(Student updateStudent); + /** + * 查找所有学生的选课信息。 + * + * @return 返回所有学生的选课信息列表 + */ List findSelectCourseAllStudent(); } diff --git a/src/dao/TeacherDao.java b/src/dao/TeacherDao.java index db62cbb..6e511b5 100644 --- a/src/dao/TeacherDao.java +++ b/src/dao/TeacherDao.java @@ -1,33 +1,95 @@ package dao; -import domain.Course; -import domain.Teacher; +import domain.Course; // 引入 Course 类，表示课程信息 +import domain.Teacher; // 引入 Teacher 类，表示教师信息 -import java.util.List; +import java.util.List; // 引入 List 类，用于返回多个教师或课程信息 /** - * 管理员操作的DAO + * 管理员操作的DAO接口，定义了与教师信息、课程管理等相关的数据库操作方法。 */ public interface TeacherDao { + + /** + * 根据教师 ID 和密码查询教师信息。 + * + * @param id 教师的工号 + * @param password 教师的密码 + * @return 如果匹配成功，返回教师对象；否则返回 null + */ Teacher findTeacheridAndPassword(String id, String password); + /** + * 获取所有教师信息。 + * + * @return 返回所有教师的列表 + */ List findAll(); + /** + * 根据教师 ID 查找该教师的所有可选课程。 + * + * @param t_id 教师的工号 + * @return 返回该教师的所有可选课程 + */ List findMySelfOptionalCourse(String t_id); + /** + * 根据课程 ID 查找课程信息。 + * + * @param cid 课程 ID + * @return 返回课程对象 + */ Course findOptionalCourseByCourseId(String cid); + /** + * 更新课程信息。 + * + * @param updateCourse 包含更新信息的课程对象 + */ void updateCourseInfo(Course updateCourse); + /** + * 删除课程。 + * + * @param cid 课程 ID + */ void deleteCourseById(String cid); + /** + * 更新教师密码。 + * + * @param teacherid 教师的工号 + * @param newpassword 新的密码 + */ void updatePassword(String teacherid, String newpassword); + /** + * 根据教师 ID 查找教师信息。 + * + * @param t_id 教师的工号 + * @return 返回教师对象 + */ Teacher findTeacherById(String t_id); + /** + * 添加教师的完整信息。 + * + * @param updateTeacher 包含教师完整信息的教师对象 + */ void addTeacherAllInfo(Teacher updateTeacher); + /** + * 根据教师 ID 删除教师信息。 + * + * @param teacherid 教师的工号 + */ void deleteTeacherById(String teacherid); + /** + * 更新教师个人信息。 + * + * @param updateTeacher 包含更新信息的教师对象 + */ void updateInfo(Teacher updateTeacher); } diff --git a/src/dao/impl/AdminDaoImpl.java b/src/dao/impl/AdminDaoImpl.java index eaed205..216e844 100644 --- a/src/dao/impl/AdminDaoImpl.java +++ b/src/dao/impl/AdminDaoImpl.java @@ -1,46 +1,79 @@ package dao.impl; -import dao.AdminDao; -import domain.Admin; -import org.springframework.dao.DataAccessException; -import org.springframework.jdbc.core.BeanPropertyRowMapper; -import org.springframework.jdbc.core.JdbcTemplate; -import utils.JDBCUtils; +import dao.AdminDao; // 引入 AdminDao 接口，定义管理员相关的数据访问方法 +import domain.Admin; // 引入 Admin 实体类，表示管理员数据 +import org.springframework.dao.DataAccessException; // 引入数据库访问异常类 +import org.springframework.jdbc.core.BeanPropertyRowMapper; // 用于将查询结果映射为 Java 对象 +import org.springframework.jdbc.core.JdbcTemplate; // JDBC 操作模板，用于简化数据库操作 +import utils.JDBCUtils; // 自定义工具类，用于获取数据库数据源 +/** + * AdminDaoImpl 实现类，负责对管理员信息进行数据库操作。 + */ public class AdminDaoImpl implements AdminDao { + + // 使用 JdbcTemplate 对数据库进行操作，JDBCUtils 提供数据源 private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource()); + /** + * 根据管理员 ID 和密码查询管理员信息。 + * + * @param id 管理员 ID + * @param password 管理员密码 + * @return 如果匹配成功，返回管理员对象；否则返回 null + */ @Override public Admin findAdminidAndPassword(String id, String password) { try { + // SQL 查询语句：根据管理员 ID 和密码查询管理员 String sql = "select * from admin where a_id = ? and a_password = ?"; - Admin admin = template.queryForObject(sql,new BeanPropertyRowMapper(Admin.class),id,password); - return admin; + // 执行查询，并将结果映射为 Admin 对象 + Admin admin = template.queryForObject(sql, new BeanPropertyRowMapper<>(Admin.class), id, password); + return admin; // 返回找到的管理员 } catch (DataAccessException e) { + // 捕获数据库访问异常并打印堆栈信息 e.printStackTrace(); - return null; + return null; // 查询失败时返回 null } } + /** + * 更新管理员密码。 + * + * @param adminid 管理员 ID + * @param newpassword 新密码 + */ @Override public void updatePassword(String adminid, String newpassword) { try { + // SQL 更新语句：根据管理员 ID 更新密码 String sql = "update admin set a_password=? where a_id=?"; - template.update(sql,newpassword,adminid); + // 执行更新操作 + template.update(sql, newpassword, adminid); } catch (Exception e) { + // 捕获异常并打印堆栈信息 e.printStackTrace(); } } + /** + * 根据管理员 ID 查询管理员信息。 + * + * @param id 管理员 ID + * @return 如果存在，返回管理员对象；否则返回 null + */ @Override public Admin findAdminById(String id) { try { + // SQL 查询语句：根据管理员 ID 查询管理员 String sql = "select * from admin where a_id = ?"; - Admin admin = template.queryForObject(sql,new BeanPropertyRowMapper(Admin.class),id); - return admin; + // 执行查询，并将结果映射为 Admin 对象 + Admin admin = template.queryForObject(sql, new BeanPropertyRowMapper<>(Admin.class), id); + return admin; // 返回找到的管理员 } catch (DataAccessException e) { + // 捕获数据库访问异常并打印堆栈信息 e.printStackTrace(); - return null; + return null; // 查询失败时返回 null } } } diff --git a/src/dao/impl/CDCDaoImpl.java b/src/dao/impl/CDCDaoImpl.java index a16f0a0..c0d4723 100644 --- a/src/dao/impl/CDCDaoImpl.java +++ b/src/dao/impl/CDCDaoImpl.java @@ -1,62 +1,92 @@ package dao.impl; -import dao.CDCDao; -import domain.CDC; -import org.springframework.dao.DataAccessException; -import org.springframework.jdbc.core.BeanPropertyRowMapper; -import org.springframework.jdbc.core.JdbcTemplate; -import utils.JDBCUtils; +// 引入相关类和接口 +import dao.CDCDao; // 数据访问对象（DAO）接口 +import domain.CDC; // 表示 CDC 表数据结构的实体类 +import org.springframework.dao.DataAccessException; // 数据访问异常类 +import org.springframework.jdbc.core.BeanPropertyRowMapper; // 用于将结果集映射为实体类 +import org.springframework.jdbc.core.JdbcTemplate; // Spring 的 JDBC 模板类 +import utils.JDBCUtils; // 自定义的工具类，用于获取数据源 -import java.util.List; +import java.util.List; // Java 的 List 接口 +/** + * CDCDaoImpl 实现了 CDCDao 接口，负责与数据库交互以获取 CDC 数据表的信息。 + */ public class CDCDaoImpl implements CDCDao { + + // 使用 JdbcTemplate 进行数据库操作，通过 JDBCUtils 获取数据源 private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource()); + /** + * 查询所有学院名称（去重） + * @return 包含所有学院名称的 CDC 对象列表；查询失败返回 null + */ @Override public List findAllCollege() { try { + // SQL 语句：获取去重的学院名称 String sql = "select distinct college from college_department_class"; + // 使用 JdbcTemplate 执行查询，并将结果映射为 CDC 对象 List cdcs = template.query(sql, new BeanPropertyRowMapper(CDC.class)); - return cdcs; + return cdcs; // 返回查询结果 } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } + /** + * 查询所有系名称（去重） + * @return 包含所有系名称的 CDC 对象列表；查询失败返回 null + */ @Override public List findAllDepartment() { try { + // SQL 语句：获取去重的系名称 String sql = "select distinct department from college_department_class"; + // 使用 JdbcTemplate 执行查询，并将结果映射为 CDC 对象 List cdcs = template.query(sql, new BeanPropertyRowMapper(CDC.class)); - return cdcs; + return cdcs; // 返回查询结果 } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } + /** + * 查询所有班级名称（去重） + * @return 包含所有班级名称的 CDC 对象列表；查询失败返回 null + */ @Override public List findAllClass() { try { + // SQL 语句：获取去重的班级名称 String sql = "select distinct cclass from college_department_class"; + // 使用 JdbcTemplate 执行查询，并将结果映射为 CDC 对象 List cdcs = template.query(sql, new BeanPropertyRowMapper(CDC.class)); - return cdcs; + return cdcs; // 返回查询结果 } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } + /** + * 查询表中的所有数据 + * @return 包含所有数据的 CDC 对象列表；查询失败返回 null + */ @Override public List findAll() { try { + // SQL 语句：获取表中所有数据 String sql = "select * from college_department_class"; + // 使用 JdbcTemplate 执行查询，并将结果映射为 CDC 对象 List cdcs = template.query(sql, new BeanPropertyRowMapper(CDC.class)); - return cdcs; + return cdcs; // 返回查询结果 } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } } diff --git a/src/dao/impl/ComplaintDaoImpl.java b/src/dao/impl/ComplaintDaoImpl.java index da2d947..4d942c2 100644 --- a/src/dao/impl/ComplaintDaoImpl.java +++ b/src/dao/impl/ComplaintDaoImpl.java @@ -1,36 +1,54 @@ package dao.impl; -import dao.ComplaintDao; -import domain.Complaint; -import org.springframework.dao.DataAccessException; -import org.springframework.jdbc.core.BeanPropertyRowMapper; -import org.springframework.jdbc.core.JdbcTemplate; -import utils.JDBCUtils; +// 引入相关类和接口 +import dao.ComplaintDao; // 数据访问对象（DAO）接口 +import domain.Complaint; // 表示 Complaint 表数据结构的实体类 +import org.springframework.dao.DataAccessException; // 数据访问异常类 +import org.springframework.jdbc.core.BeanPropertyRowMapper; // 用于将结果集映射为实体类 +import org.springframework.jdbc.core.JdbcTemplate; // Spring 的 JDBC 模板类 +import utils.JDBCUtils; // 自定义工具类，用于获取数据源 -import java.util.List; +import java.util.List; // Java 的 List 接口 +/** + * ComplaintDaoImpl 实现了 ComplaintDao 接口，负责与数据库交互以操作 Complaint 数据表。 + */ public class ComplaintDaoImpl implements ComplaintDao { + + // 使用 JdbcTemplate 进行数据库操作，通过 JDBCUtils 获取数据源 private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource()); + /** + * 查询所有投诉记录，并按 ID 降序排序 + * @return 包含所有投诉记录的列表；查询失败时返回 null + */ @Override public List findAllComplaint() { try { + // SQL 语句：查询所有投诉记录并按 ID 倒序排列 String sql = "select * from complaint order by id DESC"; + // 使用 JdbcTemplate 执行查询，并将结果映射为 Complaint 对象列表 List complaints = template.query(sql, new BeanPropertyRowMapper(Complaint.class)); - return complaints; + return complaints; // 返回查询结果 } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } + /** + * 添加一条新的投诉记录 + * @param complaint 包含投诉信息的对象（日期和内容） + */ @Override public void addComplaint(Complaint complaint) { try { + // SQL 语句：向 complaint 表插入记录 String sql = "insert into complaint(cdate,content) values(?,?)"; - template.update(sql,complaint.getCdate(),complaint.getContent()); + // 使用 JdbcTemplate 执行更新操作 + template.update(sql, complaint.getCdate(), complaint.getContent()); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 打印异常堆栈信息 } } } diff --git a/src/dao/impl/CourseDaoImpl.java b/src/dao/impl/CourseDaoImpl.java index eb2b243..b6a73c2 100644 --- a/src/dao/impl/CourseDaoImpl.java +++ b/src/dao/impl/CourseDaoImpl.java @@ -1,44 +1,69 @@ package dao.impl; -import dao.CourseDao; -import domain.Course; -import org.springframework.dao.DataAccessException; -import org.springframework.jdbc.core.BeanPropertyRowMapper; -import org.springframework.jdbc.core.JdbcTemplate; -import utils.JDBCUtils; +// 引入相关类和接口 +import dao.CourseDao; // 数据访问对象（DAO）接口 +import domain.Course; // 表示 Course 表数据结构的实体类 +import org.springframework.dao.DataAccessException; // 数据访问异常类 +import org.springframework.jdbc.core.BeanPropertyRowMapper; // 用于将结果集映射为实体类 +import org.springframework.jdbc.core.JdbcTemplate; // Spring 的 JDBC 模板类 +import utils.JDBCUtils; // 自定义工具类，用于获取数据源 +/** + * CourseDaoImpl 实现了 CourseDao 接口，负责与数据库交互以操作 Course 数据表。 + */ public class CourseDaoImpl implements CourseDao { + + // 使用 JdbcTemplate 进行数据库操作，通过 JDBCUtils 获取数据源 private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource()); + /** + * 添加一门可选课程 + * @param c 包含课程信息的 Course 对象 + */ @Override public void addOptionalCourse(Course c) { try { + // SQL 语句：向 course 表插入课程记录 String sql = "insert into course values(?,?,?,?)"; - template.update(sql,c.getC_id(),c.getC_name(),c.getT_id(),c.getC_info()); + // 使用 JdbcTemplate 执行插入操作 + template.update(sql, c.getC_id(), c.getC_name(), c.getT_id(), c.getC_info()); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 打印异常堆栈信息 } } + /** + * 根据课程 ID 查找已选课程 + * @param cid 课程 ID + * @return 查找到的课程对象；未找到时返回 null + */ @Override public Course findSelectCourseByCourseId(String cid) { try { + // SQL 语句：根据课程 ID 查找对应课程信息 String sql = "select * from course where c_id = ?"; - Course course = template.queryForObject(sql,new BeanPropertyRowMapper(Course.class),cid); - return course; + // 使用 JdbcTemplate 执行查询，并将结果映射为 Course 对象 + Course course = template.queryForObject(sql, new BeanPropertyRowMapper(Course.class), cid); + return course; // 返回查询结果 } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } + /** + * 根据课程 ID 删除课程 + * @param cid 课程 ID + */ @Override public void deleteServiceById(String cid) { try { + // SQL 语句：根据课程 ID 删除对应课程记录 String sql = "delete from course where c_id=?"; - template.update(sql,cid); + // 使用 JdbcTemplate 执行删除操作 + template.update(sql, cid); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 打印异常堆栈信息 } } } diff --git a/src/dao/impl/NotifyDaoImpl.java b/src/dao/impl/NotifyDaoImpl.java index 2b96348..c4892ae 100644 --- a/src/dao/impl/NotifyDaoImpl.java +++ b/src/dao/impl/NotifyDaoImpl.java @@ -1,58 +1,88 @@ package dao.impl; -import dao.NotifyDao; -import domain.Notify; -import org.springframework.dao.DataAccessException; -import org.springframework.jdbc.core.BeanPropertyRowMapper; -import org.springframework.jdbc.core.JdbcTemplate; -import utils.JDBCUtils; +// 引入相关类和接口 +import dao.NotifyDao; // 数据访问对象（DAO）接口 +import domain.Notify; // 表示 Notify 表数据结构的实体类 +import org.springframework.dao.DataAccessException; // 数据访问异常类 +import org.springframework.jdbc.core.BeanPropertyRowMapper; // 用于将结果集映射为实体类 +import org.springframework.jdbc.core.JdbcTemplate; // Spring 的 JDBC 模板类 +import utils.JDBCUtils; // 自定义工具类，用于获取数据源 -import java.util.List; +import java.util.List; // Java 的 List 接口 +/** + * NotifyDaoImpl 实现了 NotifyDao 接口，负责与数据库交互以操作 Notify 数据表。 + */ public class NotifyDaoImpl implements NotifyDao { + + // 使用 JdbcTemplate 进行数据库操作，通过 JDBCUtils 获取数据源 private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource()); + /** + * 添加一条通知记录 + * @param notify 包含通知信息的 Notify 对象 + */ @Override public void add(Notify notify) { try { - String sql = "insert into notify(notifyDate,notifyInfo) values(?,?)"; - template.update(sql,notify.getNotifyDate(),notify.getNotifyInfo()); + // SQL 语句：向 notify 表插入通知记录 + String sql = "insert into notify(notifyDate, notifyInfo) values(?, ?)"; + // 使用 JdbcTemplate 执行插入操作 + template.update(sql, notify.getNotifyDate(), notify.getNotifyInfo()); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 打印异常堆栈信息 } } + /** + * 查询所有通知记录，并按 ID 降序排序 + * @return 包含所有通知记录的 List；查询失败时返回 null + */ @Override public List findAllNotify() { try { + // SQL 语句：查询所有通知记录并按 ID 倒序排列 String sql = "select * from notify order by id DESC"; + // 使用 JdbcTemplate 执行查询，并将结果映射为 Notify 对象列表 List notifys = template.query(sql, new BeanPropertyRowMapper(Notify.class)); - return notifys; + return notifys; // 返回查询结果 } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } + /** + * 根据通知 ID 删除通知记录 + * @param notifyid 通知 ID + */ @Override public void deleteNotifyById(String notifyid) { try { + // SQL 语句：根据通知 ID 删除对应的通知记录 String sql = "delete from notify where id=?"; - template.update(sql,notifyid); + // 使用 JdbcTemplate 执行删除操作 + template.update(sql, notifyid); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 打印异常堆栈信息 } } + /** + * 查询最近的三条通知记录 + * @return 包含最近三条通知记录的 List；查询失败时返回 null + */ @Override public List findNotify() { try { + // SQL 语句：查询最近三条通知记录 String sql = "select * from notify order by id DESC limit 3"; + // 使用 JdbcTemplate 执行查询，并将结果映射为 Notify 对象列表 List notify = template.query(sql, new BeanPropertyRowMapper(Notify.class)); - return notify; + return notify; // 返回查询结果 } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } } diff --git a/src/dao/impl/PhotoDaoImpl.java b/src/dao/impl/PhotoDaoImpl.java index 3063863..28636de 100644 --- a/src/dao/impl/PhotoDaoImpl.java +++ b/src/dao/impl/PhotoDaoImpl.java @@ -1,44 +1,69 @@ package dao.impl; -import dao.PhotoDao; -import domain.Photo; -import org.springframework.dao.DataAccessException; -import org.springframework.jdbc.core.BeanPropertyRowMapper; -import org.springframework.jdbc.core.JdbcTemplate; -import utils.JDBCUtils; +// 引入相关类和接口 +import dao.PhotoDao; // 数据访问对象（DAO）接口 +import domain.Photo; // 表示 Photo 表数据结构的实体类 +import org.springframework.dao.DataAccessException; // 数据访问异常类 +import org.springframework.jdbc.core.BeanPropertyRowMapper; // 用于将结果集映射为实体类 +import org.springframework.jdbc.core.JdbcTemplate; // Spring 的 JDBC 模板类 +import utils.JDBCUtils; // 自定义工具类，用于获取数据源 +/** + * PhotoDaoImpl 实现了 PhotoDao 接口，负责与数据库交互以操作 Photo 数据表。 + */ public class PhotoDaoImpl implements PhotoDao { + + // 使用 JdbcTemplate 进行数据库操作，通过 JDBCUtils 获取数据源 private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource()); + /** + * 添加一条照片记录 + * @param photo 包含照片信息的 Photo 对象 + */ @Override public void addPhoto(Photo photo) { try { - String sql = "insert into photo(photo_id,photo_name) values(?,?)"; - template.update(sql,photo.getPhotoId(),photo.getPhotoName()); + // SQL 语句：向 photo 表插入照片记录 + String sql = "insert into photo(photo_id, photo_name) values(?, ?)"; + // 使用 JdbcTemplate 执行插入操作 + template.update(sql, photo.getPhotoId(), photo.getPhotoName()); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 打印异常堆栈信息 } } + /** + * 根据照片 ID 查找照片 + * @param id 照片 ID + * @return 查找到的 Photo 对象；未找到时返回 null + */ @Override public Photo findPhotoByPhotoId(String id) { try { + // SQL 语句：根据照片 ID 查找对应的照片记录 String sql = "select * from photo where photo_id = ?"; - Photo photo = template.queryForObject(sql,new BeanPropertyRowMapper(Photo.class),id); - return photo; + // 使用 JdbcTemplate 执行查询，并将结果映射为 Photo 对象 + Photo photo = template.queryForObject(sql, new BeanPropertyRowMapper(Photo.class), id); + return photo; // 返回查询结果 } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } + /** + * 更新照片信息 + * @param photo 包含更新信息的 Photo 对象 + */ @Override public void updatePhoto(Photo photo) { try { - String sql = "update photo set photo_name=? where photo_id=?"; - template.update(sql,photo.getPhotoName(),photo.getPhotoId()); + // SQL 语句：更新 photo 表中的照片名称 + String sql = "update photo set photo_name = ? where photo_id = ?"; + // 使用 JdbcTemplate 执行更新操作 + template.update(sql, photo.getPhotoName(), photo.getPhotoId()); } catch (Exception e) { - e.printStackTrace(); + e.printStackTrace(); // 打印异常堆栈信息 } } } diff --git a/src/dao/impl/SelectCourseDaoImpl.java b/src/dao/impl/SelectCourseDaoImpl.java index 38a9a28..0809e38 100644 --- a/src/dao/impl/SelectCourseDaoImpl.java +++ b/src/dao/impl/SelectCourseDaoImpl.java @@ -1,53 +1,81 @@ package dao.impl; -import dao.SelectCourseDao; -import domain.SelectCourse; -import org.springframework.dao.DataAccessException; -import org.springframework.jdbc.core.BeanPropertyRowMapper; -import org.springframework.jdbc.core.JdbcTemplate; -import utils.JDBCUtils; +// 引入相关类和接口 +import dao.SelectCourseDao; // 数据访问对象（DAO）接口 +import domain.SelectCourse; // 表示 SelectCourse 表数据结构的实体类 +import org.springframework.dao.DataAccessException; // 数据访问异常类 +import org.springframework.jdbc.core.BeanPropertyRowMapper; // 用于将结果集映射为实体类 +import org.springframework.jdbc.core.JdbcTemplate; // Spring 的 JDBC 模板类 +import utils.JDBCUtils; // 自定义工具类，用于获取数据源 -import java.util.List; +import java.util.List; // Java 的 List 接口 +/** + * SelectCourseDaoImpl 实现了 SelectCourseDao 接口，负责与数据库交互以操作 select_course 数据表。 + */ public class SelectCourseDaoImpl implements SelectCourseDao { + + // 使用 JdbcTemplate 进行数据库操作，通过 JDBCUtils 获取数据源 private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource()); + /** + * 根据课程 ID 查找选修该课程的所有学生及成绩 + * @param cid 课程 ID + * @return 包含学生选课信息的 List；查询失败时返回 null + */ @Override public List findStudentSelectedCourseByCourseId(String cid) { try { - String sql = "select course.c_id,course.c_name,course.c_info,student.s_id,student.s_name,select_course.score\n" + - "from select_course,student,course\n" + - "where student.s_id=select_course.s_id\n" + - "and select_course.c_id=course.c_id\n" + - "and select_course.c_id=?"; - List scs = template.query(sql, new BeanPropertyRowMapper(SelectCourse.class),cid); - return scs; + // SQL 语句：查询选修该课程的所有学生及成绩信息 + String sql = "select course.c_id, course.c_name, course.c_info, student.s_id, student.s_name, select_course.score\n" + + "from select_course, student, course\n" + + "where student.s_id = select_course.s_id\n" + + "and select_course.c_id = course.c_id\n" + + "and select_course.c_id = ?"; + // 使用 JdbcTemplate 执行查询，并将结果映射为 SelectCourse 对象列表 + List scs = template.query(sql, new BeanPropertyRowMapper(SelectCourse.class), cid); + return scs; // 返回查询结果 } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } + /** + * 根据课程 ID 和学生 ID 查找选课记录和成绩 + * @param cid 课程 ID + * @param sid 学生 ID + * @return 查找到的 SelectCourse 对象；未找到时返回 null + */ @Override public SelectCourse findScoreByCourseIdAndStudentId(String cid, String sid) { try { - String sql = "select * from select_course where c_id=? and s_id=?"; + // SQL 语句：查询指定课程和学生的选课记录 + String sql = "select * from select_course where c_id = ? and s_id = ?"; + // 使用 JdbcTemplate 执行查询，并将结果映射为 SelectCourse 对象 SelectCourse sc = template.queryForObject(sql, new BeanPropertyRowMapper(SelectCourse.class), cid, sid); - return sc; - } catch ( - DataAccessException e) { - e.printStackTrace(); - return null; + return sc; // 返回查询结果 + } catch (DataAccessException e) { + e.printStackTrace(); // 打印异常堆栈信息 + return null; // 查询失败时返回 null } } + /** + * 根据课程 ID 和学生 ID 更新成绩 + * @param cid 课程 ID + * @param sid 学生 ID + * @param sScore 学生成绩 + */ @Override public void upDateScoreByCidAndSid(String cid, String sid, String sScore) { try { + // SQL 语句：根据课程 ID 和学生 ID 更新成绩 String sql = "update select_course set score = ? where c_id = ? and s_id = ?"; - template.update(sql,sScore,cid,sid); + // 使用 JdbcTemplate 执行更新操作 + template.update(sql, sScore, cid, sid); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 打印异常堆栈信息 } } } diff --git a/src/dao/impl/StudentDaoImpl.java b/src/dao/impl/StudentDaoImpl.java index 3f5623b..43bb563 100644 --- a/src/dao/impl/StudentDaoImpl.java +++ b/src/dao/impl/StudentDaoImpl.java @@ -1,233 +1,318 @@ package dao.impl; -import dao.StudentDao; -import domain.Course; -import domain.SelectCourse; -import domain.Student; -import org.springframework.dao.DataAccessException; -import org.springframework.jdbc.core.BeanPropertyRowMapper; -import org.springframework.jdbc.core.JdbcTemplate; -import utils.JDBCUtils; - -import java.util.ArrayList; -import java.util.List; -import java.util.Map; -import java.util.Set; +// 引入相关类和接口 +import dao.StudentDao; // StudentDao 接口，定义学生相关的数据访问方法 +import domain.Course; // Course 实体类，表示课程数据 +import domain.SelectCourse; // SelectCourse 实体类，表示学生选课信息 +import domain.Student; // Student 实体类，表示学生数据 +import org.springframework.dao.DataAccessException; // 数据访问异常 +import org.springframework.jdbc.core.BeanPropertyRowMapper; // 将查询结果映射为 Java 对象 +import org.springframework.jdbc.core.JdbcTemplate; // JDBC 操作模板 +import utils.JDBCUtils; // 自定义工具类，用于获取数据库数据源 +import java.util.ArrayList; // ArrayList 类，用于存储参数和结果 +import java.util.List; // List 接口，表示列表 +import java.util.Map; // Map 接口，用于存储查询条件 +import java.util.Set; // Set 接口，用于存储条件的键集合 + +/** + * StudentDaoImpl 实现了 StudentDao 接口，负责操作学生数据表。 + */ public class StudentDaoImpl implements StudentDao { + + // 使用 JdbcTemplate 来简化数据库操作，JDBCUtils 提供数据源 private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource()); + /** + * 获取所有学生信息 + * @return 返回所有学生的 List；查询失败时返回 null + */ @Override public List findAll() { - //使用JDBC操作数据库 try { + // SQL 语句：查询所有学生 String sql = "select * from student"; + // 执行查询并返回结果，使用 BeanPropertyRowMapper 将结果映射为 Student 实体类 List students = template.query(sql, new BeanPropertyRowMapper(Student.class)); return students; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } - } + /** + * 根据学生 ID 和密码查找学生 + * @param id 学生 ID + * @param password 学生密码 + * @return 找到的学生；未找到时返回 null + */ @Override - public Student findStudentidAndPassword(String id,String password) { + public Student findStudentidAndPassword(String id, String password) { try { + // SQL 语句：根据学生 ID 和密码查询学生 String sql = "select * from student where s_id = ? and s_password = ?"; - Student student = template.queryForObject(sql,new BeanPropertyRowMapper(Student.class),id,password); + // 执行查询并返回结果 + Student student = template.queryForObject(sql, new BeanPropertyRowMapper(Student.class), id, password); return student; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } } + /** + * 根据学生 ID 查找学生 + * @param id 学生 ID + * @return 找到的学生；未找到时返回 null + */ @Override public Student findStudentById(String id) { try { + // SQL 语句：根据学生 ID 查询学生信息 String sql = "select * from student where s_id = ?"; - Student student = template.queryForObject(sql,new BeanPropertyRowMapper(Student.class),id); + // 执行查询并返回结果 + Student student = template.queryForObject(sql, new BeanPropertyRowMapper(Student.class), id); return student; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } } + /** + * 添加新学生 + * @param student 学生对象 + */ @Override public void addStudent(Student student) { try { - String sql = "insert into student(s_id,s_password) values(?,?)"; - template.update(sql,student.getS_id(),student.getS_password()); + // SQL 语句：插入学生数据 + String sql = "insert into student(s_id, s_password) values(?, ?)"; + // 执行插入操作 + template.update(sql, student.getS_id(), student.getS_password()); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 更新学生信息 + * @param student 学生对象，包含要更新的信息 + */ @Override public void updateInfo(Student student) { try { - String sql = "update student set s_name =?,s_sex=?,s_age=?,s_phone=?,s_email=?,s_address=?,s_college=?,s_department=?,s_class=? where s_id=?"; - template.update(sql,student.getS_name(),student.getS_sex(),student.getS_age(),student.getS_phone(),student.getS_email(),student.getS_address(),student.getS_college(),student.getS_department(),student.getS_class(),student.getS_id()); + // SQL 语句：更新学生信息 + String sql = "update student set s_name = ?, s_sex = ?, s_age = ?, s_phone = ?, s_email = ?, s_address = ?, s_college = ?, s_department = ?, s_class = ? where s_id = ?"; + // 执行更新操作 + template.update(sql, student.getS_name(), student.getS_sex(), student.getS_age(), + student.getS_phone(), student.getS_email(), student.getS_address(), + student.getS_college(), student.getS_department(), student.getS_class(), student.getS_id()); } catch (Exception e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 更新学生密码 + * @param studentid 学生 ID + * @param newpassword 新密码 + */ @Override public void updatePassword(String studentid, String newpassword) { try { - String sql = "update student set s_password=? where s_id=?"; - template.update(sql,newpassword,studentid); + // SQL 语句：更新学生密码 + String sql = "update student set s_password = ? where s_id = ?"; + // 执行更新操作 + template.update(sql, newpassword, studentid); } catch (Exception e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 查找指定学生的所有选课信息 + * @param studentid 学生 ID + * @return 包含学生选课信息的 List；查询失败时返回 null + */ @Override public List findAllSelectCourse(String studentid) { try { - String sql = "select student.s_id,student.s_name,course.c_id,course.c_name,course.c_info,teacher.t_id,t_name,select_course.score\n" + - "from select_course,student,course,teacher\n" + - "where student.s_id=select_course.s_id\n" + - "and select_course.c_id=course.c_id\n" + - "and course.t_id=teacher.t_id\n" + - "and student.s_id=?"; - List scs = template.query(sql, new BeanPropertyRowMapper(SelectCourse.class),studentid); + // SQL 语句：查询学生的所有选课信息 + String sql = "select student.s_id, student.s_name, course.c_id, course.c_name, course.c_info, teacher.t_id, t_name, select_course.score " + + "from select_course, student, course, teacher " + + "where student.s_id = select_course.s_id " + + "and select_course.c_id = course.c_id " + + "and course.t_id = teacher.t_id " + + "and student.s_id = ?"; + // 执行查询并返回结果 + List scs = template.query(sql, new BeanPropertyRowMapper(SelectCourse.class), studentid); return scs; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } } + /** + * 获取所有可选课程 + * @return 包含所有可选课程的 List；查询失败时返回 null + */ @Override public List findAllOptionalCourse() { try { - String sql = "select course.c_id,course.c_name,course.c_info,teacher.t_id,t_name\n" + - "from course,teacher\n" + - "where course.t_id=teacher.t_id"; + // SQL 语句：查询所有可选课程 + String sql = "select course.c_id, course.c_name, course.c_info, teacher.t_id, t_name " + + "from course, teacher " + + "where course.t_id = teacher.t_id"; + // 执行查询并返回结果 List cs = template.query(sql, new BeanPropertyRowMapper(Course.class)); return cs; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } } + /** + * 学生选修课程 + * @param studentid 学生 ID + * @param courseid 课程 ID + */ @Override public void addSelectCourse(String studentid, String courseid) { try { - String sql = "insert into select_course(s_id,c_id) values(?,?)"; - template.update(sql,studentid,courseid); + // SQL 语句：学生选修课程 + String sql = "insert into select_course(s_id, c_id) values(?, ?)"; + // 执行插入操作 + template.update(sql, studentid, courseid); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 根据学生 ID 删除学生 + * @param studentid 学生 ID + */ @Override public void deleteStudentById(String studentid) { try { - String sql = "delete from student where s_id=?"; - template.update(sql,studentid); + // SQL 语句：删除学生 + String sql = "delete from student where s_id = ?"; + // 执行删除操作 + template.update(sql, studentid); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 查找符合条件的学生总数 + * @param condition 查询条件 + * @return 符合条件的学生总数 + */ @Override public int findTotalCount(Map condition) { - //定义模板初始化sql - String sql = "select count(*) from student where 1=1"; + // 初始化 SQL 语句 + String sql = "select count(*) from student where 1 = 1"; StringBuilder sb = new StringBuilder(sql); - //遍历map + List params = new ArrayList(); // 存储查询参数 + // 遍历查询条件 Set keySet = condition.keySet(); - //定义参数集合 - List params = new ArrayList(); for (String key : keySet) { - System.out.println(key); - //排除分页条件参数 + // 排除分页相关的参数 if ("currentPage".equals(key) || "rows".equals(key)) { continue; } - - //获取value String value = condition.get(key)[0]; - //判断value是否有值 if (value != null && !"".equals(value)) { - //有值 - sb.append(" and "+key+" like ? "); - params.add("%"+value+"%");//?条件的值 + // 添加条件到 SQL 语句 + sb.append(" and " + key + " like ? "); + params.add("%" + value + "%"); // ? 条件的值 } } - System.out.println(sb.toString()); - System.out.println(params); - return template.queryForObject(sb.toString(),Integer.class,params.toArray()); + // 执行查询并返回结果 + return template.queryForObject(sb.toString(), Integer.class, params.toArray()); } + /** + * 添加学生的所有信息 + * @param s 学生对象，包含所有信息 + */ @Override public void addStudentAllInfo(Student s) { try { - String sql = "insert into student(s_id,s_college,s_department,s_class,s_name,s_sex,s_age,s_phone,s_email,s_address) values(?,?,?,?,?,?,?,?,?,?)"; - template.update(sql,s.getS_id(),s.getS_college(),s.getS_department(),s.getS_class(),s.getS_name(),s.getS_sex(),s.getS_age(),s.getS_phone(),s.getS_email(),s.getS_address()); + // SQL 语句：插入学生所有信息 + String sql = "insert into student(s_id, s_college, s_department, s_class, s_name, s_sex, s_age, s_phone, s_email, s_address) values(?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"; + // 执行插入操作 + template.update(sql, s.getS_id(), s.getS_college(), s.getS_department(), s.getS_class(), s.getS_name(), + s.getS_sex(), s.getS_age(), s.getS_phone(), s.getS_email(), s.getS_address()); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 获取所有学生的选课信息 + * @return 所有学生的选课信息；查询失败时返回 null + */ @Override public List findSelectCourseAllStudent() { try { - String sql = "select student.s_id,student.s_name,course.c_id,course.c_name,course.c_info,teacher.t_id,t_name,select_course.score\n" + - "from select_course,student,course,teacher\n" + - "where student.s_id=select_course.s_id\n" + - "and select_course.c_id=course.c_id\n" + - "and course.t_id=teacher.t_id\n"; + // SQL 语句：查询所有学生的选课信息 + String sql = "select student.s_id, student.s_name, course.c_id, course.c_name, course.c_info, teacher.t_id, t_name, select_course.score " + + "from select_course, student, course, teacher " + + "where student.s_id = select_course.s_id " + + "and select_course.c_id = course.c_id " + + "and course.t_id = teacher.t_id"; + // 执行查询并返回结果 List scs = template.query(sql, new BeanPropertyRowMapper(SelectCourse.class)); return scs; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } - } + /** + * 根据条件分页查询学生 + * @param start 起始记录 + * @param rows 每页记录数 + * @param condition 查询条件 + * @return 符合条件的学生列表 + */ @Override public List findByPage(int start, int rows, Map condition) { try { - String sql = "select * from student where 1=1"; + // 初始化 SQL 语句 + String sql = "select * from student where 1 = 1"; StringBuilder sb = new StringBuilder(sql); - //遍历map + List params = new ArrayList(); // 存储查询参数 + // 遍历查询条件 Set keySet = condition.keySet(); - //定义参数集合 - List params = new ArrayList(); for (String key : keySet) { - //排除分页条件参数 + // 排除分页相关的参数 if ("currentPage".equals(key) || "rows".equals(key)) { continue; } - - //获取value String value = condition.get(key)[0]; - //判断value是否有值 if (value != null && !"".equals(value)) { - //有值 - sb.append(" and "+key+" like ? "); - params.add("%"+value+"%");//?条件的值 + // 添加条件到 SQL 语句 + sb.append(" and " + key + " like ? "); + params.add("%" + value + "%"); // ? 条件的值 } } - //添加分页查询 - sb.append(" limit ? , ?"); - //添加分页查询参数值 + // 添加分页条件 + sb.append(" limit ?, ?"); params.add(start); params.add(rows); - System.out.println(sb.toString()); - System.out.println(params); - return template.query(sb.toString(),new BeanPropertyRowMapper(Student.class),params.toArray()); + // 执行查询并返回结果 + return template.query(sb.toString(), new BeanPropertyRowMapper(Student.class), params.toArray()); } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } } } diff --git a/src/dao/impl/TeacherDaoImpl.java b/src/dao/impl/TeacherDaoImpl.java index b998865..dff4846 100644 --- a/src/dao/impl/TeacherDaoImpl.java +++ b/src/dao/impl/TeacherDaoImpl.java @@ -1,137 +1,213 @@ package dao.impl; -import dao.TeacherDao; -import domain.Course; -import domain.Student; -import domain.Teacher; -import org.springframework.dao.DataAccessException; -import org.springframework.jdbc.core.BeanPropertyRowMapper; -import org.springframework.jdbc.core.JdbcTemplate; -import utils.JDBCUtils; +// 引入相关类和接口 +import dao.TeacherDao; // TeacherDao 接口，定义教师相关的数据访问方法 +import domain.Course; // Course 实体类，表示课程数据 +import domain.Teacher; // Teacher 实体类，表示教师数据 +import org.springframework.dao.DataAccessException; // 数据访问异常 +import org.springframework.jdbc.core.BeanPropertyRowMapper; // 将查询结果映射为 Java 对象 +import org.springframework.jdbc.core.JdbcTemplate; // JDBC 操作模板 +import utils.JDBCUtils; // 自定义工具类，用于获取数据库数据源 -import java.util.List; +import java.util.List; // List 接口，表示列表 +/** + * TeacherDaoImpl 实现了 TeacherDao 接口，负责操作教师相关的数据表。 + */ public class TeacherDaoImpl implements TeacherDao { + + // 使用 JdbcTemplate 来简化数据库操作，JDBCUtils 提供数据源 private JdbcTemplate template = new JdbcTemplate(JDBCUtils.getDataSource()); + /** + * 根据教师 ID 和密码查找教师 + * @param id 教师 ID + * @param password 教师密码 + * @return 找到的教师；未找到时返回 null + */ @Override public Teacher findTeacheridAndPassword(String id, String password) { try { + // SQL 语句：根据教师 ID 和密码查询教师 String sql = "select * from teacher where t_id = ? and t_password = ?"; - Teacher teacher = template.queryForObject(sql,new BeanPropertyRowMapper(Teacher.class),id,password); + // 执行查询并返回结果 + Teacher teacher = template.queryForObject(sql, new BeanPropertyRowMapper(Teacher.class), id, password); return teacher; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } } + /** + * 获取所有教师信息 + * @return 所有教师的 List；查询失败时返回 null + */ @Override public List findAll() { try { + // SQL 语句：查询所有教师 String sql = "select * from teacher"; + // 执行查询并返回结果 List teachers = template.query(sql, new BeanPropertyRowMapper(Teacher.class)); return teachers; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } } + /** + * 查找指定教师教授的所有课程 + * @param t_id 教师 ID + * @return 教师教授的课程列表；查询失败时返回 null + */ @Override public List findMySelfOptionalCourse(String t_id) { try { + // SQL 语句：查询教师教授的课程 String sql = "select * from course where t_id = ?"; - List courses = template.query(sql, new BeanPropertyRowMapper(Course.class),t_id); + // 执行查询并返回结果 + List courses = template.query(sql, new BeanPropertyRowMapper(Course.class), t_id); return courses; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } } + /** + * 根据课程 ID 查找课程信息 + * @param cid 课程 ID + * @return 找到的课程；未找到时返回 null + */ @Override public Course findOptionalCourseByCourseId(String cid) { try { + // SQL 语句：根据课程 ID 查询课程信息 String sql = "select * from course where c_id = ?"; - Course c = template.queryForObject(sql,new BeanPropertyRowMapper(Course.class),cid); - return c; + // 执行查询并返回结果 + Course course = template.queryForObject(sql, new BeanPropertyRowMapper(Course.class), cid); + return course; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } } + /** + * 更新课程信息 + * @param updateCourse 要更新的课程信息 + */ @Override public void updateCourseInfo(Course updateCourse) { try { - String sql = "update course set c_name =?,c_info=? where c_id=?"; - template.update(sql,updateCourse.getC_name(),updateCourse.getC_info(),updateCourse.getC_id()); + // SQL 语句：更新课程信息 + String sql = "update course set c_name = ?, c_info = ? where c_id = ?"; + // 执行更新操作 + template.update(sql, updateCourse.getC_name(), updateCourse.getC_info(), updateCourse.getC_id()); } catch (Exception e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 根据课程 ID 删除课程 + * @param cid 课程 ID + */ @Override public void deleteCourseById(String cid) { try { - String sql = "delete from course where c_id=?"; - template.update(sql,cid); + // SQL 语句：删除课程 + String sql = "delete from course where c_id = ?"; + // 执行删除操作 + template.update(sql, cid); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 更新教师密码 + * @param teacherid 教师 ID + * @param newpassword 新密码 + */ @Override public void updatePassword(String teacherid, String newpassword) { try { - String sql = "update teacher set t_password=? where t_id=?"; - template.update(sql,newpassword,teacherid); + // SQL 语句：更新教师密码 + String sql = "update teacher set t_password = ? where t_id = ?"; + // 执行更新操作 + template.update(sql, newpassword, teacherid); } catch (Exception e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 根据教师 ID 查找教师信息 + * @param t_id 教师 ID + * @return 找到的教师；未找到时返回 null + */ @Override public Teacher findTeacherById(String t_id) { try { + // SQL 语句：根据教师 ID 查询教师信息 String sql = "select * from teacher where t_id = ?"; - Teacher teacher = template.queryForObject(sql,new BeanPropertyRowMapper(Teacher.class),t_id); + // 执行查询并返回结果 + Teacher teacher = template.queryForObject(sql, new BeanPropertyRowMapper(Teacher.class), t_id); return teacher; } catch (DataAccessException e) { - e.printStackTrace(); - return null; + e.printStackTrace(); // 捕获并打印异常堆栈 + return null; // 查询失败时返回 null } } + /** + * 添加教师所有信息 + * @param teacher 教师对象，包含所有信息 + */ @Override - public void addTeacherAllInfo(Teacher t) { + public void addTeacherAllInfo(Teacher teacher) { try { - String sql = "insert into teacher(t_id,t_name,t_sex,t_education,t_title) values(?,?,?,?,?)"; - template.update(sql,t.getT_id(),t.getT_name(),t.getT_sex(),t.getT_education(),t.getT_title()); + // SQL 语句：插入教师信息 + String sql = "insert into teacher(t_id, t_name, t_sex, t_education, t_title) values(?, ?, ?, ?, ?)"; + // 执行插入操作 + template.update(sql, teacher.getT_id(), teacher.getT_name(), teacher.getT_sex(), teacher.getT_education(), teacher.getT_title()); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 根据教师 ID 删除教师 + * @param teacherid 教师 ID + */ @Override public void deleteTeacherById(String teacherid) { try { - String sql = "delete from teacher where t_id=?"; - template.update(sql,teacherid); + // SQL 语句：删除教师 + String sql = "delete from teacher where t_id = ?"; + // 执行删除操作 + template.update(sql, teacherid); } catch (DataAccessException e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } } + /** + * 更新教师信息 + * @param teacher 教师对象，包含要更新的信息 + */ @Override - public void updateInfo(Teacher t) { + public void updateInfo(Teacher teacher) { try { - String sql = "update teacher set t_name =?,t_sex=?,t_education=?,t_title=? where t_id=?"; - template.update(sql,t.getT_name(),t.getT_sex(),t.getT_education(),t.getT_title(),t.getT_id()); + // SQL 语句：更新教师信息 + String sql = "update teacher set t_name = ?, t_sex = ?, t_education = ?, t_title = ? where t_id = ?"; + // 执行更新操作 + template.update(sql, teacher.getT_name(), teacher.getT_sex(), teacher.getT_education(), teacher.getT_title(), teacher.getT_id()); } catch (Exception e) { - e.printStackTrace(); + e.printStackTrace(); // 捕获并打印异常堆栈 } - } } diff --git a/src/domain/Admin.java b/src/domain/Admin.java index 5f376b5..a5167a2 100644 --- a/src/domain/Admin.java +++ b/src/domain/Admin.java @@ -1,25 +1,54 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储管理员信息。 +/** + * 管理员类，表示系统中的管理员信息。 + * 包括管理员的工号和密码。 + */ public class Admin { - private String a_id; - private String a_password; + private String a_id; // 管理员工号 + private String a_password; // 管理员密码 + /** + * 获取管理员工号。 + * + * @return 返回管理员的工号 + */ public String getA_id() { return a_id; } + /** + * 设置管理员工号。 + * + * @param a_id 管理员的工号 + */ public void setA_id(String a_id) { this.a_id = a_id; } + /** + * 获取管理员密码。 + * + * @return 返回管理员的密码 + */ public String getA_password() { return a_password; } + /** + * 设置管理员密码。 + * + * @param a_password 管理员的密码 + */ public void setA_password(String a_password) { this.a_password = a_password; } + /** + * 重写 toString 方法，返回管理员信息的字符串表示。 + * + * @return 返回管理员信息的字符串 + */ @Override public String toString() { return "Admin{" + @@ -28,3 +57,4 @@ public class Admin { '}'; } } + diff --git a/src/domain/CDC.java b/src/domain/CDC.java index 5379f31..59fba43 100644 --- a/src/domain/CDC.java +++ b/src/domain/CDC.java @@ -1,35 +1,74 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储学院、系、班级等信息。 +/** + * CDC类，表示学院、系、班级信息。 + * 该类用于表示和操作学院、系及班级的相关信息。 + */ public class CDC { - private String college; - private String department; - private String cclass; + private String college; // 学院名称 + private String department; // 系名称 + private String cclass; // 班级名称 + /** + * 获取学院名称。 + * + * @return 返回学院名称 + */ public String getCollege() { return college; } + /** + * 设置学院名称。 + * + * @param college 学院名称 + */ public void setCollege(String college) { this.college = college; } + /** + * 获取系名称。 + * + * @return 返回系名称 + */ public String getDepartment() { return department; } + /** + * 设置系名称。 + * + * @param department 系名称 + */ public void setDepartment(String department) { this.department = department; } + /** + * 获取班级名称。 + * + * @return 返回班级名称 + */ public String getCclass() { return cclass; } + /** + * 设置班级名称。 + * + * @param cclass 班级名称 + */ public void setCclass(String cclass) { this.cclass = cclass; } + /** + * 重写 toString 方法，返回学院、系、班级信息的字符串表示。 + * + * @return 返回一个包含学院、系、班级信息的字符串 + */ @Override public String toString() { return "CDC{" + diff --git a/src/domain/Complaint.java b/src/domain/Complaint.java index 98a3f55..b8fbed5 100644 --- a/src/domain/Complaint.java +++ b/src/domain/Complaint.java @@ -1,34 +1,74 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储投诉信息。 +/** + * Complaint类，表示投诉信息。 + * 该类用于存储和处理用户或学生的投诉数据，包括投诉ID、投诉日期和投诉内容。 + */ public class Complaint { - private String id; - private String cdate; - private String content; + private String id; // 投诉ID + private String cdate; // 投诉日期 + private String content; // 投诉内容 + + /** + * 获取投诉ID。 + * + * @return 返回投诉的ID + */ public String getId() { return id; } + /** + * 设置投诉ID。 + * + * @param id 投诉ID + */ public void setId(String id) { this.id = id; } + /** + * 获取投诉日期。 + * + * @return 返回投诉日期 + */ public String getCdate() { return cdate; } + /** + * 设置投诉日期。 + * + * @param cdate 投诉日期 + */ public void setCdate(String cdate) { this.cdate = cdate; } + /** + * 获取投诉内容。 + * + * @return 返回投诉的详细内容 + */ public String getContent() { return content; } + /** + * 设置投诉内容。 + * + * @param content 投诉内容 + */ public void setContent(String content) { this.content = content; } + /** + * 重写 toString 方法，返回投诉ID、投诉日期、投诉内容的字符串表示。 + * + * @return 返回一个包含投诉ID、投诉日期、投诉内容信息的字符串 + */ @Override public String toString() { return "Complaint{" + diff --git a/src/domain/Course.java b/src/domain/Course.java index c14390d..b8fbed5 100644 --- a/src/domain/Course.java +++ b/src/domain/Course.java @@ -1,60 +1,80 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储投诉信息。 -public class Course { - private String c_id; - private String c_name; - private String c_info; - private String t_id; - private String t_name; +/** + * Complaint类，表示投诉信息。 + * 该类用于存储和处理用户或学生的投诉数据，包括投诉ID、投诉日期和投诉内容。 + */ +public class Complaint { - public String getC_id() { - return c_id; - } - - public void setC_id(String c_id) { - this.c_id = c_id; - } - - public String getC_name() { - return c_name; - } - - public void setC_name(String c_name) { - this.c_name = c_name; - } + private String id; // 投诉ID + private String cdate; // 投诉日期 + private String content; // 投诉内容 - public String getC_info() { - return c_info; + /** + * 获取投诉ID。 + * + * @return 返回投诉的ID + */ + public String getId() { + return id; } - public void setC_info(String c_info) { - this.c_info = c_info; + /** + * 设置投诉ID。 + * + * @param id 投诉ID + */ + public void setId(String id) { + this.id = id; } - public String getT_id() { - return t_id; + /** + * 获取投诉日期。 + * + * @return 返回投诉日期 + */ + public String getCdate() { + return cdate; } - public void setT_id(String t_id) { - this.t_id = t_id; + /** + * 设置投诉日期。 + * + * @param cdate 投诉日期 + */ + public void setCdate(String cdate) { + this.cdate = cdate; } - public String getT_name() { - return t_name; + /** + * 获取投诉内容。 + * + * @return 返回投诉的详细内容 + */ + public String getContent() { + return content; } - public void setT_name(String t_name) { - this.t_name = t_name; + /** + * 设置投诉内容。 + * + * @param content 投诉内容 + */ + public void setContent(String content) { + this.content = content; } -@Override + /** + * 重写 toString 方法，返回投诉ID、投诉日期、投诉内容的字符串表示。 + * + * @return 返回一个包含投诉ID、投诉日期、投诉内容信息的字符串 + */ + @Override public String toString() { - return "Course{" + - "c_id='" + c_id + '\'' + - ", c_name='" + c_name + '\'' + - ", c_info='" + c_info + '\'' + - ", t_id='" + t_id + '\'' + - ", t_name='" + t_name + '\'' + + return "Complaint{" + + "id='" + id + '\'' + + ", cdate='" + cdate + '\'' + + ", content='" + content + '\'' + '}'; } } diff --git a/src/domain/FileClass.java b/src/domain/FileClass.java index 9318dec..9326ca0 100644 --- a/src/domain/FileClass.java +++ b/src/domain/FileClass.java @@ -1,34 +1,74 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储文件信息。 +/** + * FileClass类，表示文件信息。 + * 该类用于存储文件的名称、路径和大小等基本信息，常用于文件管理或上传功能中。 + */ public class FileClass { - private String fileName; - private String filePath; - private String fileSize; + private String fileName; // 文件名 + private String filePath; // 文件路径 + private String fileSize; // 文件大小 + + /** + * 获取文件名。 + * + * @return 返回文件的名称 + */ public String getFileName() { return fileName; } + /** + * 设置文件名。 + * + * @param fileName 文件名 + */ public void setFileName(String fileName) { this.fileName = fileName; } + /** + * 获取文件路径。 + * + * @return 返回文件的路径 + */ public String getFilePath() { return filePath; } + /** + * 设置文件路径。 + * + * @param filePath 文件路径 + */ public void setFilePath(String filePath) { this.filePath = filePath; } + /** + * 获取文件大小。 + * + * @return 返回文件的大小 + */ public String getFileSize() { return fileSize; } + /** + * 设置文件大小。 + * + * @param fileSize 文件大小 + */ public void setFileSize(String fileSize) { this.fileSize = fileSize; } + /** + * 重写 toString 方法，返回文件名、路径和大小的字符串表示。 + * + * @return 返回包含文件名、文件路径和文件大小信息的字符串 + */ @Override public String toString() { return "FileClass{" + diff --git a/src/domain/Notify.java b/src/domain/Notify.java index 5a3f62d..7bf34a5 100644 --- a/src/domain/Notify.java +++ b/src/domain/Notify.java @@ -1,35 +1,74 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储通知信息。 +/** + * Notify类，表示通知信息。 + * 该类用于存储系统或管理员发送的通知信息，包括通知ID、通知内容和通知日期。 + */ public class Notify { - private String id; - private String notifyInfo; - private String notifyDate; + private String id; // 通知ID + private String notifyInfo; // 通知内容 + private String notifyDate; // 通知日期 + /** + * 获取通知ID。 + * + * @return 返回通知的ID + */ public String getId() { return id; } + /** + * 设置通知ID。 + * + * @param id 通知ID + */ public void setId(String id) { this.id = id; } + /** + * 获取通知内容。 + * + * @return 返回通知的详细内容 + */ public String getNotifyInfo() { return notifyInfo; } + /** + * 设置通知内容。 + * + * @param notifyInfo 通知内容 + */ public void setNotifyInfo(String notifyInfo) { this.notifyInfo = notifyInfo; } + /** + * 获取通知日期。 + * + * @return 返回通知日期 + */ public String getNotifyDate() { return notifyDate; } + /** + * 设置通知日期。 + * + * @param notifyDate 通知日期 + */ public void setNotifyDate(String notifyDate) { this.notifyDate = notifyDate; } + /** + * 重写 toString 方法，返回通知ID、通知内容和通知日期的字符串表示。 + * + * @return 返回一个包含通知ID、通知内容、通知日期信息的字符串 + */ @Override public String toString() { return "Notify{" + diff --git a/src/domain/PageBean.java b/src/domain/PageBean.java index f303146..e6cb3cc 100644 --- a/src/domain/PageBean.java +++ b/src/domain/PageBean.java @@ -1,57 +1,115 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储分页信息。 import java.util.List; /** - * 分页对象 + * PageBean类，表示分页信息。 + * 该类用于分页查询的结果封装，存储每页的记录数据、总记录数、总页数等分页信息。 + * 泛型 T 表示分页数据项的类型。 */ public class PageBean { - private int totalCount; //总记录数 - private int totalPage; //总页码 - private List list; //每页数据 - private int currentPage; //当前页码 - private int rows; //每页显示的记录数 + + private int totalCount; // 总记录数 + private int totalPage; // 总页码数 + private List list; // 当前页的数据 + private int currentPage; // 当前页码 + private int rows; // 每页显示的记录数 + /** + * 获取总记录数。 + * + * @return 返回总记录数 + */ public int getTotalCount() { return totalCount; } + /** + * 设置总记录数。 + * + * @param totalCount 总记录数 + */ public void setTotalCount(int totalCount) { this.totalCount = totalCount; } + /** + * 获取总页数。 + * + * @return 返回总页数 + */ public int getTotalPage() { return totalPage; } + /** + * 设置总页数。 + * + * @param totalPage 总页数 + */ public void setTotalPage(int totalPage) { this.totalPage = totalPage; } + /** + * 获取当前页的数据列表。 + * + * @return 返回当前页的数据列表 + */ public List getList() { return list; } + /** + * 设置当前页的数据列表。 + * + * @param list 当前页的数据列表 + */ public void setList(List list) { this.list = list; } + /** + * 获取当前页码。 + * + * @return 返回当前页码 + */ public int getCurrentPage() { return currentPage; } + /** + * 设置当前页码。 + * + * @param currentPage 当前页码 + */ public void setCurrentPage(int currentPage) { this.currentPage = currentPage; } + /** + * 获取每页显示的记录数。 + * + * @return 返回每页显示的记录数 + */ public int getRows() { return rows; } + /** + * 设置每页显示的记录数。 + * + * @param rows 每页显示的记录数 + */ public void setRows(int rows) { this.rows = rows; } + /** + * 重写 toString 方法，返回分页对象的字符串表示。 + * + * @return 返回分页信息的字符串 + */ @Override public String toString() { return "PageBean{" + diff --git a/src/domain/Photo.java b/src/domain/Photo.java index 4178f04..070ecd5 100644 --- a/src/domain/Photo.java +++ b/src/domain/Photo.java @@ -1,22 +1,46 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储照片信息。 +/** + * Photo类，表示照片信息。 + * 该类用于存储和处理照片的基本数据，包括照片ID和照片名称。 + */ public class Photo { - private String photoId; - private String photoName; + private String photoId; // 照片ID + private String photoName; // 照片名称 + /** + * 获取照片ID。 + * + * @return 返回照片的ID + */ public String getPhotoId() { return photoId; } + /** + * 设置照片ID。 + * + * @param photoId 照片ID + */ public void setPhotoId(String photoId) { this.photoId = photoId; } + /** + * 获取照片名称。 + * + * @return 返回照片的名称 + */ public String getPhotoName() { return photoName; } + /** + * 设置照片名称。 + * + * @param photoName 照片名称 + */ public void setPhotoName(String photoName) { this.photoName = photoName; } diff --git a/src/domain/SelectCourse.java b/src/domain/SelectCourse.java index bc8125b..c41e1cd 100644 --- a/src/domain/SelectCourse.java +++ b/src/domain/SelectCourse.java @@ -1,79 +1,169 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储学生选课信息。 +/** + * SelectCourse类，表示学生的选课信息。 + * 该类用于存储和处理学生选修课程的数据，包括学生ID、课程ID、教师信息及成绩等。 + */ public class SelectCourse { - private String s_id; - private String s_name; - private String c_id; - private String c_name; - private String c_info; - private String t_id; - private String t_name; - private String score; + private String s_id; // 学生ID + private String s_name; // 学生姓名 + private String c_id; // 课程ID + private String c_name; // 课程名称 + private String c_info; // 课程信息 + private String t_id; // 教师ID + private String t_name; // 教师姓名 + private String score; // 学生的课程成绩 + + /** + * 获取学生ID。 + * + * @return 返回学生的ID + */ public String getS_id() { return s_id; } + /** + * 设置学生ID。 + * + * @param s_id 学生ID + */ public void setS_id(String s_id) { this.s_id = s_id; } + /** + * 获取学生姓名。 + * + * @return 返回学生的姓名 + */ public String getS_name() { return s_name; } + /** + * 设置学生姓名。 + * + * @param s_name 学生姓名 + */ public void setS_name(String s_name) { this.s_name = s_name; } + /** + * 获取课程ID。 + * + * @return 返回课程的ID + */ public String getC_id() { return c_id; } + /** + * 设置课程ID。 + * + * @param c_id 课程ID + */ public void setC_id(String c_id) { this.c_id = c_id; } + /** + * 获取课程名称。 + * + * @return 返回课程的名称 + */ public String getC_name() { return c_name; } + /** + * 设置课程名称。 + * + * @param c_name 课程名称 + */ public void setC_name(String c_name) { this.c_name = c_name; } + /** + * 获取课程信息。 + * + * @return 返回课程的详细信息 + */ public String getC_info() { return c_info; } + /** + * 设置课程信息。 + * + * @param c_info 课程信息 + */ public void setC_info(String c_info) { this.c_info = c_info; } + /** + * 获取教师ID。 + * + * @return 返回教师的ID + */ public String getT_id() { return t_id; } + /** + * 设置教师ID。 + * + * @param t_id 教师ID + */ public void setT_id(String t_id) { this.t_id = t_id; } + /** + * 获取教师姓名。 + * + * @return 返回教师的姓名 + */ public String getT_name() { return t_name; } + /** + * 设置教师姓名。 + * + * @param t_name 教师姓名 + */ public void setT_name(String t_name) { this.t_name = t_name; } + /** + * 获取学生的课程成绩。 + * + * @return 返回学生的成绩 + */ public String getScore() { return score; } + /** + * 设置学生的课程成绩。 + * + * @param score 学生的成绩 + */ public void setScore(String score) { this.score = score; } + /** + * 重写 toString 方法，返回选课信息的字符串表示。 + * + * @return 返回一个包含学生ID、学生姓名、课程ID、课程名称、课程信息、教师ID、教师姓名和成绩的字符串 + */ @Override public String toString() { return "SelectCourse{" + diff --git a/src/domain/Student.java b/src/domain/Student.java index 166dca5..ba95461 100644 --- a/src/domain/Student.java +++ b/src/domain/Student.java @@ -1,106 +1,226 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储学生的个人信息。 +/** + * Student类，表示学生的个人信息。 + * 该类用于存储学生的基本信息，包括学生ID、姓名、性别、年龄、联系方式等。 + */ public class Student { - private String s_id; - private String s_college; - private String s_department; - private String s_class; - private String s_name; - private String s_sex; - private String s_age; - private String s_address; - private String s_phone; - private String s_email; - private String s_password; + private String s_id; // 学生ID + private String s_college; // 学院名称 + private String s_department; // 学院下的系别 + private String s_class; // 所属班级 + private String s_name; // 学生姓名 + private String s_sex; // 学生性别 + private String s_age; // 学生年龄 + private String s_address; // 学生住址 + private String s_phone; // 学生联系电话 + private String s_email; // 学生电子邮件 + private String s_password; // 学生登录密码 + + /** + * 获取学生ID。 + * + * @return 返回学生的ID + */ public String getS_id() { return s_id; } + /** + * 设置学生ID。 + * + * @param s_id 学生ID + */ public void setS_id(String s_id) { this.s_id = s_id; } + /** + * 获取学生所属学院。 + * + * @return 返回学生的学院名称 + */ public String getS_college() { return s_college; } + /** + * 设置学生所属学院。 + * + * @param s_college 学生的学院名称 + */ public void setS_college(String s_college) { this.s_college = s_college; } + /** + * 获取学生所属系别。 + * + * @return 返回学生所属的系别 + */ public String getS_department() { return s_department; } + /** + * 设置学生所属系别。 + * + * @param s_department 学生的系别 + */ public void setS_department(String s_department) { this.s_department = s_department; } + /** + * 获取学生所属班级。 + * + * @return 返回学生所属的班级 + */ public String getS_class() { return s_class; } + /** + * 设置学生所属班级。 + * + * @param s_class 学生的班级 + */ public void setS_class(String s_class) { this.s_class = s_class; } + /** + * 获取学生姓名。 + * + * @return 返回学生的姓名 + */ public String getS_name() { return s_name; } + /** + * 设置学生姓名。 + * + * @param s_name 学生姓名 + */ public void setS_name(String s_name) { this.s_name = s_name; } + /** + * 获取学生性别。 + * + * @return 返回学生的性别 + */ public String getS_sex() { return s_sex; } + /** + * 设置学生性别。 + * + * @param s_sex 学生性别 + */ public void setS_sex(String s_sex) { this.s_sex = s_sex; } + /** + * 获取学生年龄。 + * + * @return 返回学生的年龄 + */ public String getS_age() { return s_age; } + /** + * 设置学生年龄。 + * + * @param s_age 学生的年龄 + */ public void setS_age(String s_age) { this.s_age = s_age; } + /** + * 获取学生地址。 + * + * @return 返回学生的住址 + */ public String getS_address() { return s_address; } + /** + * 设置学生地址。 + * + * @param s_address 学生的住址 + */ public void setS_address(String s_address) { this.s_address = s_address; } + /** + * 获取学生联系电话。 + * + * @return 返回学生的联系电话 + */ public String getS_phone() { return s_phone; } + /** + * 设置学生联系电话。 + * + * @param s_phone 学生的联系电话 + */ public void setS_phone(String s_phone) { this.s_phone = s_phone; } + /** + * 获取学生电子邮件。 + * + * @return 返回学生的电子邮件地址 + */ public String getS_email() { return s_email; } + /** + * 设置学生电子邮件。 + * + * @param s_email 学生的电子邮件地址 + */ public void setS_email(String s_email) { this.s_email = s_email; } + /** + * 获取学生登录密码。 + * + * @return 返回学生的登录密码 + */ public String getS_password() { return s_password; } + /** + * 设置学生登录密码。 + * + * @param s_password 学生的登录密码 + */ public void setS_password(String s_password) { this.s_password = s_password; } + /** + * 重写 toString 方法，返回学生信息的字符串表示。 + * + * @return 返回一个包含学生ID、学院、系别、班级、姓名、性别、年龄、地址、电话、电子邮件和密码的字符串 + */ @Override public String toString() { return "Student{" + diff --git a/src/domain/Teacher.java b/src/domain/Teacher.java index 63b9c15..21486e9 100644 --- a/src/domain/Teacher.java +++ b/src/domain/Teacher.java @@ -1,61 +1,131 @@ -package domain; +package domain; // 定义在 domain 包下，表示该类是领域对象类，用于存储教师的个人信息。 +/** + * Teacher类，表示教师的个人信息。 + * 该类用于存储教师的基本信息，包括教师ID、姓名、性别、教育背景、职称和登录密码。 + */ public class Teacher { - private String t_id; - private String t_name; - private String t_sex; - private String t_education; - private String t_title; - private String t_password; + private String t_id; // 教师ID + private String t_name; // 教师姓名 + private String t_sex; // 教师性别 + private String t_education; // 教师教育背景 + private String t_title; // 教师职称 + private String t_password; // 教师登录密码 + + /** + * 获取教师ID。 + * + * @return 返回教师的ID + */ public String getT_id() { return t_id; } + /** + * 设置教师ID。 + * + * @param t_id 教师ID + */ public void setT_id(String t_id) { this.t_id = t_id; } + /** + * 获取教师姓名。 + * + * @return 返回教师的姓名 + */ public String getT_name() { return t_name; } + /** + * 设置教师姓名。 + * + * @param t_name 教师姓名 + */ public void setT_name(String t_name) { this.t_name = t_name; } + /** + * 获取教师性别。 + * + * @return 返回教师的性别 + */ public String getT_sex() { return t_sex; } + /** + * 设置教师性别。 + * + * @param t_sex 教师性别 + */ public void setT_sex(String t_sex) { this.t_sex = t_sex; } + /** + * 获取教师教育背景。 + * + * @return 返回教师的教育背景 + */ public String getT_education() { return t_education; } + /** + * 设置教师教育背景。 + * + * @param t_education 教师教育背景 + */ public void setT_education(String t_education) { this.t_education = t_education; } + /** + * 获取教师职称。 + * + * @return 返回教师的职称 + */ public String getT_title() { return t_title; } + /** + * 设置教师职称。 + * + * @param t_title 教师职称 + */ public void setT_title(String t_title) { this.t_title = t_title; } + /** + * 获取教师登录密码。 + * + * @return 返回教师的登录密码 + */ public String getT_password() { return t_password; } + /** + * 设置教师登录密码。 + * + * @param t_password 教师的登录密码 + */ public void setT_password(String t_password) { this.t_password = t_password; } + /** + * 重写 toString 方法，返回教师信息的字符串表示。 + * + * @return 返回一个包含教师ID、姓名、性别、教育背景、职称和密码的字符串 + */ @Override public String toString() { return "Teacher{" + diff --git a/src/service/impl/AdminServiceImpl.java b/src/service/impl/AdminServiceImpl.java index 87f46e5..313eef2 100644 --- a/src/service/impl/AdminServiceImpl.java +++ b/src/service/impl/AdminServiceImpl.java @@ -1,25 +1,48 @@ package service.impl; -import dao.AdminDao; -import dao.impl.AdminDaoImpl; -import domain.Admin; -import service.AdminService; +import dao.AdminDao; // 导入 AdminDao 接口，用于操作管理员相关的数据。 +import dao.impl.AdminDaoImpl; // 导入 AdminDaoImpl 类，实际的管理员数据访问实现。 +import domain.Admin; // 导入 Admin 类，表示管理员实体。 +import service.AdminService; // 导入 AdminService 接口，定义管理员服务层的业务逻辑。 +/** + * AdminServiceImpl 类，负责实现管理员相关的业务逻辑。 + * 该类调用 AdminDao 实现与数据库的交互，为管理员提供登录、密码更新等操作。 + */ public class AdminServiceImpl implements AdminService { - private AdminDao dao = new AdminDaoImpl(); + private AdminDao dao = new AdminDaoImpl(); // 实例化 AdminDaoImpl 对象，操作管理员数据。 + + /** + * 实现管理员登录功能。 + * + * @param admin 传入管理员对象，包含管理员ID和密码。 + * @return 返回管理员对象，如果登录成功，则返回对应的管理员信息，否则返回null。 + */ @Override public Admin login(Admin admin) { - return dao.findAdminidAndPassword(admin.getA_id(),admin.getA_password()); + return dao.findAdminidAndPassword(admin.getA_id(), admin.getA_password()); } + /** + * 更新管理员密码。 + * + * @param adminid 管理员ID。 + * @param newpassword 新密码。 + */ @Override public void updatePassword(String adminid, String newpassword) { - dao.updatePassword(adminid,newpassword); + dao.updatePassword(adminid, newpassword); // 调用 Dao 层方法更新密码。 } + /** + * 根据管理员ID查找管理员信息。 + * + * @param admin 管理员对象，包含要查询的管理员ID。 + * @return 返回对应的管理员信息，如果没有找到则返回 null。 + */ @Override public Admin findAdminById(Admin admin) { - return dao.findAdminById(admin.getA_id()); + return dao.findAdminById(admin.getA_id()); // 调用 Dao 层方法根据管理员ID查询信息。 } } diff --git a/src/service/impl/CDCServiceImpl.java b/src/service/impl/CDCServiceImpl.java index 768d69f..234dc31 100644 --- a/src/service/impl/CDCServiceImpl.java +++ b/src/service/impl/CDCServiceImpl.java @@ -1,32 +1,57 @@ package service.impl; -import dao.CDCDao; -import dao.impl.CDCDaoImpl; -import domain.CDC; -import service.CDCService; +import dao.CDCDao; // 导入 CDCDao 接口，操作与 CDC（学院、部门、班级）相关的数据。 +import dao.impl.CDCDaoImpl; // 导入 CDCDaoImpl 类，实际的 CDC 数据访问实现。 +import domain.CDC; // 导入 CDC 类，表示学院、部门、班级等信息的实体。 +import service.CDCService; // 导入 CDCService 接口，定义 CDC 服务层的业务逻辑。 -import java.util.List; +import java.util.List; // 导入 List 类，作为返回的数据类型，用于返回多个结果。 +/** + * CDCServiceImpl 类，负责实现与学院、部门和班级相关的业务逻辑。 + * 该类调用 CDCDao 实现与数据库的交互，为客户端提供学院、部门、班级数据查询服务。 + */ public class CDCServiceImpl implements CDCService { - private CDCDao dao = new CDCDaoImpl(); + private CDCDao dao = new CDCDaoImpl(); // 实例化 CDCDaoImpl 对象，用于操作 CDC 数据。 + + /** + * 获取所有学院信息。 + * + * @return 返回包含所有学院信息的 List。 + */ @Override public List findAllCollege() { - return dao.findAllCollege(); + return dao.findAllCollege(); // 调用 DAO 层方法获取所有学院数据。 } + /** + * 获取所有部门信息。 + * + * @return 返回包含所有部门信息的 List。 + */ @Override public List findAllDepartment() { - return dao.findAllDepartment(); + return dao.findAllDepartment(); // 调用 DAO 层方法获取所有部门数据。 } + /** + * 获取所有班级信息。 + * + * @return 返回包含所有班级信息的 List。 + */ @Override public List findAllClass() { - return dao.findAllClass(); + return dao.findAllClass(); // 调用 DAO 层方法获取所有班级数据。 } + /** + * 获取所有学院、部门、班级的信息。 + * + * @return 返回包含所有学院、部门、班级信息的 List。 + */ @Override public List findAll() { - return dao.findAll(); + return dao.findAll(); // 调用 DAO 层方法获取所有学院、部门和班级数据。 } } diff --git a/src/service/impl/ComplaintServiceImpl.java b/src/service/impl/ComplaintServiceImpl.java index 30af07b..4fb1a77 100644 --- a/src/service/impl/ComplaintServiceImpl.java +++ b/src/service/impl/ComplaintServiceImpl.java @@ -1,22 +1,37 @@ package service.impl; -import dao.ComplaintDao; -import dao.impl.ComplaintDaoImpl; -import domain.Complaint; -import service.ComplaintService; +import dao.ComplaintDao; // 导入 ComplaintDao 接口，操作与投诉相关的数据。 +import dao.impl.ComplaintDaoImpl; // 导入 ComplaintDaoImpl 类，实际的 Complaint 数据访问实现。 +import domain.Complaint; // 导入 Complaint 类，表示投诉信息的实体类。 +import service.ComplaintService; // 导入 ComplaintService 接口，定义投诉服务层的业务逻辑。 -import java.util.List; +import java.util.List; // 导入 List 类，作为返回的数据类型，用于返回多个结果。 +/** + * ComplaintServiceImpl 类，负责实现与投诉信息相关的业务逻辑。 + * 该类调用 ComplaintDao 实现与数据库的交互，为客户端提供投诉数据的查询和添加服务。 + */ public class ComplaintServiceImpl implements ComplaintService { - private ComplaintDao dao = new ComplaintDaoImpl(); + private ComplaintDao dao = new ComplaintDaoImpl(); // 实例化 ComplaintDaoImpl 对象，用于操作投诉数据。 + + /** + * 获取所有投诉信息。 + * + * @return 返回所有投诉信息的 List。 + */ @Override public List findAll() { - return dao.findAllComplaint(); + return dao.findAllComplaint(); // 调用 DAO 层方法获取所有投诉数据。 } + /** + * 添加投诉信息。 + * + * @param complaint 需要添加的投诉信息。 + */ @Override public void addComplaint(Complaint complaint) { - dao.addComplaint(complaint); + dao.addComplaint(complaint); // 调用 DAO 层方法将投诉数据添加到数据库。 } } diff --git a/src/service/impl/CourseServiceImpl.java b/src/service/impl/CourseServiceImpl.java index 48f6c53..36366e5 100644 --- a/src/service/impl/CourseServiceImpl.java +++ b/src/service/impl/CourseServiceImpl.java @@ -1,24 +1,46 @@ package service.impl; -import dao.CourseDao; -import dao.impl.CourseDaoImpl; -import domain.Course; -import service.CourseService; +import dao.CourseDao; // 导入 CourseDao 接口，操作与课程相关的数据。 +import dao.impl.CourseDaoImpl; // 导入 CourseDaoImpl 类，实际的 Course 数据访问实现。 +import domain.Course; // 导入 Course 类，表示课程信息的实体类。 +import service.CourseService; // 导入 CourseService 接口，定义课程服务层的业务逻辑。 +/** + * CourseServiceImpl 类，实现了 CourseService 接口，负责处理与课程信息相关的业务逻辑。 + * 该类通过调用 CourseDao 实现与数据库的交互，提供添加课程、查询课程及删除课程的服务。 + */ public class CourseServiceImpl implements CourseService { - private CourseDao dao = new CourseDaoImpl(); + + private CourseDao dao = new CourseDaoImpl(); // 实例化 CourseDaoImpl 对象，用于操作课程数据。 + + /** + * 添加一门选修课。 + * + * @param course 要添加的课程信息。 + */ @Override public void addOptionalCourse(Course course) { - dao.addOptionalCourse(course); + dao.addOptionalCourse(course); // 调用 DAO 层方法将课程信息添加到数据库。 } + /** + * 根据课程 ID 查询已选课程信息。 + * + * @param cid 课程 ID。 + * @return 返回对应课程的 Course 对象。 + */ @Override public Course findSelectCourseByCourseId(String cid) { - return dao.findSelectCourseByCourseId(cid); + return dao.findSelectCourseByCourseId(cid); // 调用 DAO 层方法根据课程 ID 查询已选课程。 } + /** + * 删除选修课程信息。 + * + * @param cid 课程 ID。 + */ @Override public void deleteServiceById(String cid) { - dao.deleteServiceById(cid); + dao.deleteServiceById(cid); // 调用 DAO 层方法删除课程信息。 } } diff --git a/src/service/impl/NotifyServiceImpl.java b/src/service/impl/NotifyServiceImpl.java index 61086cc..00c4a32 100644 --- a/src/service/impl/NotifyServiceImpl.java +++ b/src/service/impl/NotifyServiceImpl.java @@ -1,32 +1,57 @@ package service.impl; -import dao.NotifyDao; -import dao.impl.NotifyDaoImpl; -import domain.Notify; -import service.NotifyService; +import dao.NotifyDao; // 导入 NotifyDao 接口，操作通知相关的数据。 +import dao.impl.NotifyDaoImpl; // 导入 NotifyDaoImpl 类，实际的 Notify 数据访问实现。 +import domain.Notify; // 导入 Notify 类，表示通知信息的实体类。 +import service.NotifyService; // 导入 NotifyService 接口，定义通知服务层的业务逻辑。 import java.util.List; +/** + * NotifyServiceImpl 类，实现了 NotifyService 接口，负责处理与通知信息相关的业务逻辑。 + * 该类通过调用 NotifyDao 实现与数据库的交互，提供添加通知、查询通知、删除通知等服务。 + */ public class NotifyServiceImpl implements NotifyService { - private NotifyDao dao = new NotifyDaoImpl(); + private NotifyDao dao = new NotifyDaoImpl(); // 实例化 NotifyDaoImpl 对象，用于操作通知数据。 + + /** + * 添加通知。 + * + * @param notify 要添加的通知信息。 + */ @Override public void addNotify(Notify notify) { - dao.add(notify); + dao.add(notify); // 调用 DAO 层方法将通知信息添加到数据库。 } + /** + * 查询通知信息。 + * + * @return 返回通知信息的列表。 + */ @Override public List find() { - return dao.findNotify(); + return dao.findNotify(); // 调用 DAO 层方法查询通知信息。 } + /** + * 查询所有通知信息。 + * + * @return 返回所有通知信息的列表。 + */ @Override public List findAll() { - return dao.findAllNotify(); + return dao.findAllNotify(); // 调用 DAO 层方法查询所有通知信息。 } + /** + * 根据通知 ID 删除通知。 + * + * @param notifyid 通知 ID。 + */ @Override public void deleteNotifyById(String notifyid) { - dao.deleteNotifyById(notifyid); + dao.deleteNotifyById(notifyid); // 调用 DAO 层方法删除指定通知 ID 的通知。 } } diff --git a/src/service/impl/PhotoServiceImpl.java b/src/service/impl/PhotoServiceImpl.java index 391570a..78a1ba4 100644 --- a/src/service/impl/PhotoServiceImpl.java +++ b/src/service/impl/PhotoServiceImpl.java @@ -1,25 +1,46 @@ package service.impl; -import dao.PhotoDao; -import dao.impl.PhotoDaoImpl; -import domain.Photo; -import service.PhotoService; +import dao.PhotoDao; // 导入 PhotoDao 接口，操作与照片相关的数据。 +import dao.impl.PhotoDaoImpl; // 导入 PhotoDaoImpl 类，实际的 Photo 数据访问实现。 +import domain.Photo; // 导入 Photo 类，表示照片信息的实体类。 +import service.PhotoService; // 导入 PhotoService 接口，定义照片服务层的业务逻辑。 +/** + * PhotoServiceImpl 类，实现了 PhotoService 接口，负责处理与照片信息相关的业务逻辑。 + * 该类通过调用 PhotoDao 实现与数据库的交互，提供添加照片、查询照片、更新照片等服务。 + */ public class PhotoServiceImpl implements PhotoService { - private PhotoDao dao = new PhotoDaoImpl(); + private PhotoDao dao = new PhotoDaoImpl(); // 实例化 PhotoDaoImpl 对象，用于操作照片数据。 + + /** + * 添加照片。 + * + * @param photo 要添加的照片信息。 + */ @Override public void addPhoto(Photo photo) { - dao.addPhoto(photo); + dao.addPhoto(photo); // 调用 DAO 层方法将照片信息添加到数据库。 } + /** + * 根据照片 ID 查找照片。 + * + * @param id 照片 ID。 + * @return 返回指定 ID 的照片信息。 + */ @Override public Photo findPhotoByPhotoId(String id) { - return dao.findPhotoByPhotoId(id); + return dao.findPhotoByPhotoId(id); // 调用 DAO 层方法查询指定 ID 的照片。 } + /** + * 更新照片信息。 + * + * @param photo 要更新的照片信息。 + */ @Override public void updatePhoto(Photo photo) { - dao.updatePhoto(photo); + dao.updatePhoto(photo); // 调用 DAO 层方法更新照片信息。 } } diff --git a/src/service/impl/SelectCourseServiceImpl.java b/src/service/impl/SelectCourseServiceImpl.java index 0c7a2c7..cde57a7 100644 --- a/src/service/impl/SelectCourseServiceImpl.java +++ b/src/service/impl/SelectCourseServiceImpl.java @@ -1,27 +1,52 @@ package service.impl; -import dao.SelectCourseDao; -import dao.impl.SelectCourseDaoImpl; -import domain.SelectCourse; -import service.SelectCourseService; +import dao.SelectCourseDao; // 导入 SelectCourseDao 接口，操作选课数据。 +import dao.impl.SelectCourseDaoImpl; // 导入 SelectCourseDaoImpl 类，实际的选课数据访问实现。 +import domain.SelectCourse; // 导入 SelectCourse 类，表示选课信息的实体类。 +import service.SelectCourseService; // 导入 SelectCourseService 接口，定义选课服务层的业务逻辑。 import java.util.List; +/** + * SelectCourseServiceImpl 类，实现了 SelectCourseService 接口，负责处理与选课信息相关的业务逻辑。 + * 该类通过调用 SelectCourseDao 实现与数据库的交互，提供查询学生选课、查询成绩、更新成绩等服务。 + */ public class SelectCourseServiceImpl implements SelectCourseService { - private SelectCourseDao dao = new SelectCourseDaoImpl(); + private SelectCourseDao dao = new SelectCourseDaoImpl(); // 实例化 SelectCourseDaoImpl 对象，用于操作选课数据。 + + /** + * 根据课程 ID 查找选了该课程的学生列表。 + * + * @param cid 课程 ID。 + * @return 返回选了该课程的所有学生信息列表。 + */ @Override public List findStudentSelectedCourseByCourseId(String cid) { - return dao.findStudentSelectedCourseByCourseId(cid); + return dao.findStudentSelectedCourseByCourseId(cid); // 调用 DAO 层方法根据课程 ID 查找所有选课学生。 } + /** + * 根据课程 ID 和学生 ID 查找学生的成绩信息。 + * + * @param cid 课程 ID。 + * @param sid 学生 ID。 + * @return 返回指定课程和学生的成绩信息。 + */ @Override public SelectCourse findScoreByCourseIdAndStudentId(String cid, String sid) { - return dao.findScoreByCourseIdAndStudentId(cid,sid); + return dao.findScoreByCourseIdAndStudentId(cid, sid); // 调用 DAO 层方法查找指定课程和学生的成绩。 } + /** + * 更新指定课程和学生的成绩。 + * + * @param cid 课程 ID。 + * @param sid 学生 ID。 + * @param sScore 新的成绩。 + */ @Override public void upDateScoreByCidAndSid(String cid, String sid, String sScore) { - dao.upDateScoreByCidAndSid(cid,sid,sScore); + dao.upDateScoreByCidAndSid(cid, sid, sScore); // 调用 DAO 层方法更新指定学生和课程的成绩。 } } diff --git a/src/service/impl/StudentServiceImpl.java b/src/service/impl/StudentServiceImpl.java index 9fb17eb..0169c3e 100644 --- a/src/service/impl/StudentServiceImpl.java +++ b/src/service/impl/StudentServiceImpl.java @@ -1,114 +1,196 @@ package service.impl; -import dao.StudentDao; -import dao.impl.StudentDaoImpl; -import domain.Course; -import domain.PageBean; -import domain.SelectCourse; -import domain.Student; -import service.StudentService; +import dao.StudentDao; // 导入 StudentDao 接口，操作学生数据。 +import dao.impl.StudentDaoImpl; // 导入 StudentDaoImpl 类，实际的学生数据访问实现。 +import domain.Course; // 导入 Course 类，表示课程信息。 +import domain.PageBean; // 导入 PageBean 类，表示分页对象。 +import domain.SelectCourse; // 导入 SelectCourse 类，表示选课信息。 +import domain.Student; // 导入 Student 类，表示学生信息。 +import service.StudentService; // 导入 StudentService 接口，定义学生服务层的业务逻辑。 + import java.util.List; import java.util.Map; +/** + * StudentServiceImpl 类实现了 StudentService 接口，负责学生相关业务逻辑的处理。 + * 该类通过调用 StudentDao 实现与数据库的交互，提供了学生登录、注册、信息更新、分页查询等功能。 + */ public class StudentServiceImpl implements StudentService { - private StudentDao dao = new StudentDaoImpl(); + private StudentDao dao = new StudentDaoImpl(); // 实例化 StudentDaoImpl 对象，用于操作学生数据。 + + /** + * 分页查询学生信息。 + * + * @param _currentPage 当前页码。 + * @param _rows 每页显示的记录数。 + * @param condition 查询条件，包含多个条件的 Map。 + * @return 返回封装了学生信息的 PageBean 对象。 + */ @Override public PageBean findStudentByPage(String _currentPage, String _rows, Map condition) { - + // 转换当前页和每页记录数 int currentPage = Integer.parseInt(_currentPage); int rows = Integer.parseInt(_rows); - //创建新的PageBean对象 + // 创建新的 PageBean 对象 PageBean pb = new PageBean(); - //设置参数 + // 设置分页参数 pb.setCurrentPage(currentPage); pb.setRows(rows); - //调用dao查询总记录数 + // 查询总记录数并设置到 PageBean int totalCount = dao.findTotalCount(condition); pb.setTotalCount(totalCount); - //调用dao查询List集合 - //计算开始记录的索引 + // 计算开始记录的索引 int start = (currentPage - 1) * rows; - Listlist = dao.findByPage(start,rows,condition); + List list = dao.findByPage(start, rows, condition); // 查询分页数据 pb.setList(list); - //计算总页码 - int totalPage = (totalCount % rows) == 0 ? totalCount/rows : (totalCount/rows) + 1; + // 计算总页码 + int totalPage = (totalCount % rows) == 0 ? totalCount / rows : (totalCount / rows) + 1; pb.setTotalPage(totalPage); return pb; } + /** + * 查询所有学生信息。 + * + * @return 返回所有学生的列表。 + */ @Override public List findAll() { - return dao.findAll(); + return dao.findAll(); // 调用 DAO 层的 findAll 方法获取所有学生信息 } + /** + * 学生登录验证。 + * + * @param student 学生对象，包含学生 ID 和密码。 + * @return 如果验证通过，返回学生信息；否则返回 null。 + */ @Override public Student login(Student student) { - return dao.findStudentidAndPassword(student.getS_id(),student.getS_password()); + return dao.findStudentidAndPassword(student.getS_id(), student.getS_password()); // 调用 DAO 层方法进行登录验证 } + /** + * 根据学生 ID 查询学生信息。 + * + * @param student 学生对象，包含学生 ID。 + * @return 返回指定学生的详细信息。 + */ @Override public Student findStudentById(Student student) { - return dao.findStudentById(student.getS_id()); + return dao.findStudentById(student.getS_id()); // 调用 DAO 层方法根据学生 ID 查询学生信息 } + /** + * 学生注册。 + * + * @param student 学生对象，包含学生注册所需的所有信息。 + */ @Override public void register(Student student) { - dao.addStudent(student); + dao.addStudent(student); // 调用 DAO 层方法注册学生 } + /** + * 更新学生信息。 + * + * @param student 学生对象，包含更新后的信息。 + */ @Override public void updateInfo(Student student) { - dao.updateInfo(student); + dao.updateInfo(student); // 调用 DAO 层方法更新学生信息 } + /** + * 更新学生密码。 + * + * @param studentid 学生 ID。 + * @param newpassword 新密码。 + */ @Override public void updatePassword(String studentid, String newpassword) { - dao.updatePassword(studentid,newpassword); + dao.updatePassword(studentid, newpassword); // 调用 DAO 层方法更新学生密码 } + /** + * 根据学生 ID 查询该学生选修的所有课程。 + * + * @param studentid 学生 ID。 + * @return 返回该学生选修的所有课程信息。 + */ @Override public List findAllSelectCourse(String studentid) { - return dao.findAllSelectCourse(studentid); + return dao.findAllSelectCourse(studentid); // 调用 DAO 层方法获取该学生的选课信息 } + /** + * 查询所有可选课程。 + * + * @return 返回所有可选课程的列表。 + */ @Override public List findAllOptionalCourse() { - return dao.findAllOptionalCourse(); + return dao.findAllOptionalCourse(); // 调用 DAO 层方法获取所有可选课程信息 } + /** + * 学生选课。 + * + * @param studentid 学生 ID。 + * @param courseid 课程 ID。 + */ @Override public void addSelectCourse(String studentid, String courseid) { - dao.addSelectCourse(studentid,courseid); + dao.addSelectCourse(studentid, courseid); // 调用 DAO 层方法进行选课 } + /** + * 删除学生信息。 + * + * @param studentid 学生 ID。 + */ @Override public void deleteStudentById(String studentid) { - dao.deleteStudentById(studentid); + dao.deleteStudentById(studentid); // 调用 DAO 层方法删除指定学生 } + /** + * 批量删除学生信息。 + * + * @param sids 学生 ID 数组，包含多个学生 ID。 + */ @Override public void deleteSelectStudent(String[] sids) { if (sids != null && sids.length > 0) { - for (String sid: sids) { - dao.deleteStudentById(sid); + for (String sid : sids) { + dao.deleteStudentById(sid); // 调用 DAO 层方法批量删除学生 } } - } + /** + * 添加学生的完整信息。 + * + * @param updateStudent 学生对象，包含完整的学生信息。 + */ @Override public void addStudentAllInfo(Student updateStudent) { - dao.addStudentAllInfo(updateStudent); + dao.addStudentAllInfo(updateStudent); // 调用 DAO 层方法添加学生的完整信息 } + /** + * 查询所有学生选课信息。 + * + * @return 返回所有学生的选课信息。 + */ @Override public List findSelectCourseAllStudent() { - return dao.findSelectCourseAllStudent(); + return dao.findSelectCourseAllStudent(); // 调用 DAO 层方法获取所有学生的选课信息 } } diff --git a/src/service/impl/TeacherServiceImpl.java b/src/service/impl/TeacherServiceImpl.java index e3ff400..dc3c714 100644 --- a/src/service/impl/TeacherServiceImpl.java +++ b/src/service/impl/TeacherServiceImpl.java @@ -1,68 +1,133 @@ package service.impl; -import dao.TeacherDao; -import domain.Course; -import domain.Teacher; -import dao.impl.TeacherDaoImpl; -import service.TeacherService; +import dao.TeacherDao; // 导入 TeacherDao 接口，处理教师数据访问。 +import domain.Course; // 导入 Course 类，表示课程信息。 +import domain.Teacher; // 导入 Teacher 类，表示教师信息。 +import dao.impl.TeacherDaoImpl; // 导入 TeacherDaoImpl 类，实际的教师数据访问实现。 +import service.TeacherService; // 导入 TeacherService 接口，定义教师服务层的业务逻辑。 import java.util.List; +/** + * TeacherServiceImpl 类实现了 TeacherService 接口，负责教师相关业务逻辑的处理。 + * 该类通过调用 TeacherDao 实现与数据库的交互，提供了教师登录、信息更新、密码修改、课程管理等功能。 + */ public class TeacherServiceImpl implements TeacherService { - private TeacherDao dao = new TeacherDaoImpl(); + private TeacherDao dao = new TeacherDaoImpl(); // 实例化 TeacherDaoImpl 对象，用于操作教师数据。 + + /** + * 教师登录验证。 + * + * @param teacher 教师对象，包含教师 ID 和密码。 + * @return 如果验证通过，返回教师信息；否则返回 null。 + */ @Override public Teacher login(Teacher teacher) { - return dao.findTeacheridAndPassword(teacher.getT_id(),teacher.getT_password()); + return dao.findTeacheridAndPassword(teacher.getT_id(), teacher.getT_password()); // 调用 DAO 层方法进行登录验证 } + /** + * 查询所有教师信息。 + * + * @return 返回所有教师的列表。 + */ @Override public List findAll() { - return dao.findAll(); + return dao.findAll(); // 调用 DAO 层的 findAll 方法获取所有教师信息 } + /** + * 查询教师自己的可选课程。 + * + * @param T_id 教师 ID。 + * @return 返回该教师教授的所有可选课程信息。 + */ @Override public List findMySelfOptionalCourse(String T_id) { - return dao.findMySelfOptionalCourse(T_id); + return dao.findMySelfOptionalCourse(T_id); // 调用 DAO 层方法获取该教师的可选课程 } + /** + * 根据课程 ID 查询可选课程信息。 + * + * @param cid 课程 ID。 + * @return 返回指定课程的详细信息。 + */ @Override public Course findOptionalCourseByCourseId(String cid) { - return dao.findOptionalCourseByCourseId(cid); + return dao.findOptionalCourseByCourseId(cid); // 调用 DAO 层方法根据课程 ID 查询课程信息 } + /** + * 更新课程信息。 + * + * @param updateCourse 课程对象，包含更新后的课程信息。 + */ @Override public void updateCourseInfo(Course updateCourse) { - dao.updateCourseInfo(updateCourse); + dao.updateCourseInfo(updateCourse); // 调用 DAO 层方法更新课程信息 } + /** + * 删除课程信息。 + * + * @param cid 课程 ID。 + */ @Override public void deleteCourseById(String cid) { - dao.deleteCourseById(cid); + dao.deleteCourseById(cid); // 调用 DAO 层方法删除指定课程 } + /** + * 更新教师密码。 + * + * @param teacherid 教师 ID。 + * @param newpassword 新密码。 + */ @Override public void updatePassword(String teacherid, String newpassword) { - dao.updatePassword(teacherid,newpassword); + dao.updatePassword(teacherid, newpassword); // 调用 DAO 层方法更新教师密码 } + /** + * 根据教师 ID 查询教师信息。 + * + * @param teacher 教师对象，包含教师 ID。 + * @return 返回指定教师的详细信息。 + */ @Override public Teacher findTeacherById(Teacher teacher) { - return dao.findTeacherById(teacher.getT_id()); + return dao.findTeacherById(teacher.getT_id()); // 调用 DAO 层方法根据教师 ID 查询教师信息 } + /** + * 添加教师的完整信息。 + * + * @param updateTeacher 教师对象，包含完整的教师信息。 + */ @Override public void addTeacherAllInfo(Teacher updateTeacher) { - dao.addTeacherAllInfo(updateTeacher); + dao.addTeacherAllInfo(updateTeacher); // 调用 DAO 层方法添加教师的完整信息 } + /** + * 删除教师信息。 + * + * @param teacherid 教师 ID。 + */ @Override public void deleteTeacherById(String teacherid) { - dao.deleteTeacherById(teacherid); + dao.deleteTeacherById(teacherid); // 调用 DAO 层方法删除指定教师 } + /** + * 更新教师信息。 + * + * @param updateTeacher 教师对象，包含更新后的教师信息。 + */ @Override public void updateInfo(Teacher updateTeacher) { - dao.updateInfo(updateTeacher); + dao.updateInfo(updateTeacher); // 调用 DAO 层方法更新教师信息 } }