Mr. Cappuccino的第11杯咖啡——冒泡APP(升级版)之项目初始化

前言:心血来潮,打算将大学期间做的一些项目进行整合升级改造,出来工作已经将近两年了,现在每天的生活无一不是在为公司的事业奋斗着,殊不知自己对于这一行业的兴趣也正在慢慢地被消磨着。在大学期间,对这行业的兴趣十分浓厚,那时候自己就是整个项目的项目经理兼产品经理,完全可以去做着自己想要做的事情,而且通过自己的努力把整个项目给捣鼓起来了,那绝对是一件非常有成就感的事儿,在我看来这些就是让兴趣之火得以燃烧的主要原因。希望通过这个项目能让自己找到之前的那份初心与热爱,这个项目我会一直迭代下去的。加油!一起进步!一起成长!

话不多说,咱们先看一下之前写的那些项目。

  1. 冒泡交友APP:这是大二期间模仿QQ写的一款聊天交友的APP。主要使用了SpringBoot、Mybatis、MySQL等技术。
    项目结构:
    在这里插入图片描述
  2. 钟意日记APP:这是去年上半年送给女朋友的一份礼物,主要是为了彼此之间能够更加方便的交换日记进行阅读而开发的一款应用。
    在这里插入图片描述
    可见这两款应用都是非常传统的单体项目,技术栈偏于老旧,准备此次对它进行升级改造。

在写这篇博文之前,项目结构以及项目启动的一些问题已经得以解决,这篇博文主要用于记录分享。


1. 整体项目结构

在这里插入图片描述


2. 创建父工程(bubble-parent):进行版本控制

当前项目是基于JDK11+spring-cloud:2020.0.1+spring-cloud-alibaba:2021.1+spring-boot:2.4.2进行搭建。
在这里插入图片描述
pom.xml

<?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.bubble</groupId>
    <artifactId>bubble-parent</artifactId>
    <version>1.0-RELEASE</version>

    <packaging>pom</packaging>

    <properties>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <boot.version>2.4.2</boot.version>
        <mybatis.plus.starter.version>3.4.1</mybatis.plus.starter.version>
        <swagger.starter.version>1.7.0.RELEASE</swagger.starter.version>
        <cloud.version>2020.0.1</cloud.version>
        <cloud.alibaba.version>2021.1</cloud.alibaba.version>
    </properties>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.2</version>
        <relativePath/>
    </parent>

    <dependencies>
        <!-- lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
        <!-- commons-lang3 -->
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
        </dependency>
        <!-- 解决最新版cloud bootstrap.yml不生效的问题 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-bootstrap</artifactId>
        </dependency>
        <!-- 解决网关无法转发的问题 503 Service Unavailable -->
        <!-- 解决OpenFeign无法远程调用的问题 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-loadbalancer</artifactId>
        </dependency>
    </dependencies>

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

    <!-- 解决 spring-boot jar 包下载问题 -->
    <repositories>
        <repository>
            <id>spring-snapshots</id>
            <url>https://repo.spring.io/libs-snapshot</url>
        </repository>
    </repositories>
    <pluginRepositories>
        <pluginRepository>
            <id>spring-snapshots</id>
            <url>https://repo.spring.io/libs-snapshot</url>
        </pluginRepository>
    </pluginRepositories>

</project>

版本组合关系
在这里插入图片描述


3. 创建公共依赖工程(bubble-common-lib):管理公共依赖

在这里插入图片描述
pom.xml

<?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>bubble-common</artifactId>
        <groupId>com.bubble</groupId>
        <version>1.0-RELEASE</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>bubble-common-lib</artifactId>

    <packaging>jar</packaging>

    <dependencies>
        <!-- springboot-web -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!-- mybatis-plus -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>${mybatis.plus.starter.version}</version>
        </dependency>
        <!-- mysql -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <!-- swagger -->
        <dependency>
            <groupId>com.spring4all</groupId>
            <artifactId>swagger-spring-boot-starter</artifactId>
            <version>${swagger.starter.version}</version>
        </dependency>
        <!-- nacos -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>
        <!-- nacos-config -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>
        <!-- openfeign -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>
        <!-- 解决jdk11启动异常 Spring BeanCreationException "xmlModelPlugin" -->
        <dependency>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
        </dependency>
        <!-- spring-boot 2.3.0.RELEASE 没有自动引入validation对应的包 -->
        <!-- java.lang.NoClassDefFoundError: javax/validation/constraints/Min -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-validation</artifactId>
        </dependency>
    </dependencies>

</project>

其中:bubble-common-base用于封装统一返回格式、bubble-common-cache用于封装缓存工具类(如redis)、bubble-common-core用于封装常用工具类(如MD5Util、SpringContextUtil)、bubble-common-log用于封装统一日志输出。


4. 创建会员服务(bubble-member):管理用户信息

在这里插入图片描述

boostrap.yml(配置注册中心、配置中心)

server:
  port: 8070
spring:
  application:
    name: bubble-member
  cloud:
    nacos:
      discovery:
        server-addr: X.X.X.X:8848
      # 分布式配置中心相关配置
      config:
        server-addr: X.X.X.X:8848
        file-extension: yml
  # 指定版本
  profiles:
    active: dev

application.yml(配置Swagger、数据库连接、Redis连接)

# swagger相关配置
swagger:
  base-package: com.bubble.member.service.impl
  title: 冒泡APP-会员服务接口
  description: 冒泡APP
  version: 1.1
  terms-of-service-url: https://honeyyxk.com
  contact:
    name: 袁小康
    email: honeyyxk@163.com
    url: https://honeyyxk.com
  enabled: true

# 数据库相关配置
spring:
  datasource:
    username: honey
    password: honey@163
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://X.X.X.X.com:3306/bubble_member?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
  redis:
    host: X.X.X.X.com
    password: honey@163
    port: 6379
    database: 0

AppMember.java(启动类,开启Swagger)

package com.bubble.member;

import com.spring4all.swagger.EnableSwagger2Doc;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * @author honey
 * @date 2021-09-07 12:55:09
 */
@EnableSwagger2Doc
@SpringBootApplication
public class AppMember {

    public static void main(String[] args) {
        SpringApplication.run(AppMember.class);
    }
}

bubble-member模块pom.xml(引入父工程及公共依赖)

<?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>

    <artifactId>bubble-member</artifactId>
    <packaging>pom</packaging>
    <version>1.0-RELEASE</version>
    <modules>
        <module>bubble-member-service</module>
        <module>bubble-member-api</module>
    </modules>

    <parent>
        <groupId>com.bubble</groupId>
        <artifactId>bubble-parent</artifactId>
        <version>1.0-RELEASE</version>
    </parent>
    <dependencies>
        <dependency>
            <groupId>com.bubble</groupId>
            <artifactId>bubble-common-lib</artifactId>
            <version>1.0-RELEASE</version>
        </dependency>
    </dependencies>

</project>

bubble-member-api模块pom.xml

<?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>bubble-member</artifactId>
        <groupId>com.bubble</groupId>
        <version>1.0-RELEASE</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>bubble-member-api</artifactId>

    <packaging>jar</packaging>

</project>

bubble-member-service模块pom.xml

<?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>bubble-member</artifactId>
        <groupId>com.bubble</groupId>
        <version>1.0-RELEASE</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>bubble-member-service</artifactId>

    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>com.bubble</groupId>
            <artifactId>bubble-member-api</artifactId>
            <version>1.0-RELEASE</version>
        </dependency>
    </dependencies>

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

</project>

5. 创建日记服务(bubble-diary):管理日记信息

在这里插入图片描述

boostrap.yml(配置注册中心、配置中心)

server:
  port: 8060
spring:
  application:
    name: bubble-diary
  cloud:
    nacos:
      discovery:
        server-addr: X.X.X.X:8848
      # 分布式配置中心相关配置
      config:
        server-addr: X.X.X.X:8848
        file-extension: yml
  # 指定版本
  profiles:
    active: dev

application.yml(配置Swagger、数据库连接、Redis连接)

# swagger相关配置
swagger:
  base-package: com.bubble.diary.service.impl
  title: 冒泡APP-日记服务接口
  description: 冒泡APP
  version: 1.1
  terms-of-service-url: https://honeyyxk.com
  contact:
    name: 袁小康
    email: honeyyxk@163.com
    url: https://honeyyxk.com
  enabled: true

# 数据库相关配置
spring:
  datasource:
    username: honey
    password: honey@163
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://X.X.X.X.com:3306/bubble_diary?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
  redis:
    host: X.X.X.X.com
    password: honey@163
    port: 6379
    database: 1

AppDiary.java(启动类,开启Swagger、Feign客户端)

package com.bubble.diary;

import com.spring4all.swagger.EnableSwagger2Doc;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.openfeign.EnableFeignClients;

/**
 * @author honey
 * @date 2021-09-07 23:15:09
 */
@EnableFeignClients
@EnableSwagger2Doc
@SpringBootApplication
public class AppDiary {

    public static void main(String[] args) {
        SpringApplication.run(AppDiary.class);
    }
}

bubble-diary模块pom.xml(引入父工程及公共依赖)

<?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>

    <artifactId>bubble-diary</artifactId>
    <packaging>pom</packaging>
    <version>1.0-RELEASE</version>
    <modules>
        <module>bubble-diary-api</module>
        <module>bubble-diary-service</module>
    </modules>

    <parent>
        <groupId>com.bubble</groupId>
        <artifactId>bubble-parent</artifactId>
        <version>1.0-RELEASE</version>
    </parent>
    <dependencies>
        <dependency>
            <groupId>com.bubble</groupId>
            <artifactId>bubble-common-lib</artifactId>
            <version>1.0-RELEASE</version>
        </dependency>
    </dependencies>

</project>

bubble-diary-api模块pom.xml

<?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>bubble-diary</artifactId>
        <groupId>com.bubble</groupId>
        <version>1.0-RELEASE</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>bubble-diary-api</artifactId>

    <packaging>jar</packaging>

</project>

bubble-diary-service模块pom.xml

<?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>bubble-diary</artifactId>
        <groupId>com.bubble</groupId>
        <version>1.0-RELEASE</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>bubble-diary-service</artifactId>

    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>com.bubble</groupId>
            <artifactId>bubble-diary-api</artifactId>
            <version>1.0-RELEASE</version>
        </dependency>
    </dependencies>

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

</project>

6. 搭建网关(bubble-gateway):项目统一入口

在这里插入图片描述
pom.xml

<?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>

    <artifactId>bubble-gateway</artifactId>
    <version>1.0-RELEASE</version>

    <packaging>jar</packaging>

    <parent>
        <groupId>com.bubble</groupId>
        <artifactId>bubble-parent</artifactId>
        <version>1.0-RELEASE</version>
    </parent>
    <dependencies>
        <!-- gateway -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-gateway</artifactId>
        </dependency>
        <!-- swagger -->
        <dependency>
            <groupId>com.spring4all</groupId>
            <artifactId>swagger-spring-boot-starter</artifactId>
            <version>${swagger.starter.version}</version>
        </dependency>
        <!-- nacos -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>
    </dependencies>

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

</project>

boostrap.yml(配置注册中心、转发路由)

server:
  port: 81
spring:
  application:
    name: bubble-gateway
  cloud:
    gateway:
      routes:
        - id: member
          uri: lb://bubble-member
          predicates:
            - Path=/bubble-member/**
          filters:
            - SwaggerHeaderFilter
            - StripPrefix=1
        - id: diary
          uri: lb://bubble-diary
          predicates:
            - Path=/bubble-diary/**
          filters:
            - SwaggerHeaderFilter
            - StripPrefix=1
      x-forwarded:
        enabled: false
    nacos:
      discovery:
        server-addr: X.X.X.X:8848

AppGateway.java

package com.bubble.gateway;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * @author honey
 * @date 2021-09-07 12:55:09
 */
@SpringBootApplication
public class AppGateway {

    public static void main(String[] args) {
        SpringApplication.run(AppGateway.class);
    }
}


7. 项目启动时遇到的一些问题

Error creating bean with name 'xmlModelPlugin’

解决方案:引入jaxb-api依赖

<!-- 解决jdk11启动异常 Spring BeanCreationException "xmlModelPlugin" -->
<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
</dependency>

java.lang.NoClassDefFoundError: javax/validation/constraints/Min

解决方案:引入validation依赖

<!-- spring-boot 2.3.0.RELEASE 没有自动引入validation对应的包 -->
<!-- java.lang.NoClassDefFoundError: javax/validation/constraints/Min -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

SpringCloud 2020.x.x工程bootstrap引导配置不生效

解决方案:引入boostrap依赖

<!-- 解决最新版cloud bootstrap.yml不生效的问题 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

网关无法转发/OpenFeign无法远程调用

解决方案:引入loadbalancer依赖

<!-- 解决网关无法转发的问题 503 Service Unavailable -->
<!-- 解决OpenFeign无法远程调用的问题 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-loadbalancer</artifactId>
</dependency>

8. 测试集成功能点

注册中心
在这里插入图片描述
如何集成?

  1. 引入nacos-discovery的依赖;
  2. boostrap.yml配置注册中心地址;

配置中心

在会员服务进行功能点测试,新增测试接口用于测试

MemberService.java

package com.bubble.member.service;

import io.swagger.annotations.*;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * @author honey
 * @date 2021-09-07 12:55:09
 */
@Api(tags = "会员信息服务接口")
@RequestMapping(value = "/member")
public interface MemberService {

    /**
     * 根据令牌查询用户基本信息接口
     *
     * @param loginToken 登录令牌
     * @return String
     */
    @GetMapping(value = "/getUserInfo")
    @ApiOperation("根据令牌查询用户基本信息接口")
    @ApiImplicitParam(name = "loginToken", value = "登录令牌", required = true)
    @ApiResponses({@ApiResponse(code = 200, message = "成功"), @ApiResponse(code = 500, message = "失败")})
    String getUserInfo(String loginToken);
}

MemberServiceImpl.java

package com.bubble.member.service.impl;

import com.bubble.member.service.MemberService;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author honey
 * @date 2021-09-07 12:55:09
 */
@RestController
public class MemberServiceImpl implements MemberService {

    @Value("${test}")
    private String test;

    @Override
    public String getUserInfo(String loginToken) {
        return "信息" + test;
    }
}

nacos新增配置文件
在这里插入图片描述
请求接口能达到预期则说明集成成功
在这里插入图片描述

如何集成?

  1. 引入nacos-config依赖
  2. boostrap.yml配置配置中心地址;

注意:nacos新增配置文件名称bubble-member-dev.yml需要和boostrap.yml中的配置保持一致。

openfeign

在日记服务进行功能点测试,新增测试接口用于测试

DiaryService.java

package com.bubble.diary.service;

import io.swagger.annotations.*;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * @author honey
 * @date 2021-09-07 12:55:09
 */
@Api(tags = "日记信息服务接口")
@RequestMapping(value = "/diary")
public interface DiaryService {

    /**
     * 根据令牌查询日记基本信息接口
     *
     * @param loginToken 登录令牌
     * @return String
     */
    @GetMapping(value = "/getDiaryInfo")
    @ApiOperation("根据令牌查询日记基本信息接口")
    @ApiImplicitParam(name = "loginToken", value = "登录令牌", required = true)
    @ApiResponses({@ApiResponse(code = 200, message = "成功"), @ApiResponse(code = 500, message = "失败")})
    String getDiaryInfo(String loginToken);
}

DiaryServiceImpl.java

package com.bubble.diary.service.impl;

import com.bubble.diary.feign.MemberFeignService;
import com.bubble.diary.service.DiaryService;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.Resource;

/**
 * @author honey
 * @date 2021-09-07 23:15:09
 */
@RestController
public class DiaryServiceImpl implements DiaryService {

    @Resource
    private MemberFeignService memberFeignService;

    @Override
    public String getDiaryInfo(String loginToken) {
        return memberFeignService.getUserInfo(loginToken);
    }
}

MemberFeignService.java

package com.bubble.diary.feign;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * @author honey
 * @date 2021-09-07 23:15:09
 */
@FeignClient(name = "bubble-member", path = "/member")
public interface MemberFeignService {

    /**
     * 获取用户信息
     *
     * @param loginToken 令牌
     * @return String
     */
    @GetMapping(value = "/getUserInfo")
    String getUserInfo(@RequestParam("loginToken") String loginToken);
}

请求接口能达到预期则说明集成成功
在这里插入图片描述

如何集成?

  1. 引入openfeign、loadbalancer依赖;
  2. 启动类开启Feign客户端,加上@EnableFeignClients;
  3. 调用类加上@FeignClient(name = “bubble-member”, path = “/member”)

网关转发

请求接口能达到预期则说明集成成功
在这里插入图片描述

如何集成?

  1. 引入gateway、loadbalancer依赖;
  2. boostrap.yml配置转发路由;

网关swagger统一入口

请求网关整合的swagger页面,能实现服务之间来回切换并成功请求服务的接口则说明集成成功
在这里插入图片描述

如何集成?

新增swagger配置类
在这里插入图片描述

SwaggerProvider.java

package com.bubble.gateway.swagger.config;

import lombok.AllArgsConstructor;
import org.springframework.cloud.gateway.config.GatewayProperties;
import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.support.NameUtils;
import org.springframework.context.annotation.Primary;
import org.springframework.stereotype.Component;
import springfox.documentation.swagger.web.SwaggerResource;
import springfox.documentation.swagger.web.SwaggerResourcesProvider;

import java.util.ArrayList;
import java.util.List;

/**
 * @author honey
 * @date 2021-09-07 12:55:09
 */
@Component
@Primary
@AllArgsConstructor
public class SwaggerProvider implements SwaggerResourcesProvider {

    public static final String API_URI = "/v2/api-docs";
    private final RouteLocator routeLocator;
    private final GatewayProperties gatewayProperties;


    @Override
    public List<SwaggerResource> get() {
        List<SwaggerResource> resources = new ArrayList<>();
        List<String> routes = new ArrayList<>();
        routeLocator.getRoutes().subscribe(route -> routes.add(route.getId()));
        gatewayProperties.getRoutes().stream().filter(routeDefinition -> routes.contains(routeDefinition.getId()))
                .forEach(routeDefinition -> routeDefinition.getPredicates().stream()
                        .filter(predicateDefinition -> ("Path").equalsIgnoreCase(predicateDefinition.getName()))
                        .forEach(predicateDefinition -> resources.add(swaggerResource(routeDefinition.getId(),
                                predicateDefinition.getArgs().get(NameUtils.GENERATED_NAME_PREFIX + "0")
                                        .replace("/**", API_URI)))));
        return resources;
    }

    private SwaggerResource swaggerResource(String name, String location) {
        SwaggerResource swaggerResource = new SwaggerResource();
        swaggerResource.setName(name);
        swaggerResource.setLocation(location);
        swaggerResource.setSwaggerVersion("2.0");
        return swaggerResource;
    }
}

SwaggerHeaderFilter.java

package com.bubble.gateway.swagger.filter;

import com.bubble.gateway.swagger.config.SwaggerProvider;
import org.apache.commons.lang3.StringUtils;
import org.springframework.cloud.gateway.filter.GatewayFilter;
import org.springframework.cloud.gateway.filter.factory.AbstractGatewayFilterFactory;
import org.springframework.http.server.reactive.ServerHttpRequest;
import org.springframework.stereotype.Component;
import org.springframework.web.server.ServerWebExchange;

/**
 * @author honey
 * @date 2021-09-07 12:55:09
 */
@Component
public class SwaggerHeaderFilter extends AbstractGatewayFilterFactory<Object> {

    private static final String HEADER_NAME = "X-Forwarded-Prefix";

    @Override
    public GatewayFilter apply(Object config) {
        return (exchange, chain) -> {
            ServerHttpRequest request = exchange.getRequest();
            String path = request.getURI().getPath();
            if (!StringUtils.endsWithIgnoreCase(path, SwaggerProvider.API_URI)) {
                return chain.filter(exchange);
            }
            String basePath = path.substring(0, path.lastIndexOf(SwaggerProvider.API_URI));
            ServerHttpRequest newRequest = request.mutate().header(HEADER_NAME, basePath).build();
            ServerWebExchange newExchange = exchange.mutate().request(newRequest).build();
            return chain.filter(newExchange);
        };
    }
}

SwaggerHandler.java

package com.bubble.gateway.swagger.handler;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import reactor.core.publisher.Mono;
import springfox.documentation.swagger.web.*;

import java.util.Optional;

/**
 * @author honey
 * @date 2021-09-07 12:55:09
 */
@RestController
@RequestMapping("/swagger-resources")
public class SwaggerHandler {


    private SecurityConfiguration securityConfiguration;

    private UiConfiguration uiConfiguration;

    private final SwaggerResourcesProvider swaggerResources;

    @Autowired
    public SwaggerHandler(SwaggerResourcesProvider swaggerResources) {
        this.swaggerResources = swaggerResources;
    }


    @GetMapping("/configuration/security")
    public Mono<ResponseEntity<SecurityConfiguration>> securityConfiguration() {
        return Mono.just(new ResponseEntity<>(Optional.ofNullable(securityConfiguration).orElse(SecurityConfigurationBuilder.builder().build()), HttpStatus.OK));
    }

    @GetMapping("/configuration/ui")
    public Mono<ResponseEntity<UiConfiguration>> uiConfiguration() {
        return Mono.just(new ResponseEntity<>(Optional.ofNullable(uiConfiguration).orElse(UiConfigurationBuilder.builder().build()), HttpStatus.OK));
    }

    @GetMapping("")
    public Mono<ResponseEntity<Object>> swaggerResources() {
        return Mono.just((new ResponseEntity<>(swaggerResources.get(), HttpStatus.OK)));
    }
}

注意:boostrap.yml文件中需要加入配置点
在这里插入图片描述

好啦,到这里项目初始化就已经结束啦,小伙伴们有什么疑问可以咨询小主哟

逆境总是有的,人生总要进击。愿你不要屈从于命运的安排,坚韧不拔,锲而不舍!做永远的生活强者!

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值