2022年最新《谷粒商城开发教程》：1 - 构建工程篇

• Java工程师的进阶之路
• 代码地址
• 2 - vue 简要笔记
• 3 - 商品服务-API-三级分类
• 4 - 商品服务-API-品牌管理
• 5 - 商品服务-API-属性分组

---

---

前言

前置知识：

• Vue
• Spring + SpringMVC + MyBatis
• SpringBoot + Mybatis-plus + SpringCloud + SpringCloudAlibaba
• Linux - Git - Redis - Docker - Nginx
• Java工程师的进阶之旅 - 上面的教程大部分有笔记

---

一、项目架构

整体架构图：

1、前后分离开发，分为内网部署和外网部署，外网是面向公众访问的，部署前端项目，可以有手机APP，电脑网页；内网部署的是后端集群，前端在页面上操作发送请求到后端，在这途中会经过Nginx集群，Nginx把请求转交给API网关(springcloud gateway)（网关可以根据当前请求动态地路由到指定的服务，看当前请求是想调用商品服务还是购物车服务还是检索），从路由过来如果请求很多，可以负载均衡地调用商品服务器中一台（商品服务复制了多份），当商品服务器出现问题也可以在网关层面对服务进行熔断或降级（使用阿里的sentinel组件），网关还有其他的功能如认证授权、限流（只放行部分到服务器）等。

2、到达服务器后进行处理（springboot为微服务），服务与服务可能会相互调用（使用OpenFeign组件），有些请求可能经过登录才能进行（基于OAuth2.0的认证中心。安全和权限使用springSecurity控制）

3、服务可能保存了一些数据或者需要使用缓存，我们使用redis集群（分片+哨兵集群）。持久化使用mysql，读写分离和分库分表。

4、服务和服务之间会使用消息队列（RabbitMQ），来完成异步解耦，分布式事务的一致性。有些服务可能需要全文检索，检索商品信息，使用ElaticSearch。

5、服务可能需要存取数据，使用阿里云的对象存储服务OSS。

6、项目上线后为了快速定位问题，使用ELK对日志进行处理，使用LogStash收集业务里的各种日志，把日志存储到ES中，用Kibana可视化页面从ES中检索出相关信息，帮助我们快速定位问题所在。

7、在分布式系统中，由于我们每个服务都可能部署在很多台机器，服务和服务可能相互调用，就得知道彼此都在哪里，所以需要将所有服务都注册到注册中心。服务从注册中心发现其他服务所在位置（使用阿里Nacos作为注册中心）。

8、每个服务的配置众多，为了实现改一处配置相同配置就同步更改，就需要配置中心，也使用阿里的Nacos，服务从配置中心中动态取配置。

9、服务追踪，追踪服务调用链哪里出现问题，使用springcloud提供的Sleuth、Zipkin、Metrics，把每个服务的信息交给开源的Prometheus进行聚合分析，再由Grafana进行可视化展示，提供Prometheus提供的AlterManager实时得到服务的告警信息，以短信/邮件的方式告知服务开发人员。

10、还提供了持续集成和持续部署。项目发布起来后，因为微服务众多，每一个都打包部署到服务器太麻烦，有了持续集成后开发人员可以将修改后的代码提交到github，运维人员可以通过自动化工具Jenkins Pipeline将github中获取的代码打包成docker镜像，最终是由k8s集成docker服务，将服务以docker容器的方式运行。

---

微服务划分图：

反映了需要创建的微服务以及相关技术。

前后分离开发。前端项目分为admin-vue（工作人员使用的后台管理系统）、shop-vue（面向公众访问的web网站）、app（公众）、小程序（公众）

• 商品服务：商品的增删改查、商品的上下架、商品详情
• 支付服务
• 优惠服务
• 用户服务：用户的个人中心、收货地址
• 仓储服务：商品的库存
• 秒杀服务：定时任务与redis
• 订单服务：订单增删改查、验价、幂等性token
• 检索服务：商品的检索ES
• 中央认证服务：登录、注册、单点登录、社交登录
• 购物车服务：redis
• 后台管理系统：添加优惠信息等

---

二、服务器环境搭建

1、创建一个新的虚拟机CentOS7.6 for gulimall - 内存4G + 20G硬盘 + 4核处理器

2、虚拟机配置固定IP地址 - 教程

3、虚拟机安装Docker - 教程

---

4、Docker - MySQL and Nacos

这里将nacos也配置在了docker中，并且配置好了mysql的持久化

教程地址

---

5、Docker - Redis

5.1、如果直接挂载的话docker会以为挂载的是一个目录，先创建文件并配置持久化

mkdir -p /mydata/redis/conf
# 在 redis.conf 开启 redis持久化配置
echo 'appendonly yes' >  /mydata/redis/conf/redis.conf

5.2、运行容器

docker run -p 6379:6379 --name redis \
-v /mydata/redis/data:/data \
-v /mydata/redis/conf/redis.conf:/etc/redis/redis.conf \
--restart=always \
-d redis redis-server /etc/redis/redis.conf

5.3、最终效果

---

6、Docker - Nginx

6.1、启动nginx测试容器，复制出配置文件

docker run --name test -d nginx:1.10

mkdir /mydata/nginx && cd /mydata/nginx

docker cp test:/etc/nginx .

mv /mydata/nginx/nginx /mydata/nginx/conf

docker rm -f test

6.2、运行容器

docker run -p 80:80 --name nginx \
-v /mydata/nginx/html:/usr/share/nginx/html \
-v /mydata/nginx/logs:/var/log/nginx \
-v /mydata/nginx/conf:/etc/nginx \
--restart=always \
-d nginx:1.10												

6.3、最终效果

---

三、开发环境搭建

3.1、maven

在settings中配置阿里云镜像，配置jdk1.8

IDEA安装插件lombok，mybatisX。IDEA设置里配置好maven

3.2、VSCode 安装插件

• Auto Close Tag
• Auto Rename Tag
• Chinese
• ESlint
• HTML CSS Support
• HTML Snippets
• JavaScript ES6
• Live Server
• open in brower
• Vetur

---

四、IDEA环境搭建

Git教程

• Gitee - 新建仓库 gulimall
• 选择 - 语言java，在.gitignore选中maven，许可证选Apache-2.0
• 开发模型 - 生产/开发模型，开发时在dev分支，发布时在master分支
• IDEA - New – Project from version control - git - 复制远程仓库地址
• 新建 - pom.xml作为父工程pom，在maven窗口刷新，并点击+号，找到刚才的pom.xml添加进来，发现多了个root。这样比如运行root的clean命令，其他项目也一起clean了。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>

	<groupId>com.laptoy.gulimall</groupId>
	<artifactId>gulimall</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<name>gulimall</name>
	<description>聚合服务</description>

	<packaging>pom</packaging>

	<modules>
		<module>gulimall-coupon</module>
		<module>gulimall-member</module>
		<module>gulimall-order</module>
		<module>gulimall-product</module>
		<module>gulimall-ware</module>
	</modules>
	
</project>

• 父工程 .gitignore文件添加，排除垃圾文件

**/mvnw
**/mvnw.cmd
**/.mvn
**/target/
.idea
**/.gitignore

---

使用 Spring Initializr 依次创建出以下服务模块

1、 group - com.laptoy.gulimall

2、版本（版本一定要对上，否则必定报错）

• SpringBoot版本 - 2.1.8.RELEASE
• SpringCloud版本 - Greenwich.SR3

3、添加 - web和openfeign组件

服务名	服务名	包名	端口
优惠券服务	gulimall-coupon	com.laptoy.gulimall.coupon	7000
用户服务	gulimall-member	com.laptoy.gulimall.member	8000
订单服务	gulimall-order	com.laptoy.gulimall.order	9000
商品服务	gulimall-product	com.laptoy.gulimall.product	10000
存储服务	gulimall-ware	com.laptoy.gulimall.ware	11000

4、最终效果

5、参考

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.8.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    
    <groupId>com.laptoy.gulimall</groupId>
    <artifactId>gulimall-product</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>gulimall-product</name>
    <description>gulimall-product</description>

    <properties>
        <java.version>1.8</java.version>
        <spring-cloud.version>Greenwich.SR3</spring-cloud.version>
    </properties>
    
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

---

五、数据库环境搭建

1、下载SQL文件 SQL脚本位置

2、使用IDEA内置数据库可视化进行运行 sql脚本

3、选择所有脚本

4、最终效果

---

六、人人开源-环境搭建

1、采用 人人开源项目 作为基石 - 使用 renren-fast（后端），renren-fast-vue（前端）项目。

2、直接Clone并删除里面的 .git文件

git clone https://gitee.com/renrenio/renren-fast.git
git clone https://gitee.com/renrenio/renren-fast-vue.git

---

6.1、后端环境IDEA

1、把 renren-fast 移动到 gulimall 文件夹下（删掉 .git文件）

2、父项目POM添加

<modules>
	...	
    <module>renren-fast</module>
</modules>

3、打开 - renren-fast/db/mysql.sql，创建数据库 gulimall_admin 并执行SQL文件
前面一起通过sql脚本创建好了

4、修改YML - 修改application-dev.yml中的数据库，修改为自己的 IP

url: jdbc:mysql://192.168.88.129:3306/gulimall_admin?useSSL=false&useUnicode=true&characterEncoding=utf-8&useLegacyDatetimeCode=false&serverTimezone=Asia/Shanghai
username: root
password: root

5、运行该模块

访问 - http://localhost:8080/renren-fast/ 成功返回 {“msg”:“invalid token”,“code”:401}

---

6.2、前端环境VSCode

1、用VSCode打开 renren-fast-vue

2、安装Node.js：下载 12.1 版本

3、CMD终端 - 查看版本并修改国内镜像

node -v
# 修改镜像仓库
npm config set registry http://registry.npm.taobao.org/

NPM是随同NodeJS一起安装的包管理工具。JavaScript-NPM类似于java-Maven。

4、以管理员身份在VSCode打开该项目

# 配置镜像
npm config set registry http://registry.npm.taobao.org/

npm install  node-sass@4.14
npm install

# 启动
npm run dev

5、测试

访问 - http://localhost:8001/ 输入验证码登录成功

---

七、人人开源-逆向工程

1、拉取逆向工程项目

git clone https://gitee.com/renrenio/renren-generator.git

2、父工程POM添加

<modules>
	...	
    <module>renren-generator</module>
</modules>

3、修改YML为自己的 MySQL IP地址

url: jdbc:mysql://192.168.88.129:3306/gulimall_pms?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
username: root
password: root

4、修改逆向工程执行文件 - generator.properties

# 主目录
mainPath=com.laptoy
# 包名
package=com.laptoy.gulimall
# 模块名
moduleName=product   # 对应模块修改
# 作者
author=laptoy
# email
email=laptoy458@163.com
# 表前缀(类名不会包含表前缀) 
# 我们的pms数据库中的表的前缀都pms
# 如果写了表前缀，每一张表对应的javaBean就不会添加前缀了
tablePrefix=pms_

5、进入该模块的resources/template/controller.java.vm修改控制类生成模板

• ctrl + R - 搜索 @RequiresPermissions 注释这些代码（默认是shiro的安全，以后转为springsecurity，先不删除）
• 删除该注解的引用 - import org.apache.shiro.authz.annotation.RequiresPermissions;（这个直接删除）

6、访问 - localhost:80 - 这里全选其他但是不用选择undo_log数据表切记

6、直接复制 main文件夹 到对应模块

7、删除 resources/src 目录

8、发现有些代码报红，后面处理

---

八、公共模块Common

1、新建普通Maven模块 - gulimall-common

2、父工程POM

<modules>
	...	
    <module>gulimall-common</module>
</modules>

3、当前项目POM - 添加

<!-- mybatisPLUS-->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.3.2</version>
</dependency>
<!--简化实体类，用@Data代替getset方法-->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.8</version>
</dependency>
<!-- httpcomponent包。发送http请求 -->
<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpcore</artifactId>
    <version>4.4.13</version>
</dependency>
<dependency>
    <groupId>commons-lang</groupId>
    <artifactId>commons-lang</artifactId>
    <version>2.6</version>
</dependency>
<!-- 数据库驱动 https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.17</version>
</dependency>
<!--tomcat里一般都带-->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>servlet-api</artifactId>
    <version>2.5</version>
    <scope>provided</scope>
</dependency>

4、五个开发模块添加依赖依赖common工程

<dependency>
    <groupId>com.laptoy.gulimall</groupId>
    <artifactId>gulimall-common</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

5、拷贝文件 -

• common模块 建包 com.laptoy.common.utils

以下都是在renren-fast模块拷贝代码

• 拷贝utils 包里的 Query、PageUtils、R、Constant 到com.laptoy.common.utils
• 拷贝exception 包的 RRException 到 com.laptoy.common.utils下
• 拷贝xss 包里的 HTMLFilter、SQLFilter 到 com.laptoy.common.xss下
• 拷贝 validator.group 包里的 AliyunGroup、QcloudGroup、QuniuGroup到 com.laptoy.common.group下

---

九、测试

测试与整合商品服务里的mybatisplus

1、在product项目的resources目录下新建application.yml

server:
  port: 10000

spring:
  datasource:
    username: root
    password: root
    url: jdbc:mysql://192.168.88.129:3306/gulimall_pms?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
    driver-class-name: com.mysql.cj.jdbc.Driver

# MapperScan
# sql映射文件位置
mybatis-plus:
  mapper-locations: classpath:/mapper/**/*.xml
  global-config:
    db-config:
      id-type: auto

2、主启动类

@MapperScan("com.laptoy.gulimall.product.dao")
@SpringBootApplication
public class GulimallProductApplication {
    public static void main(String[] args) {
        SpringApplication.run(GulimallProductApplication.class, args);
    }
}

3、测试 - 添加

@RunWith(SpringRunner.class)
@SpringBootTest
public class GulimallProductApplicationTests {

    @Autowired
    BrandService brandService;

    @Test
    public void contextLoads() {
        BrandEntity brandEntity = new BrandEntity();
        brandEntity.setDescript("哈哈1哈");
        brandEntity.setName("华为");
        brandService.save(brandEntity);
        System.out.println("保存成功");
    }
}

---

十、优化其他模块

10.1、gulimall-coupon（对应库gulimall_sms，端口7000）

1、打开generator逆向工程，修改generator.properties

# 主目录
mainPath=com.laptoy
# 包名
package=com.laptoy.gulimall
# 模块名
moduleName=coupon # 对应模块修改
# 作者
author=laptoy
# email
email=laptoy458@163.com
# 表前缀(类名不会包含表前缀) 
# 我们的pms数据库中的表的前缀都pms
# 如果写了表前缀，每一张表对应的javaBean就不会添加前缀了
tablePrefix=sms_

2、打开generator逆向工程，修改application.yml - 连接gulimall_sms进行逆向工程

url: jdbc:mysql://192.168.88.129:3306/gulimall_sms?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
username: root
password: root

---

3、新增 - YML

server:
  port: 7000

spring:
  datasource:
    username: root
    password: root
    url: jdbc:mysql://192.168.88.129:3306/gulimall_sms?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
    driver-class-name: com.mysql.cj.jdbc.Driver

mybatis-plus:
  mapper-locations: classpath:/mapper/**/*.xml
  global-config:
    db-config:
      id-type: auto
      logic-delete-value: 1
      logic-not-delete-value: 0

4、运行逆向工程模块

访问 - localhost:80 - 勾选所有表除了undo_log表进行代码生成

5、复制 - main目录 到当前模块

6、删除 - resources下的 src包

7、测试类里的junit可能有问题，估计是springboot的junit的问题

7、运行测试

访问 - http://localhost:7000/coupon/coupon/list 响应成功

---

10.2、 gulimall-member（对应库gulimall_ums，端口8000）

1、模仿以上的代码

2、访问 - http://localhost:8000/member/growthchangehistory/list 响应成功

---

10.3、 gulimall-order（对应库gulimall_oms，端口9000）

1、模仿以上的代码

2、访问 - http://localhost:9000/order/order/list 响应成功

---

10.4、 gulimall-ware（对应库gulimall_wms，端口11000）

1、模仿以上的代码

2、访问 - http://localhost:11000/ware/wareinfo/list 响应成功

---

十一、整合CloudAlibaba

1、common模块POM - 加入依赖管理

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>2.1.0.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

---

11.1、Nacos注册中心

1、common模块引入依赖

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

2、五个模块 - 启动类 - 添加注解 - 开启服务发现 - @EnableDiscoveryClient

3、五个模块 - YML - 新增

spring:
  application:
    name: gulimall-xxx
  cloud:
    nacos:
      discovery:
        server-addr: 192.168.88.129:8848

4、运行模块并访问 - 192.168.88.129:8848/nacos - 服务注册成功

---

11.2、Nacos配置中心

本项目的配置：

• 五个模块都有自己的命名空间
• 每个模块的命名空间采用组：dev、prod、test、info
• 每个模块的组采用多配置集：mybatis.yml、datasource.yml、other.yml

1、为五个服务分别创建命名空间

2、为每个模块创建组（这个自行演示）

3、多配置集 - 这里以coupon模块做演示，其余模块自行模仿

• dev组 - mybatis 的配置
  
• dev组 - datasource 的配置
  
• dev组 - other.yml
  

查看数据库nacos可以发现数据都持久化成功了

---

代码配置

1、common模块引入依赖

<dependency>
     <groupId>com.alibaba.cloud</groupId>
     <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
 </dependency>

2、新增 - 连接配置中心文件 - bootstrap.properties - （配置中心也需要指定服务名）

spring.application.name=gulimall-xxx
spring.cloud.nacos.config.server-addr=192.168.88.129:8848

# 指定命名空间
spring.cloud.nacos.config.namespace=xxx-xxxx-xxxx

# 指定组
# spring.cloud.nacos.config.group=dev	

# 指定组的多配置集
spring.cloud.nacos.config.ext-config[0].data-id=datasource.yml
spring.cloud.nacos.config.ext-config[0].group=dev
spring.cloud.nacos.config.ext-config[0].refresh=true

spring.cloud.nacos.config.ext-config[1].data-id=mybatis.yml
spring.cloud.nacos.config.ext-config[1].group=dev
spring.cloud.nacos.config.ext-config[1].refresh=true

spring.cloud.nacos.config.ext-config[2].data-id=other.yml
spring.cloud.nacos.config.ext-config[2].group=dev
spring.cloud.nacos.config.ext-config[2].refresh=true

3、运行 - http://localhost:7000/coupon/coupon/list 响应成功

---

11.3、整合Gateway网关

1、使用 initilizer 创建微服务

• Group：com.laptoy.gulimall
• Artifact： gulimall-gateway
• package：com.laptoy.gulimall.gateway
• 选中 Gateway组件 添加

2、POM

• 修改 - SpringBoot版本：2.1.8.RELEASE
• 修改 - SpringCloud版本：Greenwich.SR3
• 添加依赖 - 依赖 common模块

3、配置中心

• 新增命名空间：gateway
• 新增配置文件：dev组 - other.properties：存放端口和注册中心配置（数据少直接用properties了）

spring.cloud.nacos.discovery.server-addr=192.168.88.129:8848
spring.application.name=gulimall-gateway
server.port=88

• 新增配置文件：dev组 - gateway.yml：存放网关配置（看不懂的去看看cloud的教程，文章开头有链接自己的笔记）

spring:
  cloud:
    gateway:
      routes:
      - id: test_route
        uri: https://www.bilibili.com
        predicates:
          - Query=url,bilibili

4、YML - bootstrap.properties

spring.application.name=gulimall-gateway

spring.cloud.nacos.config.server-addr=192.168.88.129:8848
spring.cloud.nacos.config.namespace=xxx-xx-xx-xxx-xx

spring.cloud.nacos.config.ext-config[0].data-id=other.properties
spring.cloud.nacos.config.ext-config[0].group=dev
spring.cloud.nacos.config.ext-config[0].refresh=true

spring.cloud.nacos.config.ext-config[1].data-id=gateway.yml
spring.cloud.nacos.config.ext-config[1].group=dev
spring.cloud.nacos.config.ext-config[1].refresh=true

5、主启动类 - 开启服务发现并排除数据库相关配置，因为前面引入的common模块有数据库相关配置

@EnableDiscoveryClient
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
public class GulimallGatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(GulimallGatewayApplication.class, args);
    }
}

6、访问 - http://localhost:88/?url=bilibili 跳转到bilibili页面