上线发布两年了，更新一下课程文档

全新的《Spring Boot 大型线上商城项目实战教程》课程，它来了！

前言

大家好，我是程序员十三。

写下这些文字的时候是2021年12月份，距离当前课程第一次在掘金平台上预售和发布已经整整过去了两年时间。《Spring Boot 大型线上商城项目实战教程》这个课程是2019年11月11日在掘金平台进行预售，是一个偏实战类的IT课程，该课程最终实现的是一个商城系统。

两年时间，真的是弹指一挥间。但是，对于一个线上课程来说，两年的时间已经足够使用沧海桑田来形容，是时候以全新的姿态和大家见面了。这篇文章，笔者会谈一谈为什么更新这个课程、更新了哪些内容，以及本课程实战项目newbee-mall近两年的变化。

课程更新缘由

课程更新的主要缘由如下：

首先，各位读者应该都在涉足 IT 行业或者与该行业有关的行业，这个行业的更新迭代非常快。行业中的人是如此、技术亦是如此，一旦跟不上知识更新的步伐就容易掉队。本课程实战项目newbee-mall于2019年完成了第一个版本的开发并开源于GitHub网站，这两年里该项目中的代码也更新迭代了数十次。实战项目的更新迭代并未同步更新到《Spring Boot 大型线上商城项目实战教程》这个课程中。

另外，本课程的40多篇文档都是2019年写作和整理的。虽然过程中也优化了一些文档，纠正了一些错别字和错误的表述，难免会有一部分漏网之鱼。2020年整理书稿时，在电子工业出版社几位编辑的指导下，文字编校和行文表述的功力有了一些进步。因此，重新整理了本课程的教学文档，改正了一些不规范的表述和字词的错误使用。学习如逆水行舟，不进则退。对于一个作品来说亦是如此，如果这个课程的内容不能及时更新迭代，也会慢慢地失去吸引力直至被人忘记。

其次是近期有了一些空闲时间，之前几个月一直非常忙，有一段时间甚至天天加班。一边忙着公司的事情，也会抽出一点点空闲的时间做副业相关的事情，比如2021年8月至2021年10月底，就完成了第二本实体书的草稿，后续还要花很多时间再去完善和修改。完成实体书的草稿后，就开始计划着更新迭代这个课程，因为短时间内也根本无法完成第二本实体书稿的定稿，不如赶紧把这个课程先给更新一下，索性拿出一两个月的时间来完成这个事情。在制定了更新计划之后，就慢慢地开始重写这些文档。

同时，作为课程的作者，笔者要对这个课程负责、对掘金平台负责、对每位购买过和想要购买的用户负责。为平台打造更多更好的内容，让大家有更好的学习体验，保证大家学到的知识不过时。最后，笔者也向大家承诺，虽然笔者也在做其他的开源项目，制作上线其它的线上课程，依然会实时的关注这个课程并一直维护这个课程，一旦有比较重要的版本更新都会及时升级这个课程中的内容，请各位读者放心。

更新了哪些内容

本课程主要包括40多篇课程文档和18份教学源码压缩包，主要的更新内容都是针对这两个部分。而本课程所讲解的实战商城项目newbee-mall则是课程文档和教学源码更新的基础，因此本小节主要讲解这三个部分的更新和优化。

商城项目迭代更新

本课程2019年版本中的源码使用了newbee-mall项目第一个版本作为基础代码去整理的。当时的newbee-mall项目刚刚开源，两年后的今天已经更新迭代了数十个版本，提交记录如下图所示。

版本更新如下：

页面样式更新

最初开源时，前端页面的测试主要是自己一个人在做，不是很充分，有些页面瑕疵并没有发现。后续将这部分的瑕疵一一修改，也删除了一些无用的文件和样式，让页面看起来更加舒服。

缺省页面效果添加

当列表数据为空时，并没有单独做缺省页面效果，页面效果非常简陋，后续更新中也逐一添加到项目中，比如商品搜索列表页面、购物车页面、订单列表页面。

BUG修复

刚开源时的项目有一些BUG，在开源后的两年时间里都被逐一修复。有些BUG是自己发现的，有些则是使用了这个项目的小伙伴们发现的，非常感谢大家。比如SQL注入的BUG、订单请求未被登录拦截器处理的BUG、商品搜索未过滤下架商品的BUG、用户修改信息导致字段变为空的BUG、登录拦截器未成功拦截的BUG。这些问题都被一一修复，希望能够继续发现问题，继续完善项目。

代码优化和TODO事项处理

这部分代码更新，主要是包括一下三点：

代码整理：删除无用代码，处理TODO事项，有些逻辑一开始就想加但是没来得及加上。
参数验证和判断逻辑优化：代码中的参数验证不充分，有些方法中甚至没有判断参数是否合格就进行了入库操作，这些都一一改正了。
异常处理优化：增加了全局异常处理、错误页面重做。

版本升级

主要是Spring Boot技术栈的版本升级，原来是2.1.0，升级为2.3.7，相应的依赖版本也都升级了。

还有验证码的生成规则也进行了修改，之前使用的是kaptcha。不过版本更新时间是2015年，因此替换了一个实现方式。

插件升级

富文本编辑由KindEditor升级为最新版本的wangEditor。
列表显示插件jqGrid升级至5.5.2。
轮播图插件Swiper升级至6.4.5。

对应的代码也做了删除和调整。

之前也整理一篇文章介绍富文本编辑器升级的原因，链接为《页面优化，最新版 wangEditor 富文本编辑器整合案例》。

课程文档更新

在本课程第一版的所有文稿都整理完成后，笔者的心里开始有了出版一本实体书的想法。2020年3月份开始与电子工业出版社进行沟通，之后是确定选题、写样张、签订约稿合同，到2021年2月份完成初稿，之后开始与出版社的编辑一起进行书籍的编审工作，最终于2021年7月份正式出版了。经过一年多的时间终于出版了第一本实体书籍。

然后，就有了本课程升级迭代的事情。在书籍出版的第4个月之后，终于找出时间完成了这个课程的升级迭代。

从2021年11月2号开始更新，记录如下图所示：

首先同步了掘金平台上本课程出版的所有文档到本地，之后开始一篇一篇的更新。底稿3就是当前的这篇文章，由于是一篇总结性的文章，所以其中的文字内容一直在调整。

在2021年12月份完成了大部分文档的更新，工作日志如下图所示。

课程的章节有增加有删减，主要是删减了部分已经舍弃技术讲解的章节和阅读量很低的章节。同时，所有的文稿整体来说更加书面和正式，因为是在书稿的基础上，完成了本次所有文档的更新迭代。笔者的写作习惯和写作技巧也在出版社编辑的指导下有了一点进步。

课程文档中的文字方面主要有以下几点改变：

错别字减少。
表达方式更书面和正式，减少了口语化的表述和啰嗦的句子。
文档中所使用的专业名词统一并且规范，以官方叫法为准。
标点符号规范，没有乱用标点符号。
大部分配图都重新制作，替换了2019年初版文档中的图片。
新增章节编号，结构看起来更清晰。

教学代码更新

开源仓库中的代码是本课程中实战项目完整的项目代码，而本课程中每个实战章节都有对应的代码。大家可以这样理解，newbee-mall开源商城项目被拆解为一个个独立的知识点，本课程每个章节的代码是对这些独立知识点的逐一实现，最终从零到一开发出商城项目。每个章节对应章节的讲解代码和最终成型的源码包，更适合大家循序渐进的去学习。

这部分代码也全部更新，很多的讲解案例和代码与2019年最初的版本有了很大的区别，基本上是重写了一遍。新的源码包汇总如下：