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

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 域名

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

一级域名：leyou.com

二级域名：www.leyou.com , api.leyou.com

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

2.4 创建父工程

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

Create New Project --> Maven --> Next

填写项目信息 --> Next

填写保存的位置 --> Finish

添加依赖

    4.0.0

    com.leyou.parent
    leyou
    pom
    1.0-SNAPSHOT

    leyou
    Demo project for Spring Boot

    
        org.springframework.boot
        spring-boot-starter-parent
        2.2.4.RELEASE
         
    

    
        UTF-8
        UTF-8
        1.8
        Hoxton.SR1
        1.3.2
        2.0.2
        1.1.9
        5.1.32
        1.2.3
        1.0.0-SNAPSHOT
        1.26.1-RELEASE
    

    
        
            
            
                org.springframework.cloud
                spring-cloud-dependencies
                ${spring-cloud.version}
                pom
                import
            
            
            
                org.mybatis.spring.boot
                mybatis-spring-boot-starter
                ${mybatis.starter.version}
            
            
            
                tk.mybatis
                mapper-spring-boot-starter
                ${mapper.starter.version}
            
            
            
                com.github.pagehelper
                pagehelper-spring-boot-starter
                ${pageHelper.starter.version}
            
            
            
                mysql
                mysql-connector-java
                ${mysql.version}
            
            
            
                com.github.tobato
                fastdfs-client
                ${fastDFS.client.version}
            
        
    

    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

    

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

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

2.5 创建 Eureka Server

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

填写项目信息 --> Next

填写保存的位置 --> Finish

添加依赖

    
        leyou
        com.leyou.parent
        1.0-SNAPSHOT
    
    4.0.0

    com.leyou.registry
    leyou-registry
    1.0-SNAPSHOT

    
        
            org.springframework.cloud
            spring-cloud-starter-netflix-eureka-server
        
    

编写启动类

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

编写配置文件 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

工程结构如下

2.6 创建 Zuul

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

填写项目信息 --> Next

填写保存的位置 --> Finish

添加依赖

    
        leyou
        com.leyou.parent
        1.0-SNAPSHOT
    
    4.0.0

    com.leyou.gateway
    leyou-gateway
    1.0-SNAPSHOT

    
        
            org.springframework.cloud
            spring-cloud-starter-netflix-zuul
        
        
            org.springframework.cloud
            spring-cloud-starter-netflix-eureka-client
        
    

编写启动类

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

编写配置

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

填写项目信息 --> Next

填写保存的位置 --> Finish

删除 src 目录

2.7.3 创建 leyou-item-interface

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

填写项目信息 --> Next

填写保存的位置 --> Finish

2.7.4 创建 leyou-item-service

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

填写项目信息 --> Next

填写保存的位置 --> Finish

项目结构如下

添加依赖

    
        leyou-item
        com.leyou.item
        1.0-SNAPSHOT
    
    4.0.0

    com.leyou.item
    leyou-item-service
    1.0-SNAPSHOT

    
        
        
            org.springframework.boot
            spring-boot-starter-web
        
        
        
            org.springframework.cloud
            spring-cloud-starter-netflix-eureka-client
        
        
        
            org.mybatis.spring.boot
            mybatis-spring-boot-starter
        
        
        
            tk.mybatis
            mapper-spring-boot-starter
        
        
        
            com.github.pagehelper
            pagehelper-spring-boot-starter
        
        
        
            org.springframework.boot
            spring-boot-starter-jdbc
        
        
        
            mysql
            mysql-connector-java
        
        
        
            com.leyou.item
            leyou-item-interface
            1.0-SNAPSHOT
        
        
        
            org.springframework.boot
            spring-boot-starter-actuator
        
    

编写启动类

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

编写配置文件

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 
mybatis:
 type-aliases-package: com.leyou.item.pojo

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. 打开浏览器，访问下面地址

2.10 测试路由规则

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

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

• /info
• /health
• /refresh

访问 Eureka 控制台：

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

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

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

2.11 创建通用工具模块

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

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

填写项目信息 --> Next

填写保存的位置 --> Finish

2.12 最终项目结构