强烈推荐一个开源微电商项目luban-mall
前言
luban-mall 项目脱胎于开源电商项目mall,并在这一开源醒目的基础上由鲁班学院以伯乐老师为代表等进行了项目增强和完善。它是基于SpringBoot+MyBatis的电商系统，包括前台商城系统及后台管理系统
前台商城系统包含首页门户、商品推荐、商品搜索、商品展示、购物车、订单流程、会员中心、客户服务、帮助中心等模块。 后台管理系统包含商品管理、订单管理、会员管理、促销管理、运营管理、内容管理、统计报表、财务管理、权限管理、代码生成设置等模块。将这一项目吃透，对于Java开发人员来说非常有助于掌握java技术栈中主流的技术框架，既能学习电商项目的架构技术，也能熟悉和掌握电商项目中的业务开发。
1 电商分布式架构图
图 1 鲁班电商项目分布式架构图
2 单体架构
对于个人学习而言，最开始我们选择从单体架构开始。后面项目的业务模块多了和复杂起来之后，为了减少项目的耦合度才开始按照相互独立的业务模块拆分出微服务，走分布式系统架构路线。任何事情都应该从简单开始，本电商项目的起步学习阶段采用的是前后端分离的单体架构技术。
2.1 工程介绍
图 2 鲁班电商项目业务架构图
| 工程名 | 描述 |
|---|---|
| mall-common | 基础工程 |
| mall-security | 基础校验 |
| mall-admin | 商品后台管理系统，包括商品中心、活动管理和订单管理等 |
| mall-core | 电商系统业务核心系统，主要进行订单处理 |
| mall-search | 商品搜索 |
| mb-generator | mybatis工具类 |
| luban-admin-web | 管理后台的web项目 |
| luban-front-web | 电商前端web项目 |
2.2 技术选型
前后分离
后端技术选型
| 技术 | 说明 | 官网 |
|---|---|---|
| Spring Boot | 容器+MVC框架 | https://spring.io/projects/spring-boot |
| Spring Security | 认证和授权框架 | https://spring.io/projects/spring-security |
| Mybatis | ORM框架 | http://www.mybatis.org/mybatis-3/zh/index.html |
| MyBatisGenerator | 数据层代码生成 | http://www.mybatis.org/generator/index.html |
| PageHelper | MyBatis物理分页插件 | http://git.oschina.net/free/Mybatis_PageHelper |
| Swagger-UI | 文档生成工具 | https://github.com/swagger-api/swagger-ui |
| Elasticsearch | 搜索引擎 | https://github.com/elastic/elasticsearch |
| RabbitMq | 消息队列 | https://www.rabbitmq.com/ |
| Redis | 分布式缓存 | https://redis.io/ |
| MongoDb | 文档型数据库 | https://www.mongodb.com/ |
| zookeeper | 分布式锁 | https://zookeeper.apache.org/ |
| Docker | 应用容器引擎 | https://www.docker.com/ |
| Druid | 数据库连接池 | https://github.com/alibaba/druid |
| OSS | 对象存储 | https://github.com/aliyun/aliyun-oss-java-sdk |
| JWT | JWT登录支持 | https://github.com/jwtk/jjwt |
| LogStash | 日志收集 | https://github.com/logstash/logstash-logback-encoder |
| Lombok | 简化对象封装工具 | https://github.com/rzwitserloot/lombok |
| Seata | 全局事务管理框架 | https://github.com/seata/seata |
| Portainer | docker容器可视化管理工具 | https://github.com/portainer/portainer |
| canal | 数据同步 | https://github.com/alibaba/canal |
前端技术选型
| 技术 | 说明 | 官网 |
|---|---|---|
| Vue | 前端框架 | https://vuejs.org/ |
| Vue-router | 路由框架 | https://router.vuejs.org/ |
| Vuex | 全局状态管理框架 | https://vuex.vuejs.org/ |
| Element | 前端UI框架 | https://element.eleme.io/ |
| Axios | 前端HTTP框架 | https://github.com/axios/axios |
| v-charts | 基于Echarts的图表框架 | https://v-charts.js.org/ |
环境依赖
| 工具 | 版本号 | 下载 |
|---|---|---|
| JDK | 1.8 | https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html |
| Mysql | 5.7 | https://www.mysql.com/ |
| Redis | 3.2 | https://redis.io/download |
| Elasticsearch | 6.2.2 | https://www.elastic.co/downloads |
| MongoDb | 3.2 | https://www.mongodb.com/download-center |
| RabbitMq | 3.7.14 | http://www.rabbitmq.com/download.html |
| nginx | 1.10 | http://nginx.org/en/download.html |
3 后端开发环境搭建
扫描本文底部的微信二维码关注笔者的微信公众号码农进阶之路2020，发送消息【luban-mall】可获得luban-mall项目的百度网盘下载地址。
-
下载 luban-mall工程，包含模块（mall-common，mall-security，mall-admin，mall-core，mall-search，mb-generator
-
IDE导入luban-mall项目
图 3 鲁班电商项目后台工程结构图
3.1安装Mysql数据库并初始化数据
- 安装myql,创建数据库，默认mall
mysql的安装可以参考这篇文章：MySQL 安装
如果需要在Linux服务器上安装Mysql5.7,请参考我的这篇文章：Linux系统云服务器上安装Mysql5.7数据库，解决不能远程访问的bug
#使用root账户登录命令行客户端（如Navicat或IDEA中的DataSource）后执行sql脚本创建mall数据库
create database mall;
#设置全局密码验证策略和长度限制，防止创建用户授予密码时报错
set global validate_password_policy=LOW;
set global validate_password_length=8;
#创建新的druid用户及登录密码
create user 'druid'@'%' IDENTIFIED BY 'druid705';
#查询root用户是否具备给其他用户授权的限制
use mysql;
SELECT host,user,Grant_priv,Super_priv FROM user where user='root';
#如果你以上查询结果Grant_priv字段的值为'N',则执行以下sql使root用户可以给其他用户授予操作权限
UPDATE user SET Grant_priv='Y' WHERE User='root';
FLUSH PRIVILEGES;
#授予druid用户对mall库下表的增删改查权限和创建和删除表、视图的一系列权限
GRANT CREATE,DROP,ALTER,INSERT,UPDATE,SELECT,DELETE on mall.* to 'druid'@'%' with grant OPTION;
- 创建好mall数据库和druid用户并使用root账户给其授权后就可以使用druid账户登录连接mysql的mall数据库，在客户端命令控制台中将项目根目录下的
document/sql/mall.sql脚本拷贝进去并执行建表和插入数据了
3.2 Redis安装
读者可参考这篇文章安装缓存数据库Redis：Redis 安装 包含了windows系统和Linux系统下Redis的安装，Redis官网建议使用Linux系统下安装最新稳定版本redis，目前的稳定版本为redis-6.0.8。不过为了方便本地开发，我们可以在本地安装windows系统下的redis-3.2版本。上了测试和生产环境最好换成Linux系统下的Redis服务。
3.3 ElasticSearch 安装
读者可参考我的这篇文章大数据分析利器ElasticSearch入门(一)安装ES，不过笔者当时安装的版本是7.3.2版本，Linux和Windows系统下的安装内容都有，而且步骤非常详细，对于安装过程中出现bug进行了解决和规避。
3.4 MongoDB 安装
(1) Windows 系统下安装 MongoDB
读者可参考菜鸟教程的这篇文章在Windows系统下安装 MongoDB 文档数据库：
Windows 平台安装 MongoDB
(2) linux 系统下安装 MongoDB
读者可参考菜鸟教程的这篇文章在Linux系统下安装 MongoDB 文档数据库：
Linux平台安装MongoDB
3.4 RabbitMQ 安装
读者可参考笔者的这篇文章安装 RabbitMQ： 快速入门高级消息中间件RabbitMQ 文中囊括了 Windows 平台和 Linux 平台下消息队列 RabbitMQ 的安装
4 启动后台项目服务
4.1 启动 mall-admin 项目服务
修改mall-admin项目中src/main/resource/application.yml 中的Mysql数据库连接配置信息
spring:
datasource:
url: jdbc:mysql://localhost:3306/mall?serverTimezone=UTC&useSSL=false&useUnicode=true&characterEncoding=UTF-8
username: druid
password: druid705
修改完成后运行 mall-admin 模块中AdminApplication启动类中的Main 方法启动mall-admin服务，端口号为8091
4.2 启动 mall-core 项目服务
在 mall-core 项目中的启动配置项中的 redis、mongodb 和 rabbitmq 服务器连接参数换成自己安装时配置的参数值
application.yml
spring:
datasource:
url: jdbc:mysql://localhost:3306/mall?serverTimezone=UTC&useSSL=false&useUnicode=true&characterEncoding=UTF-8
username: druid
password: druid705
druid:
initial-size: 5 #连接池初始化大小
min-idle: 10 #最小空闲连接数
max-active: 20 #最大连接数
web-stat-filter:
exclusions: "*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*" #不统计这些请求数据
stat-view-servlet: #访问监控网页的登录用户名和密码
login-username: druid
login-password: druid
data:
mongodb:
host: 134.175.187.61
uri: mongodb://mongod:>@>:27017/test
redis:
host: 134.175.187.61 # Redis服务器地址
database: 0 # Redis数据库索引（默认为0）
port: 6379 # Redis服务器连接端口
password: # Redis服务器连接密码（默认为空）
jedis:
pool:
max-active: 8 # 连接池最大连接数（使用负值表示没有限制）
max-wait: -1ms # 连接池最大阻塞等待时间（使用负值表示没有限制）
max-idle: 8 # 连接池中的最大空闲连接
min-idle: 0 # 连接池中的最小空闲连接
timeout: 3000ms # 连接超时时间（毫秒）
rabbitmq:
host: localhost
port: 5672
virtual-host: / #mall
username: admin
password: admin123
publisher-confirms: true #如果对异步消息需要回调必须设置为true
注意： 上面的mongdb连接的和需要替换成你自己配置mongodb是创建的mongod用户密码和mongodb服务安装所在的服务器IP地址或着域名
依次次启动redis服务、mongodb服务和rabbitmq服务，然后运行启动类CoreApplication.java中的main方法，启动 CoreApplication 项目，服务端口为8081
4.3 启动 mall-search 服务
启动 elastic-search服务，并修改 mall-search 模块中的应用能启动配置文件application.yml 中关于 mysql 数据库和 elasticsearch 的客户端连接配置信息对应自己安装时的参数值
application.yml
spring:
datasource:
url: jdbc:mysql://localhost:3306/mall?serverTimezone=UTC&useSSL=false&useUnicode=true&characterEncoding=UTF-8
username: druid
password: druid705
druid:
initial-size: 5 #连接池初始化大小
min-idle: 10 #最小空闲连接数
max-active: 20 #最大连接数
web-stat-filter:
exclusions: "*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*" #不统计这些请求数据
stat-view-servlet: #访问监控网页的登录用户名和密码
login-username: druid
login-password: druid
data:
elasticsearch:
repositories:
enabled: true
cluster-nodes: localhost:9200
cluster-name: elasticsearch
elasticsearch:
rest:
uris: ["http://localhost:9200"]
然后再运行SearchApplication启动类中的main方法，在笔者的本地开发环境启动过程中报了加载 elasticsearch 节点失败的异常，但并不影响项目正常启动,服务端口为8500。异常信息如下：
2020-11-28 16:30:31.783 ERROR 24136 --- [ main] .d.e.r.s.AbstractElasticsearchRepository : failed to load elasticsearch nodes : org.elasticsearch.client.transport.NoNodeAvailableException: None of the configured nodes are available:
异常信息显示配置的 elasticsearch 节点不可用，这个问题后面有时间研究设计ES查询业务时再来解决。到时解决了笔者再专门发一篇关于ES的文章。
5 启动后台管理前端项目服务
扫描文章底部微信二维码关注笔者的微信公众号码农进阶之路2020，发送关键词信息【luban–web-admin】即可获得下载鲁班电商项目后台管理项目的前端代码克隆地址
前端项目基于Vue+Element实现。需要依赖 nodejs，所以需要提前下载安装nodejs。nodejs 下载地址: nodejs安装包下载地址
使用git将 luban-web-admin项目克隆至本地后使用 VScode 以打开文件夹的方式打开项目，在 TERMINAL 命令行控制台中执行 npm install命令完成项目依赖包的安装，如果按照过程中出现 node-sass 安装失败的问题，请参考这篇文章解决：node-sass 安装失败的各种坑
安装依赖模块成功后，执行 npm run dev 命令在本地启动前端项目服务。
项目启动成功后控制台显示服务运行在 http://localhost:8090
图 4 uban-admin-web项目启动成功截图
6 电商后台管理项目效果体验
前后端项目启动成功后，在谷歌浏览器中输入 http://localhost:8090
会弹出登录对话框，输入 admin用户名，密码：admin1234，然后点击登录
后台用了spring-security 技术对用户的操作请求进行了认证和鉴权拦截。
图 5 电商后台管理系统首页
目前有商品、订单和营销三个大菜单。每个大菜单下都有相应的子菜单模块，读者可以自己点击相应的子菜单按钮，进入相应的操作页面。具体可查看luban-mall/document/reference目录下的dev_flow.md 开发进度文档。
以下是商品菜单下的商品列表页面：
图 6 商品列表页面
luban-mall 微电商项目的环境搭建和本地服务启动准备内容就讲到这里，文章首发个人的微信公众号“码农的进阶之路2020",欢迎初次阅读笔者文章的读者朋友们加个关注，笔者会不定期推送技术干货文章，与读者粉丝们共同成长。
