下面是一個完整的成績管理系統后臺實現,使用Spring Boot框架,包含學生管理、課程管理和成績管理功能。
1. 項目結構
src/main/java/com/example/grademanagement/
├── config/ ? ? ? ? ? # 配置類
├── controller/ ? ? ? # 控制器
├── dto/ ? ? ? ? ? ? ?# 數據傳輸對象
├── entity/ ? ? ? ? ? # 實體類
├── exception/ ? ? ? ?# 異常處理
├── repository/ ? ? ? # 數據訪問層
├── service/ ? ? ? ? ?# 業務邏輯層
│ ? └── impl/ ? ? ? ? # 服務實現
└── GrademanagementApplication.java ?# 啟動類
2. 主要依賴 (pom.xml)?
<dependencies><!-- Spring Boot Starter --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- 數據訪問 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-jpa</artifactId></dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><scope>runtime</scope></dependency><!-- 工具類 --><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><!-- 測試 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency>
</dependencies>
3. 實體類設計
3.1 學生實體 (Student.java)
package com.example.grademanagement.entity;import jakarta.persistence.*;
import lombok.Data;import java.util.List;@Entity
@Data
@Table(name = "students")
public class Student {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;@Column(nullable = false)private String studentId; // 學號@Column(nullable = false)private String name;@Column(nullable = false)private String gender;private String className; // 班級@OneToMany(mappedBy = "student", cascade = CascadeType.ALL)private List<Grade> grades;
}
3.2 課程實體 (Course.java)
package com.example.grademanagement.entity;import jakarta.persistence.*;
import lombok.Data;import java.util.List;@Entity
@Data
@Table(name = "courses")
public class Course {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;@Column(nullable = false, unique = true)private String courseCode; // 課程代碼@Column(nullable = false)private String courseName;private Integer credit; // 學分@OneToMany(mappedBy = "course", cascade = CascadeType.ALL)private List<Grade> grades;
}
3.3 成績實體 (Grade.java)
package com.example.grademanagement.entity;import jakarta.persistence.*;
import lombok.Data;@Entity
@Data
@Table(name = "grades")
public class Grade {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;@ManyToOne@JoinColumn(name = "student_id", nullable = false)private Student student;@ManyToOne@JoinColumn(name = "course_id", nullable = false)private Course course;@Column(nullable = false)private Double score; // 成績private String semester; // 學期
}
4. 數據訪問層 (Repository)
4.1 學生倉庫 (StudentRepository.java)
package com.example.grademanagement.repository;import com.example.grademanagement.entity.Student;
import org.springframework.data.jpa.repository.JpaRepository;public interface StudentRepository extends JpaRepository<Student, Long> {Student findByStudentId(String studentId);List<Student> findByNameContaining(String name);List<Student> findByClassName(String className);
}
4.2 課程倉庫 (CourseRepository.java)
package com.example.grademanagement.repository;import com.example.grademanagement.entity.Course;
import org.springframework.data.jpa.repository.JpaRepository;public interface CourseRepository extends JpaRepository<Course, Long> {Course findByCourseCode(String courseCode);List<Course> findByCourseNameContaining(String courseName);
}
4.3 成績倉庫 (GradeRepository.java)
package com.example.grademanagement.repository;import com.example.grademanagement.entity.Grade;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;import java.util.List;public interface GradeRepository extends JpaRepository<Grade, Long> {List<Grade> findByStudentId(Long studentId);List<Grade> findByCourseId(Long courseId);@Query("SELECT g FROM Grade g WHERE g.student.id = ?1 AND g.course.id = ?2")Grade findByStudentAndCourse(Long studentId, Long courseId);@Query("SELECT AVG(g.score) FROM Grade g WHERE g.course.id = ?1")Double findAverageScoreByCourse(Long courseId);
}
5. 業務邏輯層 (Service)
5.1 學生服務接口 (StudentService.java)
package com.example.grademanagement.service;import com.example.grademanagement.entity.Student;import java.util.List;public interface StudentService {Student addStudent(Student student);Student updateStudent(Long id, Student student);void deleteStudent(Long id);Student getStudentById(Long id);Student getStudentByStudentId(String studentId);List<Student> getAllStudents();List<Student> searchStudents(String keyword);
}
5.2 學生服務實現 (StudentServiceImpl.java)
package com.example.grademanagement.service.impl;import com.example.grademanagement.entity.Student;
import com.example.grademanagement.repository.StudentRepository;
import com.example.grademanagement.service.StudentService;
import org.springframework.stereotype.Service;import java.util.List;@Service
public class StudentServiceImpl implements StudentService {private final StudentRepository studentRepository;public StudentServiceImpl(StudentRepository studentRepository) {this.studentRepository = studentRepository;}@Overridepublic Student addStudent(Student student) {if (studentRepository.findByStudentId(student.getStudentId()) != null) {throw new RuntimeException("學號已存在");}return studentRepository.save(student);}@Overridepublic Student updateStudent(Long id, Student student) {Student existingStudent = studentRepository.findById(id).orElseThrow(() -> new RuntimeException("學生不存在"));existingStudent.setName(student.getName());existingStudent.setGender(student.getGender());existingStudent.setClassName(student.getClassName());return studentRepository.save(existingStudent);}@Overridepublic void deleteStudent(Long id) {studentRepository.deleteById(id);}@Overridepublic Student getStudentById(Long id) {return studentRepository.findById(id).orElseThrow(() -> new RuntimeException("學生不存在"));}@Overridepublic Student getStudentByStudentId(String studentId) {return studentRepository.findByStudentId(studentId);}@Overridepublic List<Student> getAllStudents() {return studentRepository.findAll();}@Overridepublic List<Student> searchStudents(String keyword) {return studentRepository.findByNameContaining(keyword);}
}
5.3 成績服務接口 (GradeService.java)
package com.example.grademanagement.service;import com.example.grademanagement.entity.Grade;import java.util.List;public interface GradeService {Grade addGrade(Grade grade);Grade updateGrade(Long id, Grade grade);void deleteGrade(Long id);Grade getGradeById(Long id);List<Grade> getGradesByStudentId(Long studentId);List<Grade> getGradesByCourseId(Long courseId);Double getAverageScoreByCourse(Long courseId);Grade getGradeByStudentAndCourse(Long studentId, Long courseId);
}
6. 控制器 (Controller)
6.1 學生控制器 (StudentController.java)
package com.example.grademanagement.controller;import com.example.grademanagement.entity.Student;
import com.example.grademanagement.service.StudentService;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;import java.util.List;@RestController
@RequestMapping("/api/students")
public class StudentController {private final StudentService studentService;public StudentController(StudentService studentService) {this.studentService = studentService;}@PostMappingpublic ResponseEntity<Student> addStudent(@RequestBody Student student) {return ResponseEntity.ok(studentService.addStudent(student));}@PutMapping("/{id}")public ResponseEntity<Student> updateStudent(@PathVariable Long id, @RequestBody Student student) {return ResponseEntity.ok(studentService.updateStudent(id, student));}@DeleteMapping("/{id}")public ResponseEntity<Void> deleteStudent(@PathVariable Long id) {studentService.deleteStudent(id);return ResponseEntity.noContent().build();}@GetMapping("/{id}")public ResponseEntity<Student> getStudentById(@PathVariable Long id) {return ResponseEntity.ok(studentService.getStudentById(id));}@GetMapping("/student-id/{studentId}")public ResponseEntity<Student> getStudentByStudentId(@PathVariable String studentId) {return ResponseEntity.ok(studentService.getStudentByStudentId(studentId));}@GetMappingpublic ResponseEntity<List<Student>> getAllStudents() {return ResponseEntity.ok(studentService.getAllStudents());}@GetMapping("/search")public ResponseEntity<List<Student>> searchStudents(@RequestParam String keyword) {return ResponseEntity.ok(studentService.searchStudents(keyword));}
}
6.2 成績控制器 (GradeController.java)
package com.example.grademanagement.controller;import com.example.grademanagement.entity.Grade;
import com.example.grademanagement.service.GradeService;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;import java.util.List;@RestController
@RequestMapping("/api/grades")
public class GradeController {private final GradeService gradeService;public GradeController(GradeService gradeService) {this.gradeService = gradeService;}@PostMappingpublic ResponseEntity<Grade> addGrade(@RequestBody Grade grade) {return ResponseEntity.ok(gradeService.addGrade(grade));}@PutMapping("/{id}")public ResponseEntity<Grade> updateGrade(@PathVariable Long id, @RequestBody Grade grade) {return ResponseEntity.ok(gradeService.updateGrade(id, grade));}@DeleteMapping("/{id}")public ResponseEntity<Void> deleteGrade(@PathVariable Long id) {gradeService.deleteGrade(id);return ResponseEntity.noContent().build();}@GetMapping("/{id}")public ResponseEntity<Grade> getGradeById(@PathVariable Long id) {return ResponseEntity.ok(gradeService.getGradeById(id));}@GetMapping("/student/{studentId}")public ResponseEntity<List<Grade>> getGradesByStudentId(@PathVariable Long studentId) {return ResponseEntity.ok(gradeService.getGradesByStudentId(studentId));}@GetMapping("/course/{courseId}")public ResponseEntity<List<Grade>> getGradesByCourseId(@PathVariable Long courseId) {return ResponseEntity.ok(gradeService.getGradesByCourseId(courseId));}@GetMapping("/average/{courseId}")public ResponseEntity<Double> getAverageScoreByCourse(@PathVariable Long courseId) {return ResponseEntity.ok(gradeService.getAverageScoreByCourse(courseId));}@GetMapping("/student-course")public ResponseEntity<Grade> getGradeByStudentAndCourse(@RequestParam Long studentId, @RequestParam Long courseId) {return ResponseEntity.ok(gradeService.getGradeByStudentAndCourse(studentId, courseId));}
}
7. 異常處理
7.1 全局異常處理器 (GlobalExceptionHandler.java)
package com.example.grademanagement.exception;import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;@ControllerAdvice
public class GlobalExceptionHandler {@ExceptionHandler(RuntimeException.class)public ResponseEntity<String> handleRuntimeException(RuntimeException e) {return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(e.getMessage());}@ExceptionHandler(Exception.class)public ResponseEntity<String> handleException(Exception e) {return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("服務器內部錯誤: " + e.getMessage());}
}
8. 應用配置
8.1 數據庫配置 (application.properties)
# 數據庫配置
spring.datasource.url=jdbc:mysql://localhost:3306/grade_management?useSSL=false
spring.datasource.username=root
spring.datasource.password=yourpassword
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver# JPA配置
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true# 服務器配置
server.port=8080
9. 啟動類
package com.example.grademanagement;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class GrademanagementApplication {public static void main(String[] args) {SpringApplication.run(GrademanagementApplication.class, args);}
}
10. API文檔
系統提供以下主要API端點:
學生管理
POST /api/students
?- 添加學生
GET /api/students
?- 獲取所有學生
GET /api/students/{id}
?- 獲取指定ID的學生
PUT /api/students/{id}
?- 更新學生信息
DELETE /api/students/{id}
?- 刪除學生
成績管理
POST /api/grades
?- 添加成績
GET /api/grades/student/{studentId}
?- 獲取學生所有成績
GET /api/grades/course/{courseId}
?- 獲取課程所有成績
GET /api/grades/average/{courseId}
?- 獲取課程平均分