企业官网建设流程全解析

简介：这是一套基于JavaEE平台、采用SSH（Struts+Spring+Hibernate）框架开发的百货中心供应链管理系统完整源码与配套资料，面向高校计算机专业学生、毕业设计开发者及Java Web初学者，解决企业级供应链数据管理与统计分析的典型教学实践需求。资源包共16个文件，含10张系统界面截图（如登录页、合作公司管理、数据统计等）、2段高清操作视频（涵盖项目部署启动与核心模块演示）、1个SQL数据库脚本（chain_2014-05-05.sql）、1个源码压缩包（Retail_Supply_Chain_System.zip）、1份说明文档（txt）及1篇毕业设计说明书（doc），全面覆盖开发、部署、运行与展示全流程。包体大小64.24MB，结构清晰，模块划分明确，包含登录、合作公司管理、采购管理、数据统计四大功能模块。目前已有221人学习下载，适合用于课程设计参考、毕设快速搭建、SSH框架实战复现及供应链业务逻辑理解。

1. 百货中心供应链管理系统：一个能跑通、能改、能交差的 SSH 实战项目

你是不是也遇到过这种场景：毕业设计选题卡在“想做供应链但怕太重”，或者实习要交 Java Web 项目，翻遍 GitHub 却全是 Spring Boot 新项目，而你的课程要求偏偏是 SSH（Struts2 + Spring + Hibernate）？这个「百货中心供应链管理系统」不是玩具 Demo，它是一套完整落地过的 JavaEE 三层架构实战源码——从登录页到数据统计图表，从合作公司增删改查到采购单状态流转，全部用 JSP+Servlet+XML 配置驱动，MySQL 数据库脚本带建表语句、初始数据、外键约束，连chain_2014-05-05.sql的时间戳都保留着当年部署的真实痕迹。它不炫技，不堆新框架，但每一步都踩在高校课程设计和中小型企业内部系统改造的典型路线上：JSP 页面嵌套合理、Action 分层清晰、Hibernate 映射文件.hbm.xml手写规范、Spring 的applicationContext.xml里事务管理粒度可控。如果你需要的不是一个“能编译就行”的空壳，而是一个能本地启动、能改字段、能加模块、能对着论文截图逐页验证的闭环项目，那它就是目前能找到的最省心、最耐拆、最不怕答辩老师深挖 DAO 层实现的 SSH 老兵。

2. 环境复现与项目结构解析：从 .7z 解压到 Tomcat 可访问

2.1 解压与目录结构确认：别急着导入 IDE，先看清骨架

拿到Retail_Supply_Chain_System.zip和chain_2014-05-05.sql后，第一步不是解压进 Eclipse，而是用任意解压工具打开Retail_Supply_Chain_System.zip，观察其根目录结构。你会看到典型的 Java Web 工程布局：

Retail_Supply_Chain_System/ ├── src/ # Java 源码（含 action、service、dao、model） │ ├── action/ # Struts2 Action 类（如 LoginAction.java） │ ├── service/ # 业务逻辑接口与实现（如 PurchaseService.java） │ ├── dao/ # 数据访问层（如 CompanyDao.java） │ └── model/ # 实体类（Company.java, Purchase.java 等） ├── WebContent/ # Web 根目录（等同于标准 WebApp 的 webapp/） │ ├── WEB-INF/ │ │ ├── web.xml # Servlet 容器配置（关键！含 Struts2 Filter） │ │ ├── struts.xml # Struts2 主配置（action 映射、result 类型） │ │ ├── applicationContext.xml # Spring 核心配置（bean 定义、事务管理） │ │ └── hibernate.cfg.xml # Hibernate 连接与映射配置 │ ├── jsp/ # 所有 JSP 页面（login.jsp, company_list.jsp 等） │ └── css/ js/ images/ # 静态资源 ├── lib/ # 第三方 JAR 包（struts2-core-2.3.16.jar, spring-3.2.4.RELEASE.jar, hibernate-core-4.2.7.Final.jar 等） └── build.xml # Ant 构建脚本（可选，非必须）

提示：src/下没有 Maven 的pom.xml，说明这是纯手动依赖管理项目。所有 JAR 必须严格匹配lib/中版本，尤其是 Struts2 2.3.x 与 Spring 3.2.x 的兼容性——这是后续启动失败的头号雷区。

2.2 JDK 与 Tomcat 版本锁定：为什么用 JDK 7 + Tomcat 7 是硬性前提

这个项目诞生于 2014 年前后，其字节码版本、Servlet 规范、JSP EL 表达式语法均锚定在特定生态中。强行用 JDK 11 或 Tomcat 9 会导致三类致命错误：

• java.lang.UnsupportedClassVersionError：.class文件由 JDK 7 编译，JDK 11 无法加载；
• javax.servlet.ServletException: java.lang.NoClassDefFoundError: javax/servlet/jsp/JspFactory：Tomcat 9 默认使用 Servlet 4.0，而web.xml中<web-app>声明的是version="2.5"，且lib/中的jsp-api.jar是 2.1 版本；
• JSP 页面中${user.name}报ELException：Tomcat 8+ 默认禁用 EL 表达式，需在web.xml中显式开启。

因此，必须使用 JDK 7u80（或兼容版本） + Tomcat 7.0.99（推荐）。安装后，在 IDE（Eclipse/MyEclipse）中新建 Server 时，明确选择 “Apache Tomcat v7.0”，并指向该 Tomcat 目录；在项目 Properties → Java Build Path → Libraries 中，将 JRE System Library 切换为 “JavaSE-1.7”。

2.3 数据库初始化：执行 SQL 脚本前的三个检查点

chain_2014-05-05.sql不是单条CREATE DATABASE，而是一个完整的建库建表+初始数据脚本。执行前务必确认三点：

1. MySQL 版本 ≤ 5.7：脚本中CREATE TABLE语句使用ENGINE=InnoDB DEFAULT CHARSET=utf8，MySQL 8.0 默认字符集为utf8mb4，且utf8是别名，直接执行会报错Unknown character set: 'utf8'；
2. 数据库名必须为chain：脚本首行是USE chain;，若你创建的库名为chain_db，则所有表都会建到information_schema下，导致 Hibernate 找不到表；
3. 字符集校对规则统一为utf8_general_ci：在 MySQL 命令行或客户端中执行：

   CREATE DATABASE chain CHARACTER SET utf8 COLLATE utf8_general_ci; USE chain; SOURCE /path/to/chain_2014-05-05.sql;

   注意：SOURCE命令路径必须为绝对路径，且 MySQL 用户需有FILE权限。若用 Navicat 等 GUI 工具，务必在“运行 SQL 文件”选项中勾选 “设置字符集为 utf8”。

2.4 IDE 导入与依赖配置：手补hibernate.cfg.xml中的连接参数

将解压后的Retail_Supply_Chain_System目录作为 Dynamic Web Project 导入 Eclipse（File → Import → Web → Existing Dynamic Web Project）。导入后，右键项目 → Properties → Deployment Assembly，确认WebContent映射到/，src映射到/WEB-INF/classes。

最关键的一步是修改数据库连接配置。打开WebContent/WEB-INF/hibernate.cfg.xml，找到<property name="connection.url">，将其改为你的本地 MySQL 地址：

<property name="connection.url">jdbc:mysql://localhost:3306/chain?useUnicode=true&amp;characterEncoding=UTF-8</property> <property name="connection.username">root</property> <property name="connection.password">your_password</property>

注意：&在 XML 中需转义为&，否则 Tomcat 启动时报org.xml.sax.SAXParseException；密码若含特殊字符（如@），需 URL 编码（如@→%40）。

3. 核心模块运行验证：从登录到采购单流转的四步闭环

3.1 登录模块：LoginAction如何串联 Struts2、Spring 与 Hibernate

系统入口是login.jsp，表单提交至login.action。我们顺着这个链路看三层如何协作：

1. Struts2 层：struts.xml中定义：

   <action name="login" class="loginAction" method="execute"> <result name="success">/jsp/main.jsp</result> <result name="error">/jsp/login.jsp</result> </action>

   class="loginAction"并非直接 new 对象，而是由 Spring 容器管理（见struts.xml头部constant name="struts.objectFactory" value="spring"）。

2. Spring 层：applicationContext.xml中声明loginActionBean：

   <bean id="loginAction" class="action.LoginAction" scope="prototype"> <property name="userService" ref="userService"/> </bean>

   scope="prototype"确保每次请求新建 Action 实例，避免线程安全问题。

3. Hibernate 层：UserService的login()方法调用UserDao.findByUsernameAndPassword()，后者执行 HQL：

   String hql = "from User u where u.username = ? and u.password = ?"; Query query = session.createQuery(hql); query.setParameter(0, username); query.setParameter(1, password); // 注意：此处为明文比对，生产环境应加盐哈希

验证方法：启动 Tomcat，在浏览器访问http://localhost:8080/Retail_Supply_Chain_System/jsp/login.jsp，输入默认账号admin/admin（脚本中已插入），成功跳转至main.jsp即表示三层贯通。

3.2 合作公司管理模块：<s:iterator>与List<Company>的 JSP 渲染逻辑

company_list.jsp是典型的 Struts2 标签驱动页面。核心渲染代码：

<s:iterator value="companyList" status="st"> <tr> <td><s:property value="#st.index+1"/></td> <td><s:property value="companyName"/></td> <td><s:property value="contactPerson"/></td> <td><s:property value="phone"/></td> <td> <a href="company_edit.action?id=<s:property value="id"/>">编辑</a> | <a href="company_delete.action?id=<s:property value="id"/>" onclick="return confirm('确定删除？')">删除</a> </td> </tr> </s:iterator>

这里companyList是CompanyAction中的List<Company>成员变量，由execute()方法调用companyService.findAll()填充。<s:iterator>会自动将companyList中每个Company对象压入 ValueStack，<s:property value="companyName"/>即调用getCompanyName()。

关键细节：Company.java中private String companyName;的 getter/setter 必须存在，且命名严格遵循 JavaBean 规范（首字母小写），否则value="companyName"无法解析。

3.3 采购管理模块：PurchaseAction中的事务边界与状态流转

采购单（Purchase）有status字段，取值为"待审核"、"已通过"、"已拒绝"。状态变更逻辑在PurchaseAction.approve()中：

public String approve() { try { purchaseService.approve(purchaseId); // 此方法上标注 @Transactional this.addActionMessage("审核成功"); } catch (Exception e) { this.addActionError("审核失败：" + e.getMessage()); } return "list"; // 重定向回采购列表 }

对应的 Spring 配置在applicationContext.xml中：

<tx:advice id="txAdvice" transaction-manager="transactionManager"> <tx:attributes> <tx:method name="save*" propagation="REQUIRED"/> <tx:method name="update*" propagation="REQUIRED"/> <tx:method name="delete*" propagation="REQUIRED"/> <tx:method name="approve" propagation="REQUIRED"/> <!-- 关键：approve 方法必须包含在此 --> <tx:method name="*" read-only="true"/> </tx:attributes> </tx:advice>

验证事务：在approve()方法中故意抛出异常（如int i = 1/0;），刷新页面后查看数据库，采购单状态应保持不变，证明事务回滚生效。

3.4 数据统计模块：ChartServlet生成 PNG 图表的底层原理

data_statistics.jsp中的柱状图并非 ECharts 或 Chart.js，而是通过ChartServlet动态生成 PNG：

<img src="chart.action?chartType=bar&startDate=2014-01-01&endDate=2014-12-31" />

ChartServlet继承HttpServlet，核心逻辑：

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String chartType = request.getParameter("chartType"); // bar or pie List<Purchase> purchases = purchaseService.findByDateRange(startDate, endDate); // 使用 JFreeChart 生成 BufferedImage JFreeChart chart = createBarChart(purchases); // 自定义方法 BufferedImage image = chart.createBufferedImage(600, 400); // 输出 PNG 流 response.setContentType("image/png"); OutputStream out = response.getOutputStream(); ImageIO.write(image, "png", out); out.close(); }

注意：lib/中必须包含jfreechart-1.0.13.jar和jcommon-1.0.16.jar，缺一则ChartServlet404。若图表不显示，检查 Tomcat 日志是否有ClassNotFoundException。

4. 避坑指南：SSH 项目部署中五个血泪经验总结

4.1 现象：启动 Tomcat 后控制台报java.lang.ClassNotFoundException: org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter

原因：web.xml中 Struts2 Filter 类名与lib/中 JAR 版本不匹配。该项目使用 Struts2 2.3.x，Filter 类名为org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter；若误放入 Struts2 2.5+ 的 JAR，则类名变为org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter（去掉了ng）。
解决：删除lib/中所有struts2-*JAR，仅保留struts2-core-2.3.16.jar、struts2-spring-plugin-2.3.16.jar、struts2-json-plugin-2.3.16.jar（项目用到 JSON 返回）。

4.2 现象：登录成功后跳转main.jsp，但页面顶部导航栏空白，F12 查看 HTML 发现<s:include value="/jsp/top.jsp"/>未解析

原因：top.jsp中使用了 Struts2 的<s:include>标签，但该页面未经过 Struts2 Filter 拦截。web.xml中 Filter 的url-pattern若为/*，则静态资源（CSS/JS）也会被拦截，导致性能下降；若为/struts/*，则top.jsp不被处理。
解决：将web.xml中 Struts2 Filter 的url-pattern改为/*，并在struts.xml中添加常量禁止静态资源拦截：

<constant name="struts.action.excludePattern" value="/css/.*?,/js/.*?,/images/.*?"/>

4.3 现象：company_edit.jsp中修改公司名称后提交，数据库无变化，但页面提示“更新成功”

原因：CompanyAction的execute()方法中，companyService.update(company)调用的是 Hibernate 的session.update(entity)，但company对象的id字段为空（因 JSP 表单未传递idhidden 字段）。
解决：检查company_edit.jsp，确保有：

<s:hidden name="id" value="%{company.id}"/>

同时确认CompanyAction的company成员变量有setId()方法，且struts.xml中company_editaction 的inputresult 指向正确页面。

4.4 现象：MySQL 执行chain_2014-05-05.sql后，SELECT * FROM company;返回空结果，但SHOW TABLES;显示表存在

原因：SQL 脚本末尾有COMMIT;，但部分 MySQL 客户端（如某些版本的 Workbench）在执行多语句脚本时，COMMIT不生效，导致 INSERT 语句处于未提交事务中。
解决：在脚本末尾手动添加SET autocommit=1;，或分段执行：先执行建表语句，再单独执行所有INSERT INTO语句，最后执行COMMIT;。

4.5 现象：data_statistics.jsp中图表不显示，Chrome 控制台报Failed to load resource: the server responded with a status of 404 ()，URL 为/Retail_Supply_Chain_System/chart.action

原因：web.xml中未配置ChartServlet的 mapping，或struts.xml中未定义chartaction。该项目实际采用 Servlet 方式而非 Struts2 Action。
解决：检查web.xml，必须存在：

<servlet> <servlet-name>ChartServlet</servlet-name> <servlet-class>servlet.ChartServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>ChartServlet</servlet-name> <url-pattern>/chart.action</url-pattern> </servlet-mapping>

若servlet.ChartServlet类不存在，则需从src/中查找对应包路径，或确认lib/中jfreechart依赖完整。

5. 模块扩展实战：给采购管理增加“导出 Excel”功能

5.1 技术选型依据：为什么用 Apache POI 3.9 而非 EasyExcel

项目当前依赖均为 2014 年生态，lib/中已有poi-3.9-20121203.jar和poi-ooxml-3.9-20121203.jar。EasyExcel 是 2019 年后产物，强制升级会引发 Spring 3.2 与 Java 8 Stream API 的兼容性问题。POI 3.9 完全支持.xls（HSSF）和.xlsx（XSSF），且 API 稳定，与现有PurchaseService的List<Purchase>返回值无缝对接。

5.2 新增ExportExcelServlet：零配置导出采购单

在src/下新建包servlet，创建ExportExcelServlet.java：

package servlet; import model.Purchase; import service.PurchaseService; import org.apache.poi.hssf.usermodel.HSSFWorkbook; import org.apache.poi.ss.usermodel.*; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.io.OutputStream; import java.text.SimpleDateFormat; import java.util.Date; import java.util.List; public class ExportExcelServlet extends HttpServlet { private static final long serialVersionUID = 1L; private PurchaseService purchaseService = new PurchaseService(); // 简化：实际应由 Spring 注入 protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 1. 查询数据 List<Purchase> purchases = purchaseService.findAll(); // 2. 创建工作簿和工作表 Workbook workbook = new HSSFWorkbook(); // 生成 .xls 文件 Sheet sheet = workbook.createSheet("采购单列表"); // 3. 创建表头样式 CellStyle headerStyle = workbook.createCellStyle(); Font font = workbook.createFont(); font.setBoldweight(Font.BOLDWEIGHT_BOLD); headerStyle.setFont(font); // 4. 写入表头 Row headerRow = sheet.createRow(0); String[] headers = {"序号", "单号", "供应商", "总金额", "状态", "日期"}; for (int i = 0; i < headers.length; i++) { Cell cell = headerRow.createCell(i); cell.setCellValue(headers[i]); cell.setCellStyle(headerStyle); } // 5. 写入数据行 SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd"); for (int i = 0; i < purchases.size(); i++) { Purchase p = purchases.get(i); Row row = sheet.createRow(i + 1); row.createCell(0).setCellValue(i + 1); row.createCell(1).setCellValue(p.getPurchaseNo()); row.createCell(2).setCellValue(p.getCompanyName()); row.createCell(3).setCellValue(p.getTotalAmount()); row.createCell(4).setCellValue(p.getStatus()); row.createCell(5).setCellValue(sdf.format(p.getPurchaseDate())); } // 6. 设置响应头，输出 Excel response.setContentType("application/vnd.ms-excel"); String fileName = "采购单列表_" + new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date()) + ".xls"; response.setHeader("Content-Disposition", "attachment;filename=" + fileName); OutputStream out = response.getOutputStream(); workbook.write(out); out.close(); } }

逻辑说明：HSSFWorkbook生成兼容 Excel 2003 的.xls格式，避免用户无 Excel 2007+ 时打不开；response.setHeader("Content-Disposition", "attachment;...")强制浏览器下载而非在线打开；SimpleDateFormat格式化日期，防止 Excel 识别为数字。

5.3 在purchase_list.jsp中添加导出按钮

在采购列表页面底部，添加一行：

<div style="text-align: center; margin: 20px 0;"> <a href="export_excel.action" class="btn btn-primary"> <i class="icon-download"></i> 导出 Excel </a> </div>

然后在web.xml中注册 Servlet mapping：

<servlet> <servlet-name>ExportExcelServlet</servlet-name> <servlet-class>servlet.ExportExcelServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>ExportExcelServlet</servlet-name> <url-pattern>/export_excel.action</url-pattern> </servlet-mapping>

5.4 验证与边界处理：导出时数据量过大怎么办？

测试时用 1000 条采购单数据，发现内存溢出（java.lang.OutOfMemoryError: Java heap space）。这是因为HSSFWorkbook将整个 Excel 加载到内存。解决方案有两个：

1. 轻量级方案（推荐）：限制导出数量，在ExportExcelServlet开头添加：

   if (purchases.size() > 5000) { response.sendError(HttpServletResponse.SC_BAD_REQUEST, "导出数据量过大，请筛选后导出（上限5000条）"); return; }

2. 重型方案：改用SXSSFWorkbook（POI 3.8+），但需升级poi-ooxml，且SXSSFWorkbook不支持.xls，只能生成.xlsx，需同步修改response.setContentType和文件后缀。

从那以后我每次给老项目加导出功能，都强制走一遍“查总数→超限拦截→生成流式 Excel”的三步检查，宁可前端加个日期筛选框，也不让后端扛住万级数据。因为答辩老师真会拿 10000 条测试数据往你系统里灌，就为看你OutOfMemoryError的样子——这教训，我在模拟项目 X 的第三轮压力测试里，用整整两天内存分析才刻进肌肉记忆。希望帮到你。

本文还有配套的精品资源，点击获取