简介这是一份基于Java开发的轻量级教务查询系统面向Java后端初学者与SSM整合练习者对应SpringSpringMVCMybatis的经典三层架构并融入Shiro安全框架与C3P0连接池可帮助读者快速理解后台管理、课程与选课等核心流程。压缩包共271个文件大小约35.32MB主要包含Java源码55个java、76个class、Mybatis/Spring等42个XML配置、28个JSP页面、31个依赖JAR包以及SQL脚本、Bootstrap前端资源与项目文档目录结构清晰适合对照学习。已有411人浏览学习。通过该项目可掌握SSM整合开发的关键步骤、Shiro权限控制的前后端衔接方式以及Bootstrap页面与后端交互的常见写法由于附带了class编译文件与完整配置也便于直接部署运行是巩固JavaWeb知识、完成课程设计的实用练手材料。1. 教务系统 Java 练手项目一看目录全是 class 文件这个项目到底怎么用下载一个基于 Java 的教务系统项目解压后看到的是 CourseExample.class、StudentExample.class、AdminController.class 这一堆编译产物第一反应多半是「源码呢」。实际上这个项目定位很明确它是一个用 SSMSpring SpringMVC Mybatis整合出来的教务查询系统练手项目配合 Shiro 做登录鉴权前端用 Bootstrap 搭页面数据源走 C3P0。作者把编译好的 class 文件发出来意图不是让你改源码而是让你通过部署、运行、反推表结构把 SSM 整合开发这条链路亲自走一遍。对正在做 Java 课程设计、或者刚学完 SSM 想找个完整项目练手的人这份资源的价值在于你能看到一个真实的教务系统里「学生、教师、课程、选课、登录、角色」这几张表是怎么组织的也能看到 Shiro 过滤链、MyBatis 的 Example 查询这些高频考点在实际项目里长什么样。这篇笔记会从 class 文件反推表结构开始一步步带你把它跑起来再把登录鉴权和选课流程拆开讲透最后给出几个我实际踩过的坑。2. 从 class 文件反推项目结构六张业务表与三层架构先立起来2.1 哪些 class 文件值得看Example 类把数据表暴露得明明白白拿到手先别急着找源码把 class 文件名过一遍项目结构基本就清楚了。这个资源的 class 文件里有几个固定的后缀组合值得重点看CourseExample.class、TeacherExample.class、StudentExample.class、SelectedcourseExample.class、UserloginExample.class、RoleExample.class以及每个 Example 对应的$Criteria和$GeneratedCriteria内部类。任何一个用过 MyBatis Generator 的人看到这个组合都能立刻反应过来这是代码生成器自动生成的查询条件类。GeneratedCriteria是生成器写好的基础条件构造器Criteria是它上面的业务包装日常写查询条件时用的是Criteria。每个 Example 类都对应一张表和一个 Mapper 接口。所以这个项目至少包含六张表学生表、教师表、课程表、选课表、用户登录表、角色表。再加上 AdminController.class说明还有一个管理员后台入口。这就是一个典型的教务系统最小闭环学生和教师是业务主体课程是业务对象选课表把它们关联起来用户登录表和角色表负责账号权限。判断一个 MyBatis 项目的数据规模最直接的办法就是看 Example 类的数量一个 Example 对应一张表这个经验在拆任何 SSM 项目时都通用。2.2 六张表的关系选课表是衔接学生与课程的中间表把 class 文件映射成表之后下一步是把表之间的关系画出来。结合教务系统的业务常识这六张表的核心字段和关联逻辑如下class 文件表名核心字段在系统里的角色UserloginExampleuserloginuserid, username, password, role登录账号统一入口RoleExampleroleroleid, rolename角色定义管理员/学生/教师StudentExamplestudentstudentid, studentname, password学生基本信息表TeacherExampleteacherteacherid, teachername, password教师基本信息表CourseExamplecoursecourseid, coursename, teacherid课程与任课教师关联SelectedcourseExampleselectedcoursecourseid, studentid, score学生选课中间表含成绩这里最关键的是 selectedcourse 表。学生和课程之间是多对多关系一个学生可以选多门课一门课可以被多个学生选中间必须有一张关联表。这张表里的 score 字段说明它同时承担了成绩登记的功能也就是学生选完课后教师可以回填成绩。角色表在这个项目里不会做得太重一般就是几个角色 ID 和名称的字典数据。真正判断用户身份的是 userlogin 表里的 role 字段登录成功后系统拿着这个字段决定跳转到学生端、教师端还是管理员端。2.3 包结构与模块边界Controller、Example、Criteria 串起三层架构虽然只有 class 文件但包名就是最好的目录结构说明书。AdminController 能直接告诉我们 controller 层的存在Example 类则明确指向 mapper 层。中间的 service 层虽然在 class 文件清单里没有直接暴露但按照 SSM 项目的标准写法它一定存在于接口和实现类的组合里。SSM 的分层职责要分清Controller 层只负责接收请求、调用 service、把数据塞进 Model 然后跳转页面Service 层处理业务规则比如选课时的查重Mapper 层只做最基础的 SQL 读写。我在拆这个项目时发现作者把 AdminController 单独放一个类说明管理员模块的业务入口是集中的而学生、教师相关的 Controller 是分开的只是这份资源里没有完整列出。有一点需要提醒由于你拿到的是编译产物Service 层的源码大概率需要自己反编译或者按标准结构补写。这不影响你理解整体架构因为 Service 的方法名和 Mapper 的对应关系通过 Controller 里注入的字段名就能猜个八九不离十。三层架构的价值就在这里哪怕丢了一层另外两层也能把业务逻辑约束住。3. 把编译产物跑起来建库脚本、SSM 配置与 Tomcat 部署三步走3.1 环境选型JDK 1.8、Tomcat 8、MySQL 5.7 是 SSM 的老搭档先确认环境再动手部署。这个项目用的是 C3P0 数据源它和 mysql-connector-java 5.x 驱动是一代产品配上 MySQL 5.7 是最稳的。JDK 用 1.8 不会出兼容性问题Tomcat 8.5 对 SpringMVC 的路径匹配支持也友好。如果你机器上装的是 JDK 17 或者更高版本可能会出现源发行版和目标发行版不一致的报错那就需要额外安装 1.8 才能跑起来。推荐环境版本如下组件推荐版本说明JDK1.8SSM 项目的编译目标基本都是 1.8Tomcat8.5与 Spring 5.x 兼容良好MySQL5.7与 C3P0 5.x 驱动搭配最好Maven3.6用于依赖管理没有 pom 就手动导 lib如果你坚持用 MySQL 8也不是完全不行但要同时换 mysql-connector-java 8.0.x 驱动并且把驱动类改成com.mysql.cj.jdbc.Driver。这个改动涉及 jdbc.properties 和 C3P0 配置两处新手容易漏掉最后一处导致启动失败。3.2 建库建表一张 SQL 把六张表初始化到位这个项目没有给你现成的 SQL 文件但根据 Example 类反推出的表结构自己补一份建表脚本完全没难度。教务系统的表设计很固定我按最常见的字段设计给你一份可以直接执行的脚本CREATE DATABASE IF NOT EXISTS edu_system DEFAULT CHARSET utf8mb4; USE edu_system; CREATE TABLE userlogin ( userid VARCHAR(32) PRIMARY KEY, username VARCHAR(50) NOT NULL, password VARCHAR(64) NOT NULL, role INT DEFAULT 0 ); CREATE TABLE role ( roleid INT PRIMARY KEY AUTO_INCREMENT, rolename VARCHAR(20) NOT NULL ); CREATE TABLE student ( studentid VARCHAR(32) PRIMARY KEY, studentname VARCHAR(50) NOT NULL, password VARCHAR(64) NOT NULL ); CREATE TABLE teacher ( teacherid VARCHAR(32) PRIMARY KEY, teachername VARCHAR(50) NOT NULL, password VARCHAR(64) NOT NULL ); CREATE TABLE course ( courseid INT PRIMARY KEY AUTO_INCREMENT, coursename VARCHAR(100) NOT NULL, teacherid VARCHAR(32) ); CREATE TABLE selectedcourse ( courseid INT NOT NULL, studentid VARCHAR(32) NOT NULL, score DECIMAL(5,2) DEFAULT NULL, PRIMARY KEY (courseid, studentid) );几个设计点说一下主键上 studentid、teacherid 都设计成 VARCHAR因为学号和工号往往带前缀或前导零用 int 会自动去零导致账号错乱。selectedcourse用课程 ID 和学生 ID 做联合主键天然杜绝同一学生重复选同一门课的问题这个设计比在代码里做查重更可靠。userlogin的 role 字段存整数0 表示管理员、1 表示教师、2 表示学生和 role 表对应。score 用 DECIMAL(5,2) 是给成绩留两位小数便于后续统计平均分。建完表之后别忘了手动插入基础账号一个管理员、一个学生、一个教师。密码在 Shiro 场景下一般会存 MD5 加密后的值如果你不确定加密规则可以先存明文等登录跑通后再研究加密逻辑。3.3 jdbc.properties 与 C3P0 数据源参数别瞎调数据库建好了接下来是数据源配置。SSM 项目里数据源信息集中在 jdbc.propertiesSpring 通过 context:property-placeholder 读取。这个项目的配置核心是 C3P0它的参数比 Druid 多但不是每个都要调。jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/edu_system?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456bean iddataSource classcom.mchange.v2.c3p0.ComboPooledDataSource property namedriverClass value${jdbc.driver} / property namejdbcUrl value${jdbc.url} / property nameuser value${jdbc.username} / property namepassword value${jdbc.password} / property nameinitialPoolSize value5 / property namemaxPoolSize value20 / property namecheckoutTimeout value3000 / property namemaxIdleTime value600 / /beaninitialPoolSize是启动时预建的连接数maxPoolSize是连接池上限checkoutTimeout是拿连接的超时时间。这几个参数里最容易出问题的是checkoutTimeout设太短高峰期并发一上来就直接抛异常设太长数据库故障时接口会卡死很久。我一般习惯 3000 毫秒起步。还有一点要强调C3P0 的配置参数名是driverClass而不是driver写成后者会在启动时报属性不存在。URL 里务必带上characterEncodingutf8否则中文用户名会乱码。字符编码问题在本地开发时未必暴露等你用 Navicat 插入中文数据后再查接口就会看到一堆问号。3.4 部署到 Tomcatclass 目录结构不对会白屏这个项目没有源码也没有现成的 war 包部署方式就是手动把编译目录整理成 Web 工程标准结构。Tomcat 加载的不是散落的 class而是 WEB-INF/classes 和 WEB-INF/lib 这两个目录位置放错启动不报错但页面永远 404。webapps/edu_system/ ├── index.jsp ├── WEB-INF/ │ ├── web.xml │ ├── classes/ │ │ └── com/xxx/controller/AdminController.class │ ├── lib/ │ │ ├── spring-webmvc-5.2.15.RELEASE.jar │ │ ├── mybatis-3.5.9.jar │ │ └── shiro-spring-1.7.0.jar │ └── jsp/ │ ├── admin/ │ └── student/把反编译出来或现有的 class 文件按包名放好位置lib 目录里把 SSM、Shiro、C3P0、MySQL 驱动、log4j 这些 jar 全部拷进去然后启动 Tomcat。启动日志是关键看到Initializing Spring root WebApplicationContext说明容器起来了之后再访问http://localhost:8080/edu_system/才会进入登录页。新手常见的翻车点是不看日志直接刷新页面白屏就以为项目坏了。先看 catalina.out 有没有报错再确认端口有没有被占用最后检查 classes 目录下的包名和代码里的包名是否一致。AdminController 如果放在com.xxx.controller包里classes 目录下就必须有完整的com/xxx/controller/路径这个层级错了 Tomcat 不会提醒你只会给你返回 404。4. 核心流程拆解Shiro 登录鉴权与选课的前后端联动逻辑4.1 Shiro 过滤链与 Realmanon、authc、perms 三个关键配置Shiro 在这个项目里管两件事登录认证和权限控制。它的核心是一个过滤器链每个 URL 对应一个过滤器过滤器决定请求是放行还是拦截。先看典型的 Shiro 配置bean idshiroFilter classorg.apache.shiro.spring.web.ShiroFilterFactoryBean property namesecurityManager refsecurityManager / property nameloginUrl value/index.jsp / property namefilterChainDefinitions value /static/** anon /login/** anon /admin/** authc, roles[admin] /student/** authc /teacher/** authc /** authc /value /property /beanfilterChainDefinitions 里的每一行都是「URL 过滤器」的映射。anon表示匿名可访问authc表示必须登录roles[admin]表示登录后还必须有 admin 角色。这里有个硬性规则Shiro 是按顺序从上往下匹配 URL 的第一个匹配的规则生效所以/static/** anon必须写在最前面。如果你先写了/** authc再写静态资源放行那等于没放行CSS 和 JS 全会被拦截。登录请求的处理逻辑通常是前端表单提交账号密码Controller 把用户名密码封装成 UsernamePasswordToken交给 Subject 执行 loginShiro 内部通过 Realm 去查数据库比对密码。Realm 是连接 Shiro 和业务表的桥梁里面 doGetAuthenticationInfo 方法写的就是查 userlogin 表的 SQL。4.2 AdminController管理员后台的入口与数据准备AdminController.class 是这份资源里唯一直接暴露的控制器它的职责很集中负责管理员后台所有页面的跳转和基础数据准备。典型的 SSM Controller 写法是方法上标注RequestMapping返回值去匹配 JSP 页面路径Controller RequestMapping(/admin) public class AdminController { Autowired private StudentService studentService; Autowired private TeacherService teacherService; RequestMapping(/list) public String list(Model model) { ListStudent students studentService.findAll(); ListTeacher teachers teacherService.findAll(); model.addAttribute(students, students); model.addAttribute(teachers, teachers); return admin/list; } RequestMapping(/toAddStudent) public String toAddStudent() { return admin/addStudent; } }RequestMapping(/admin)把整个类的请求路径都限制在/admin前缀下方法再用/list、/toAddStudent做二级区分这样前端访问/admin/list就会走这个方法。Model是 SpringMVC 传数据的口袋把查询结果放进去JSP 页面里就能直接用 EL 表达式取出来渲染表格。注意返回的字符串admin/list不是完整路径SpringMVC 会通过视图解析器拼上前缀后缀比如把/WEB-INF/jsp/加在前面、.jsp加在后面最终跳转到/WEB-INF/jsp/admin/list.jsp。这个逻辑搞清楚了你就知道为什么页面文件必须放在 WEB-INF 下——放在外面反而不会被视图解析器找到。4.3 选课逻辑Controller 接收参数、Service 查重、Mapper 更新选课是教务系统的核心业务它的流程必须包含「课程是否存在、是否已选过、选课人数是否已满」这三道校验。由于资源里没有直接给出 selectedcourse 对应的 Service 实现我按 SSM 最常见写法把它补出来逻辑是完全对得上的Service Transactional public class SelectedCourseServiceImpl implements SelectedCourseService { Autowired private SelectedCourseMapper selectedCourseMapper; Autowired private CourseMapper courseMapper; public boolean selectCourse(String studentId, Integer courseId) { // 第一步查选课表判断学生是否已经选过这门课 SelectedCourseExample example new SelectedCourseExample(); SelectedCourseExample.Criteria criteria example.createCriteria(); criteria.andStudentidEqualTo(studentId); criteria.andCourseidEqualTo(courseId); ListSelectedCourse exists selectedCourseMapper.selectByExample(example); if (exists ! null exists.size() 0) { throw new RuntimeException(不能重复选课); } // 第二步查课程表确认课程存在 Course course courseMapper.selectByPrimaryKey(courseId); if (course null) { throw new RuntimeException(课程不存在); } // 第三步往选课表插入记录 SelectedCourse selectedCourse new SelectedCourse(); selectedCourse.setStudentid(studentId); selectedCourse.setCourseid(courseId); return selectedCourseMapper.insert(selectedCourse) 0; } }这段逻辑里最值得学的是 MyBatis 的 Example 查询写法。createCriteria()每次调用会生成一个新的条件集合andStudentidEqualTo和andCourseidEqualTo会把两个条件拼成 SQL 里的WHERE studentid ? AND courseid ?。查重这一步用联合主键也能做但 Example 的方式更通用你可以自由组合多个条件。Transactional注解是整个方法的保护伞。如果插入选课记录时数据库报错事务会自动回滚不会出现「选了课但没记录」的脏数据。这里有个细节选课人数上限的判断在课程表没有单独字段的情况下通常是通过COUNT(*)查询实现的若你在课程表里加了 capacity 字段那查重逻辑里就要多一个判断。5. 避坑指南SSM 整合与这份资源的四个典型翻车现场5.1 MySQL 8 时区与驱动类不一致C3P0 启动直接报错现象Tomcat 启动时控制台报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized或者干脆报Cannot load JDBC driver class com.mysql.jdbc.Driver数据源初始化失败整个 Web 应用起不来。原因这是典型的版本错配。项目用的是 mysql-connector-java 5.x 驱动驱动类叫com.mysql.jdbc.Driver但本地装的是 MySQL 88 的默认时区是 UTC旧驱动解析不了。如果你用 8.x 驱动还继续写 5.x 的驱动类名一样会报加载失败。解决要么把数据库降回 5.7要么全链路升到 8.x。升级做法是换 jar 包、把jdbc.driver改成com.mysql.cj.jdbc.Driver并在 URL 末尾追加serverTimezoneAsia/Shanghai。三个改动必须同时完成少一个启动时照样报错。5.2 Example 的 Criteria 复用查询结果越拼越乱现象同一个方法里执行两次查询第二次的结果莫名多了第一次的查询条件。比如先查学生 A 选了哪些课再查学生 B结果返回的是 A 和 B 的并集。原因我在写选课查重时强调过要new Example()但很多人图省事把 Example 声明成方法外的成员变量或者在同一查询里多次调用createCriteria()。MyBatis 的 Criteria 是叠加式的第一次的条件不会自动清空第二次查询时旧条件还在里面自然拼出错误的 SQL。解决每次查询都重新new Example()这是最干净的做法。如果确实要复用同一个对象查询前调用example.clear()清空已有条件。我在实际项目里还踩过一层坑createCriteria()返回的 Criteria 对象如果存起来下次用它绑定的还是旧的 Example这时候 clear 也救不回来。所以我的规矩是一个查询一个 Example用完即弃。5.3 Shiro 过滤链顺序错误静态资源全被拦截现象页面能打开但 CSS、JS 全部失效页面光秃秃的只有 HTML 文字。或者登录页能访问但登录后跳转任何页面都用被踢回登录页。原因filterChainDefinitions 里的规则顺序就是匹配顺序URL 和规则是「第一个匹配成功即生效」。如果把/** authc写在anon规则前面那么所有请求都命中 authc静态资源全部要求登录登录页自身的 CSS 也加载不出来。解决把最宽泛的拦截规则放最后具体放行规则放最前。标准顺序是先放/static/**、/login/**这类匿名路径再放/admin/**这类带角色限制的路径最后才写/** authc兜底。我每次改过滤链都会默念一遍「具体在前兜底在后」从此再没犯过这个错。5.4 只有 class 没有源码反编译后包结构对不上现象下载的资源里全是 .class 文件没有 .java。想改功能却发现无从下手用反编译工具导出的源码包名不一致重新编译后整个项目链接不上。原因作者发布时只打包了 target 目录没打包 src或者刻意只给了运行产物。反编译工具能还原代码逻辑但会把内部类的编译规则展开导致你看到的类名和原工程不一致比如CourseExample$GeneratedCriteria.class反编译后变成独立的内部类源文件重新组织工程时需要手动调整目录结构。解决我的做法是先用 JD-GUI 或 CFR 把 class 批量反编译成 java 文件然后按包名手动归类到src/main/java对应目录。Service 层和 Mapper 层的包结构调整起来工作量不小但比完全自己重写快得多。如果只是做课程设计展示其实不反编译也能跑起来把部署过程、表结构设计、登录和选课流程讲清楚文档和演示是能拿到分的。6. 进阶给课程表加一个开课审核状态位检验你对这个项目的掌控力跑通之后别急着收工给这个教务系统加一个「开课审核」功能能快速检验你是不是真的理解了这套 SSM 架构。改动很小但涉及表结构、Mapper、Controller、前端四个层面每一步都踩在项目的核心链路上。先在课程表加一个状态字段SQL 就一句话ALTER TABLE course ADD COLUMN audit_status TINYINT DEFAULT 0;audit_status 用 0 表示待审核1 表示通过2 表示驳回。默认 0 的好处是教师新加的课程自动进入待审核队列不会出现漏审。然后在 Mapper 的 XML 里加一条更新语句。MyBatis 的 Mapper 支持自定义 SQL不需要改动 Example 类直接写一条带条件的 updateupdate idupdateAuditStatus UPDATE course SET audit_status #{status} WHERE course_id #{courseId} /updateController 里对应加一个方法管理员点击「通过」按钮时请求打到这个方法传入课程 ID 和审核结果RequestMapping(/auditCourse) ResponseBody public String auditCourse(Integer courseId, Integer status) { courseService.updateAuditStatus(courseId, status); return success; }前端在管理员课程列表的每一行操作区加两个按钮通过时传 status1驳回时传 status2点击后刷新表格。注意ResponseBody这个注解它让方法直接返回字符串而非跳转 JSP这是 Ajax 请求的标准写法和前面 AdminController 里返回视图路径的方法形成对比。从这件事能看出这套架构的扩展性加一个字段是表层面的改动加一条 SQL 是 Mapper 层面的改动加一个方法只动了 Controller三层各改各的互不渗透。这也解释了为什么 SSM 能长期霸占课程设计场景——业务边界清楚新手容易上手出了问题也知道该去哪个目录排查。顺带说一句我在拆这个项目之前一直以为拿到 class 文件资源就没法改造了。实际做完这个审核功能才明白只要表结构清楚了、Mapper 的方法名规律掌握了、Controller 的返回规则理解了有没有源码其实不影响你做出一个完整的可演示功能。从那以后我每次拿到只有 class 的练手项目第一件事永远是先把建库脚本补齐、把表关系画出来再谈功能改造。这个习惯帮我少走了很多弯路希望帮到你。本文还有配套的精品资源点击获取