乐优商城笔记一：项目搭建

乐优商城项目搭建

---

自学乐优商城笔记

• 环境搭建
• 商品微服务部分业务

基础环境

技术选型

前端：

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

后端：

• SpringMVC、Spring 5.0和MyBatis3
• Spring Boot 2.0.1版本
• Spring Cloud 最新版 Finchley.RC1
• Redis-4.0
• RabbitMQ-3.4
• Elasticsearch-5.6.8
• nginx-1.10.2：
• FastDFS - 5.0.8
• MyCat
• Thymeleaf

开发环境

• IDE：IntelliJ IDEA 2018.3.1
• JDK：jdk1.8.0_121
• 项目构建：maven 3.6.0
• 版本控制：git

访问域名

一级域名：www.leyou.com

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

通过修改hosts文件完成

项目搭建

搭建父工程

1. 创建mvaen项目，不需要骨架
   • GroupId：com.leyou
   • ArifactId：parent
2. 编写pom.xml

<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.0modelVersion>

    <groupId>com.leyougroupId>
    <artifactId>parentartifactId>
    <version>1.0.0-SNAPSHOTversion>

    <parent>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-parentartifactId>
        <version>2.0.1.RELEASEversion>
        <relativePath/> 
    parent>

    <properties>
        <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8project.reporting.outputEncoding>
        <java.version>1.8java.version>
        <spring-cloud.version>Finchley.RC1spring-cloud.version>
        <mybatis.starter.version>1.3.2mybatis.starter.version>
        <mapper.starter.version>2.0.2mapper.starter.version>
        <druid.starter.version>1.1.9druid.starter.version>
        <mysql.version>5.1.32mysql.version>
        <pageHelper.starter.version>1.2.3pageHelper.starter.version>
        <leyou.latest.version>1.0.0-SNAPSHOTleyou.latest.version>
        <fastDFS.client.version>1.26.1-RELEASEfastDFS.client.version>
    properties>

    <dependencyManagement>
        <dependencies>
            
            <dependency>
                <groupId>org.springframework.cloudgroupId>
                <artifactId>spring-cloud-dependenciesartifactId>
                <version>${spring-cloud.version}version>
                <type>pomtype>
                <scope>importscope>
            dependency>
            
            <dependency>
                <groupId>org.mybatis.spring.bootgroupId>
                <artifactId>mybatis-spring-boot-starterartifactId>
                <version>${mybatis.starter.version}version>
            dependency>
            
            <dependency>
                <groupId>tk.mybatisgroupId>
                <artifactId>mapper-spring-boot-starterartifactId>
                <version>${mapper.starter.version}version>
            dependency>
            
            <dependency>
                <groupId>com.github.pagehelpergroupId>
                <artifactId>pagehelper-spring-boot-starterartifactId>
                <version>${pageHelper.starter.version}version>
            dependency>
            
            <dependency>
                <groupId>mysqlgroupId>
                <artifactId>mysql-connector-javaartifactId>
                <version>${mysql.version}version>
            dependency>
            
            <dependency>
                <groupId>com.github.tobatogroupId>
                <artifactId>fastdfs-clientartifactId>
                <version>${fastDFS.client.version}version>
            dependency>
        dependencies>
    dependencyManagement>
    
    <dependencies>
        <dependency>
            <groupId>org.projectlombokgroupId>
            <artifactId>lombokartifactId>
            <version>1.16.20version>
        dependency>
        
        <dependency>
            <groupId>org.apache.commonsgroupId>
            <artifactId>commons-lang3artifactId>
            <version>3.4version>
        dependency>
    dependencies>
    
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.bootgroupId>
                <artifactId>spring-boot-maven-pluginartifactId>
            plugin>
        plugins>
    build>

    <repositories>
        <repository>
            <id>spring-milestonesid>
            <name>Spring Milestonesname>
            <url>https://repo.spring.io/milestoneurl>
            <snapshots>
                <enabled>falseenabled>
            snapshots>
        repository>
    repositories>
project>

父工程主要为依赖管理

搭建微服务注册中心

1. 创建maven项目，制定父工程为com.leyou.parent
   • GroupId：com.leyou.common
   • ArifactId：ly-register
2. 编写pom.xml

<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>parentartifactId>
        <groupId>com.leyougroupId>
        <version>1.0-SNAPSHOTversion>
    parent>
    <modelVersion>4.0.0modelVersion>

    <groupId>com.leyou.commongroupId>
    <artifactId>ly-registerartifactId>
    <version>1.0.0-SNAPSHOTversion>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloudgroupId>
            <artifactId>spring-cloud-starter-netflix-eureka-serverartifactId>
        dependency>
    dependencies>
project>

3. 编写启动类

package com.leyou.register;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer;

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

全类名：com.leyou.register.LyRegister

4. 编写application.yml文件

spring:
  application:
    name: ly-register
server:
  port: 9999
eureka:
  client:
    fetch-registry: false
    register-with-eureka: false
    service-url:
      defaultZone: http://127.0.0.1:${server.port}/eureka
  server:
    enable-self-preservation: false # 关闭自我保护
    eviction-interval-timer-in-ms: 5000 # 每隔5秒进行一次服务列表清理

搭建微服务网关

1. 创建maven项目
   • GroupId：com.leyou.common
   • ArifactId：ly-gateway
2. 编写pom.xml

<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>parentartifactId>
        <groupId>com.leyougroupId>
        <version>1.0-SNAPSHOTversion>
    parent>
    <modelVersion>4.0.0modelVersion>
    <version>1.0.0-SNAPSHOTversion>
    <groupId>com.leyou.commongroupId>
    <artifactId>ly-gatewayartifactId>

    <dependencies>
        <dependency>
            <groupId>org.springframework.cloudgroupId>
            <artifactId>spring-cloud-starter-netflix-zuulartifactId>
        dependency>
        <dependency>
            <groupId>org.springframework.cloudgroupId>
            <artifactId>spring-cloud-starter-netflix-eureka-clientartifactId>
        dependency>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-actuatorartifactId>
        dependency>
    dependencies>
project>

3. 编写启动类

package com.leyou;

import org.springframework.boot.SpringApplication;
import org.springframework.cloud.client.SpringCloudApplication;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;

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

全类名：com.leyou.gateway.LyGateway

4. 编写application.yml

server:
  port: 10001
spring:
  application:
    name: api-gateway
eureka:
  client:
    service-url:
      defaultZone: http://127.0.0.1:9999/eureka
zuul:
  prefix: /api # 添加路由前缀
ribbon:
  ConnectTimeout: 1000 # 连接超时时间(ms)
  ReadTimeout: 3500 # 通信超时时间(ms)
  MaxAutoRetriesNextServer: 0 # 同一服务不同实例的重试次数
  MaxAutoRetries: 0 # 同一实例的重试次数
hystrix:
  command:
    default:
      execution:
        isolation:
          thread:
            timeoutInMillisecond: 9999 # 熔断超时时长：10000ms

商品微服务搭建

商品微服务结构

也采用父子结构

• ly-item（父工程）
  • ly-item-interface：主要内容为实体类和接口
  • ly-item-service：主要内容为业务逻辑

创建商品微服务父工程

1. 创建maven项目，其父工程为ly-parent
   • GroupId：com.leyou.service
   • ArifactId：ly-item
2. 修改pom.xml中的打包方式为pom

<packaging>pompackaging>

创建商品微服务-interface

1. 创建maven项目，其父工程为：ly-item
   • GroupId：com.leyou.service
   • ArifactId：ly-item-interface

创建商品微服务-service

1. 创建maven项目
   • GroupId：com.leyou.service
   • ArifactId：ly-item-service
2. 编写pom.xml

<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>ly-itemartifactId>
        <groupId>com.leyou.servicegroupId>
        <version>1.0.0-SNAPSHOTversion>
    parent>
    <modelVersion>4.0.0modelVersion>

    <groupId>com.leyou.servicegroupId>
    <artifactId>ly-item-serviceartifactId>
    <version>1.0.0-SNAPSHOTversion>
    <dependencies>
        
        <dependency>
            <groupId>org.springframework.cloudgroupId>
            <artifactId>spring-cloud-starter-netflix-eureka-clientartifactId>
        dependency>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-webartifactId>
        dependency>
        
        <dependency>
            <groupId>org.mybatis.spring.bootgroupId>
            <artifactId>mybatis-spring-boot-starterartifactId>
            <version>${mybatis.starter.version}version>
        dependency>
        
        <dependency>
            <groupId>tk.mybatisgroupId>
            <artifactId>mapper-spring-boot-starterartifactId>
            <version>${mapper.starter.version}version>
        dependency>
        
        <dependency>
            <groupId>com.github.pagehelpergroupId>
            <artifactId>pagehelper-spring-boot-starterartifactId>
            <version>${pageHelper.starter.version}version>
        dependency>
        
        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>${mysql.version}version>
        dependency>
        <dependency>
            <groupId>com.leyou.servicegroupId>
            <artifactId>ly-item-interfaceartifactId>
            <version>${leyou.latest.version}version>
        dependency>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-actuatorartifactId>
        dependency>
    dependencies>
project>

3. 编写启动类

package com.leyou.service;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

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

4. 编写application.yml

server:
  port: 8001
spring:
  application:
    name: item-service
  datasource:
    url: jdbc:mysql://localhost:3306/leyou
    username: root
    password: 123456
    hikari:
      maximum-pool-size: 30
      minimum-idle: 10
eureka:
  client:
    service-url:
      defaultZone: http://127.0.0.1:99990/eureka

5. 配置网关路由

启动测试

启动

查看注册中心

搭建通用微服务

主要包含：工具类，通用异常处理，通用bean

创建项目

1. 创建maven项目
   • GroupId：com.leyou.common
   • ArifactId：ly-common

工具类

将准备好的工具类放入该项目中，也可以在要使用时再添加。

通用异常处理

1. 新建异常信息枚举类

package com.leyou.common.enums;


import lombok.AllArgsConstructor;
import lombok.Getter;

@Getter
@AllArgsConstructor
public enum LyExceptionEnum {

    PARAM_CANNOT_BE_NULL(400, "参数不能为空")
    ;
    private int code;
    private String message;
}

2. 新建自定义异常类

package com.leyou.common.exception;

import com.leyou.common.enums.LyExceptionEnum;
import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;

@Getter
@AllArgsConstructor
@NoArgsConstructor
public class LyException extends RuntimeException {
    private LyExceptionEnum lyExceptionEnum;
}

3. 新建自定义异常VO

package com.leyou.common.vo;

import com.leyou.common.enums.LyExceptionEnum;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class LyExceptionResult {
    private int status;
    private String message;
    private long timestamp;

    public LyExceptionResult(LyExceptionEnum lyExceptionEnum) {
        this.status = lyExceptionEnum.getCode();
        this.message = lyExceptionEnum.getMessage();
        this.timestamp = System.currentTimeMillis();
    }
}

4. 编写通用异常处理器

package com.leyou.common.exception;

import com.leyou.common.vo.LyExceptionResult;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

@ControllerAdvice
public class LyExceptionHandler {

    @ExceptionHandler(LyException.class)
    public ResponseEntity<LyExceptionResult> commonExceptionHandler(LyException e) {
        return ResponseEntity.status(e.getLyExceptionEnum().getCode())
                .body(new LyExceptionResult(e.getLyExceptionEnum()));
    }
}

5. 编写测试

   1. 在item-service中定义controller类

   package com.leyou.item.web;
   
   import com.leyou.common.enums.LyExceptionEnum;
   import com.leyou.common.exception.LyException;
   import org.apache.commons.lang3.StringUtils;
   import org.springframework.http.ResponseEntity;
   import org.springframework.web.bind.annotation.PathVariable;
   import org.springframework.web.bind.annotation.PostMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @RestController
   public class TestExceptionHandlerController {
       
       @PostMapping("/test/{msg}")
       public ResponseEntity<String> test(@PathVariable("msg")String msg) {
           if (StringUtils.isBlank(msg)) {
               // 注意在pom文件中引入ly-common的依赖
               throw new LyException(LyExceptionEnum.PARAM_CANNOT_BE_NULL);
           }
           return ResponseEntity.ok(msg);
       }
   }
   

   2. 测试结果

      • 正常传递参数

      

      • 错误传递参数