乐优商城（一）介绍和项目搭建

1. 乐优商城介绍

1.1 项目介绍

• 乐优商城是一个全品类的电商购物网站（B2C）
• 用户可以在线购买商品、加入购物车、下单
• 可以评论已购买商品
• 管理员可以在后台管理商品的上下架、促销活动
• 管理员可以监控商品销售状况
• 客服可以在后台处理退款操作
• 希望未来 3 到 5 年可以支持千万用户的使用

1.2 项目架构

1.3 系统架构解读

整个乐优商城可以分为两部分：后台管理系统、前台门户系统。

• 后台管理系统：

  • 后台系统主要包含以下功能：
    • 商品管理，包括商品分类、品牌、商品规格等信息的管理
    • 销售管理，包括订单统计、订单退款处理、促销活动生成等
    • 用户管理，包括用户控制、冻结、解锁等
    • 权限管理，整个网站的权限控制，采用JWT鉴权方案，对用户及API进行权限控制
    • 统计，各种数据的统计分析展示
  • 后台系统会采用前后端分离开发，而且整个后台管理系统会使用 Vue.js 框架搭建出单页应用（SPA）。

• 前台门户系统：

  • 前台门户面向的是客户，包含与客户交互的一切功能：
    • 搜索商品
    • 加入购物车
    • 下单
    • 评价商品等等
  • 前台系统我们会使用 Thymeleaf 模板引擎技术来完成页面开发。出于 SEO 优化的考虑，我们将不采用单页应用。

无论是前台还是后台系统，都共享相同的微服务集群，包括：

• 商品微服务：商品及商品分类、品牌、库存等的服务
• 搜索微服务：实现搜索功能
• 订单微服务：实现订单相关
• 购物车微服务：实现购物车相关功能
• 用户中心：用户的登录注册等功能
• Eureka注册中心
• Zuul网关服务

2. 项目搭建

2.1 技术选型

前端技术：

• 基础的 HTML、CSS、JavaScript（基于 ES6 标准）
• JQuery
• Vue.js 2.0 以及基于 Vue 的框架：Vuetify（UI框架）
• 前端构建工具：WebPack
• 前端安装包工具：NPM
• Vue 脚手架：Vue-cli
• Vue 路由：vue-router
• Ajax 框架：axios
• 基于 Vue 的富文本框架：quill-editor

后端技术：

• 基础的 SpringMVC、Spring 5.x 和 MyBatis3
• Spring Boot 2.2.4 版本
• Spring Cloud Hoxton.SR1
• Redis-4.0
• RabbitMQ-3.4
• Elasticsearch-6.3
• nginx-1.14.2
• FastDFS - 5.0.8
• MyCat
• Thymeleaf
• mysql 5.6

2.2 开发环境

• IDE：我们使用 Idea 2018.1 版本
• JDK：统一使用 JDK1.8
• 项目构建：maven3.3.9 以上版本即可
• 版本控制工具：git

2.3 域名

我们在开发的过程中，为了保证以后的生产、测试环境统一，尽量都采用域名来访问项目。

一级域名：www.leyou.com

二级域名：api.leyou.com

我们可以通过 switchhost 工具来修改自己的 host 对应的地址，只要把这些域名指向 127.0.0.1，那么跟你用 localhost 的效果是完全一样的。

2.4 创建父工程

创建统一的父工程：leyou，用来管理依赖及其版本。

1. Create New Project --> Maven --> Next

   

2. 填写项目信息 --> Next

   

3. 填写保存的位置 --> Finish

   

4. 添加依赖

   <?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <modelVersion>4.0.0</modelVersion>
   
       <groupId>com.leyou.parent</groupId>
       <artifactId>leyou</artifactId>
       <packaging>pom</packaging>
       <version>1.0-SNAPSHOT</version>
   
       <name>leyou</name>
       <description>Demo project for Spring Boot</description>
   
       <parent>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-parent</artifactId>
           <version>2.2.4.RELEASE</version>
           <relativePath/> <!-- lookup parent from repository -->
       </parent>
   
       <properties>
           <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
           <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
           <java.version>1.8</java.version>
           <spring-cloud.version>Hoxton.SR1</spring-cloud.version>
           <mybatis.starter.version>1.3.2</mybatis.starter.version>
           <mapper.starter.version>2.0.2</mapper.starter.version>
           <druid.starter.version>1.1.9</druid.starter.version>
           <mysql.version>5.1.32</mysql.version>
           <pageHelper.starter.version>1.2.3</pageHelper.starter.version>
           <leyou.latest.version>1.0.0-SNAPSHOT</leyou.latest.version>
           <fastDFS.client.version>1.26.1-RELEASE</fastDFS.client.version>
       </properties>
   
       <dependencyManagement>
           <dependencies>
               <!-- springCloud -->
               <dependency>
                   <groupId>org.springframework.cloud</groupId>
                   <artifactId>spring-cloud-dependencies</artifactId>
                   <version>${spring-cloud.version}</version>
                   <type>pom</type>
                   <scope>import</scope>
               </dependency>
               <!-- mybatis启动器 -->
               <dependency>
                   <groupId>org.mybatis.spring.boot</groupId>
                   <artifactId>mybatis-spring-boot-starter</artifactId>
                   <version>${mybatis.starter.version}</version>
               </dependency>
               <!-- 通用Mapper启动器 -->
               <dependency>
                   <groupId>tk.mybatis</groupId>
                   <artifactId>mapper-spring-boot-starter</artifactId>
                   <version>${mapper.starter.version}</version>
               </dependency>
               <!-- 分页助手启动器 -->
               <dependency>
                   <groupId>com.github.pagehelper</groupId>
                   <artifactId>pagehelper-spring-boot-starter</artifactId>
                   <version>${pageHelper.starter.version}</version>
               </dependency>
               <!-- mysql驱动 -->
               <dependency>
                   <groupId>mysql</groupId>
                   <artifactId>mysql-connector-java</artifactId>
                   <version>${mysql.version}</version>
               </dependency>
               <!--FastDFS客户端-->
               <dependency>
                   <groupId>com.github.tobato</groupId>
                   <artifactId>fastdfs-client</artifactId>
                   <version>${fastDFS.client.version}</version>
               </dependency>
           </dependencies>
       </dependencyManagement>
   
       <build>
           <plugins>
               <plugin>
                   <groupId>org.springframework.boot</groupId>
                   <artifactId>spring-boot-maven-plugin</artifactId>
               </plugin>
           </plugins>
       </build>
   
       
   </project>
   

   可以发现，我们在父工程中引入了 SpringCloud 等，很多以后需要用到的依赖，以后创建的子工程就不需要自己引入了。

5. 删除 src 目录，工程结构如下

   

2.5 创建 Eureka Server

1. 右键 leyou 项目 --> New Module --> Maven --> Next

   

2. 填写项目信息 --> Next

   

3. 填写保存的位置 --> Finish

   

4. 添加依赖

   <?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <parent>
           <artifactId>leyou</artifactId>
           <groupId>com.leyou.parent</groupId>
           <version>1.0-SNAPSHOT</version>
       </parent>
       <modelVersion>4.0.0</modelVersion>
   
       <groupId>com.leyou.registry</groupId>
       <artifactId>leyou-registry</artifactId>
       <version>1.0-SNAPSHOT</version>
   
       <dependencies>
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
           </dependency>
       </dependencies>
   
   
   </project>
   

5. 编写启动类

   @SpringBootApplication
   @EnableEurekaServer
   public class LeyouRegistryApplication {
       public static void main(String[] args) {
           SpringApplication.run(LeyouRegistryApplication.class,args);
       }
   }
   

6. 编写配置文件 application.yaml

   server:
     port: 10086
   spring:
     application:
       name: leyou-registry
   eureka:
     client:
       service-url:
         defaultZone: http://localhost:${server.port}/eureka
       fetch-registry: false
       register-with-eureka: false
     server:
       enable-self-preservation: false
       eviction-interval-timer-in-ms: 5000
   

7. 工程结构如下

   

2.6 创建 Zuul

1. 右键 leyou 项目 --> New Module --> Maven --> Next

   

2. 填写项目信息 --> Next

   

3. 填写保存的位置 --> Finish

   

4. 添加依赖

   <?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <parent>
           <artifactId>leyou</artifactId>
           <groupId>com.leyou.parent</groupId>
           <version>1.0-SNAPSHOT</version>
       </parent>
       <modelVersion>4.0.0</modelVersion>
   
       <groupId>com.leyou.gateway</groupId>
       <artifactId>leyou-gateway</artifactId>
       <version>1.0-SNAPSHOT</version>
   
       <dependencies>
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
           </dependency>
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
           </dependency>
       </dependencies>
   
   
   </project>
   

5. 编写启动类

   @SpringBootApplication
   @EnableZuulProxy
   public class LeyouGatewayApplication {
       public static void main(String[] args) {
           SpringApplication.run(LeyouGatewayApplication.class, args);
       }
   }
   
   

6. 编写配置

   server:
     port: 10010
   spring:
     application:
       name: leyou-gateway
   eureka:
     client:
       service-url:
         defaultZone: http://localhost:10086/eureka
       registry-fetch-interval-seconds: 5
   zuul:
     prefix: /api
   
   

2.7 创建商品微服务

2.7.1 商品微服务的结构

因为与商品的品类相关，我们的工程命名为 leyou-item.

需要注意的是，我们的 leyou-item 是一个微服务，那么将来肯定会有其它系统需要来调用服务中提供的接口，获取的接口数据，也需要对应的实体类来封装，因此肯定也会使用到接口中关联的实体类。

因此这里我们需要使用聚合工程，将要提供的接口及相关实体类放到独立子工程中，以后别人引用的时候，只需要知道坐标即可。

我们会在 leyou-item 中创建两个子工程：

• leyou-item-interface：主要是对外暴露的接口及相关实体类
• leyou-item-service：所有业务逻辑及内部使用接口

调用关系如图所示：

2.7.2 创建 leyou-item

1. 右键 leyou 项目 --> New Module --> Maven --> Next

   

2. 填写项目信息 --> Next

   

3. 填写保存的位置 --> Finish

   

4. 删除 src 目录

2.7.3 创建 leyou-item-interface

1. 右键 leyou-item 项目 --> New Module --> Maven --> Next

   

2. 填写项目信息 --> Next

   

3. 填写保存的位置 --> Finish

   

2.7.4 创建 leyou-item-service

1. 右键 leyou-item 项目 --> New Module --> Maven --> Next

   

2. 填写项目信息 --> Next

   

3. 填写保存的位置 --> Finish

   

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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <parent>
           <artifactId>leyou-item</artifactId>
           <groupId>com.leyou.item</groupId>
           <version>1.0-SNAPSHOT</version>
       </parent>
       <modelVersion>4.0.0</modelVersion>
   
       <groupId>com.leyou.item</groupId>
       <artifactId>leyou-item-service</artifactId>
       <version>1.0-SNAPSHOT</version>
   
       <dependencies>
           <!-- web启动器 -->
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-web</artifactId>
           </dependency>
           <!-- eureka客户端 -->
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
           </dependency>
           <!-- mybatis的启动器 -->
           <dependency>
               <groupId>org.mybatis.spring.boot</groupId>
               <artifactId>mybatis-spring-boot-starter</artifactId>
           </dependency>
           <!-- 通用mapper启动器 -->
           <dependency>
               <groupId>tk.mybatis</groupId>
               <artifactId>mapper-spring-boot-starter</artifactId>
           </dependency>
           <!-- 分页助手启动器 -->
           <dependency>
               <groupId>com.github.pagehelper</groupId>
               <artifactId>pagehelper-spring-boot-starter</artifactId>
           </dependency>
           <!-- jdbc启动器 -->
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-jdbc</artifactId>
           </dependency>
           <!-- mysql驱动 -->
           <dependency>
               <groupId>mysql</groupId>
               <artifactId>mysql-connector-java</artifactId>
           </dependency>
           <!--leyou-item-interface-->
           <dependency>
               <groupId>com.leyou.item</groupId>
               <artifactId>leyou-item-interface</artifactId>
               <version>1.0-SNAPSHOT</version>
           </dependency>
           <!-- springboot检测服务启动器 -->
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter-actuator</artifactId>
           </dependency>
       </dependencies>
   
   
   </project>
   

6. 编写启动类

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

7. 编写配置文件

   server:
     port: 8081
   spring:
     application:
       name: item-service
     datasource:
       url: jdbc:mysql://localhost:3306/leyou
       username: root
       password: zt3742
   eureka:
     client:
       service-url:
         defaultZone: http://localhost:10086/eureka
     instance:
       lease-renewal-interval-in-seconds: 5
       lease-expiration-duration-in-seconds: 10 
   

2.8 添加商品微服务规则

既然商品微服务已经创建，接下来肯定要添加路由规则到 Zuul 中，我们不使用默认的路由规则。

修改 leyou-gateway 工程的 application.yaml 配置文件：

server:
  port: 10010
spring:
  application:
    name: leyou-gateway
eureka:
  client:
    service-url:
      defaultZone: http://localhost:10086/eureka
    registry-fetch-interval-seconds: 5
zuul:
  prefix: /api
  routes:
    item-service: /item/**

2.9 启动测试

1. 我们分别启动：leyou-registry，leyou-gateway，leyou-item-service

2. 打开浏览器，访问下面地址

   http://localhost:10086/
   

   

2.10 测试路由规则

为了测试路由规则是否畅通，我们是不是需要在 item-service 中编写一个 controller 接口呢？

其实不需要，SpringBoot 提供了一个依赖：actuator。只要我们添加了 actuator 的依赖，它就会为我们生成一系列的访问接口：

• /info
• /health
• /refresh

访问 Eureka 控制台：

这就是 actuator 提供的接口，我们点击访问：

因为我们没有添加信息，所以是一个空的 json，但是可以肯定的是：我们能够访问到 item-service 了。

接下来我们通过路由访问试试，根据路由规则，我们需要访问的地址是：

http://localhost:10010/api/item/actuator/info

2.11 创建通用工具模块

有些工具或通用的约定内容，我们希望各个服务共享，因此需要创建一个工具模块：leyou-common

1. 右键 leyou 项目 --> New Module --> Maven --> Next

   

2. 填写项目信息 --> Next

   

3. 填写保存的位置 --> Finish

   

2.12 最终项目结构