SpringCloud系列之四---Zuul网关整合Swaagger2管理API

前言

本篇文章主要介绍的是Zuul网关整合Swaagger2管理API。

实现过程需要先创建eureka服务端，再创建多个微服务项目，每个微服务项目整合swagger2，形成接口文档，并且每个微服务需要注册到eureka注册中心。再创建zuul网关对所有的swagger进行管理,zuul网关也需要作为eureka客户端注册到注册中心。

GitHub源码链接位于文章底部。

1.eureka服务端

首先创建eureka注册中心，因为这只是一个注册中心，所以只需要引入eureka服务端jar即可。

1.1 pom依赖
<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
    </dependency>
</dependencies>

1.2 配置文件

生产环境中需要开启自我保护机制，删除eureka.server

server:
  port: 8100

spring:
  application:
    name: eureka-server

#eureka基本配置信息
eureka:
  client:
    service-url:
      #Eureka 客户端与 Eureka 服务端进行交互的地址
      defaultZone: http://127.0.0.1:${server.port}/eureka
    #是否将自己注册到Eureka服务中,本身就是注册中心所以无需注册
    register-with-eureka: false
    #是否从Eureka中检索注册信息,本身就是注册中心所以无需检索
    fetch-registry: false
  server:
    # 测试时关闭自我保护机制，保证不可用服务及时踢出
    enable-self-preservation: false
    ##剔除失效服务间隔
    eviction-interval-timer-in-ms: 2000
1.3 启动类

在方法上添加eureka服务端注解EnableEurekaServer。

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

启动以后访问 127.0.0.1:8100 即可打开eureka注册中心可视化界面。

2.创建用户服务和邮件服务两个项目

创建用户服务和邮件服务两个项目，这两个服务需要作为eureka客户端，注册到eureka注册中心，两个服务都需要整合swagger2，用户服务需要使用Feign调用邮件服务。

2.1邮件服务引入依赖

邮件服务作为eureka客户端，以及需要整合swagger2，因此只需要引入两个依赖

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>
    <dependency>
        <groupId>com.spring4all</groupId>
        <artifactId>swagger-spring-boot-starter</artifactId>
        <version>1.7.0.RELEASE</version>
    </dependency>
</dependencies>
2.2邮件服务配置文件

配置文件包括配置端口、应用名、eureka客户端信息、swagger配置信息，需要注意swagger配置了controller层所在的包，它会检测包中swagger相关注解。

server:
  port: 8200

spring:
  application:
    name: app-email

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8100/eureka
  server:
    # 测试时关闭自我保护机制，保证不可用服务及时踢出
    enable-self-preservation: false
    ##剔除失效服务间隔
    eviction-interval-timer-in-ms: 2000

####swagger相关配置
swagger:
  base-package: com.lxg.controller
  title: SpringCloud2.x构建微服务项目-邮件服务接口
  description: 邮件有关的服务
  version: 1.1
  terms-of-service-url: www.lxgblog.com
  contact:
    name: 李先国
    email: [email protected]
2.3 邮件服务controller层

在邮件服务中写一个获取邮件信息的Get接口，Api(tags = "邮件微服务")是swagger的注解，它为controller命名，swagger其他注解见另一篇文章https://www.lxgblog.com/article/1576055897

@RestController
@Api(tags = "邮件微服务")
public class EmailController {
    @GetMapping("/email")
    public String email() {
        return "[email protected]";
    }
}
2.4 邮件服务启动类

EnableSwagger2Doc注解开启swagger，EnableEurekaClient启动eureka客户端

@SpringBootApplication
@EnableSwagger2Doc
@EnableEurekaClient
public class EmailApp {
    public static void main(String[] args) {
        SpringApplication.run(EmailApp.class,args);
    }
}
2.5 用户服务引入依赖

用户服务作为eureka客户端，需要整合swagger2，并且它需要通过Feign远程调用邮件服务，所以是三个依赖。

    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>
        <dependency>
            <groupId>com.spring4all</groupId>
            <artifactId>swagger-spring-boot-starter</artifactId>
            <version>1.7.0.RELEASE</version>
        </dependency>
    </dependencies>
2.6 用户服务配置文件

配置文件包括配置端口、应用名、eureka客户端信息、swagger配置信息，需要注意swagger配置了controller层所在的包，它会检测包中swagger相关注解。

server:
  port: 8300

spring:
  application:
    name: app-user

eureka:
  client:
    service-url:
      defaultZone: http://localhost:8100/eureka
  server:
    # 测试时关闭自我保护机制，保证不可用服务及时踢出
    enable-self-preservation: false
    ##剔除失效服务间隔
    eviction-interval-timer-in-ms: 2000

####swagger相关配置
swagger:
  base-package: com.lxg.controller
  title: SpringCloud2.x构建微服务项目-用户服务接口
  description: 用户有关的服务
  version: 1.1
  terms-of-service-url: www.lxgblog.com
  contact:
    name: 李先国
    email: [email protected]
2.7 用户服务的Feign

用户服务需要调用邮件服务，所以需要创建一个EmailFeign的interface，使用FeignClient注解，值为邮件服务的应用名，这在邮件服务的配置文件中有，然后将邮件服务中需要被调用的接口拷贝到这里（包括方法上的注解）

@FeignClient("app-email")
public interface EmailFeign {
    @GetMapping("/email")
    public String email();
}
2.8 用户服务的controller层

在用户服务中写一个调用邮件服务的Get接口，Api(tags = "用户微服务")是swagger的注解，它为controller命名，swagger其他注解见另一篇文章https://www.lxgblog.com/article/1576055897 ，同时将邮件Feign注入进来，通过它调用的方法其实是调用的远程服务。

@RestController
@Api(tags = "用户微服务")
public class UserController {
    @Autowired
    private EmailFeign emailFeign;

    @GetMapping("/user")
    public String user() {
        return "用户获取邮箱："+emailFeign.email();
    }
}
2.9 用户服务启动类

EnableSwagger2Doc注解开启swagger，EnableEurekaClient启动eureka客户端，EnableFeignClients启动Feign客户端。

@SpringBootApplication
@EnableEurekaClient
@EnableSwagger2Doc
@EnableFeignClients
public class UserApp {
    public static void main(String[] args) {
        SpringApplication.run(UserApp.class, args);
    }
}

启动这两个服务后，直接调用邮件服务中的接口：

通过调用用户服务的接口调用邮件服务：

分别访问127.0.0.1:8200/swagger-ui.html,127.0.0.1:8300/swagger-ui.html，也可以使用swagger测试上述接口：

3.创建Zuul网关整合两个服务的swagger

3.1 Zuul网关引入依赖

它需要作为eureka服务端注入到eureka注册中心，作为zuul网关，整合swagger，因此需要引入如下三个依赖：

    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
        </dependency>
        <dependency>
            <groupId>com.spring4all</groupId>
            <artifactId>swagger-spring-boot-starter</artifactId>
            <version>1.7.0.RELEASE</version>
        </dependency>
    </dependencies>
3.2 Zuul的配置文件

配置文件包括了端口号、服务名称、eureka客户端配置，网关反向代理配置。zuul.routes.api-user中的api.user可以任意命名，只要不重复即可，这里只作为区分。访问网关项目+path的值+相关服务接口的URI，就相当于直接访问对应服务的接口。

###服务启动端口号
server:
  port: 80
###服务名称(服务注册到eureka名称)
spring:
  application:
    name: app-zuul
###服务注册到eureka地址
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8100/eureka

### 配置网关反向代理
zuul:
  routes:
    api-user:
      path: /api-user/**
      serviceId: app-user
    api-email:
      path: /api-email/**
      serviceId: app-email
3.3 Zuul的启动类

在启动类上加入EnableEurekaClient注解开启eureka客户端，EnableZuulProxy注解开启网关，EnableSwagger2Doc注解开启swagger。
在启动类中整合了不同服务中的swagger

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

    // 添加文档来源
    @Component
    @Primary
    class DocumentationConfig implements SwaggerResourcesProvider {
        @Override
        public List<SwaggerResource> get() {
            List resources = new ArrayList<>();
            resources.add(swaggerResource("app-user", "/app-user/v2/api-docs", "2.0"));
            resources.add(swaggerResource("app-email", "/app-email/v2/api-docs", "2.0"));
            return resources;
        }

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

    }
}

启动网关服务后，访问127.0.0.1/swagger-ui.html

因为配置的是80端口，因此浏览器访问会省略80端口


通过网关访问邮件服务的接口，127.0.0.1/api-email/email和上面的127.0.0.1:8200/email是一样的

通过网关访问用户服务的接口去调用邮件服务的接口，127.0.0.1/api-user/email和上面的127.0.0.1:8300/user是一样的

这是由zuul配置文件中反向代理配置的。

本文GitHub源码：https://github.com/lixianguo5097/springcloud/tree/master/springcloud-springcloud-zuul-swagger2

CSDN：https://blog.csdn.net/qq_27682773
简书：https://www.jianshu.com/u/e99381e6886e
博客园：https://www.cnblogs.com/lixianguo
个人博客：https://www.lxgblog.com

原文地址：https://www.cnblogs.com/lixianguo/p/12522534.html

时间： 2024-08-30 07:24:50

SpringCloud系列之四---Zuul网关整合Swaagger2管理API的相关文章

SpringCloud系列研究---服务网关zuul

一.zuul简介 服务网关是微服务架构中的入口,微服务平台通过服务网关统一向外部暴露API供客户端调用,网关除了具备服务路由.均衡负载功能之外,它还具备了权限控制等功能.在Spring Cloud中的Zuul就担任了这样的一个角色,为微服务架构提供了保护的作用,同时将权限控制这些较重的非业务逻辑内容迁移到服务路由层面,使得服务集群主体能够具备更高的可复用性和可测试性. 二.环境介绍 同上一篇介绍ribbo中的环境一样,首先我们在A服务器上启动Eureka服务,然后在B.C两台服务器上分别启动ms

SpringCloud学习系列之七 ----- Zuul路由网关的过滤器和异常处理

前言 在上篇中介绍了SpringCloud Zuul路由网关的基本使用版本,本篇则介绍基于SpringCloud(基于SpringBoot2.x,.SpringCloud Finchley版)中的路由网关的过滤器Filter以及异常处理的教程. SpringCloud Zuul Filter 介绍 过滤器概述 Zuul的中心是一系列过滤器,能够在HTTP请求和响应的路由过程中执行一系列操作. 以下是Zuul过滤器的主要特征: 类型:通常在应用过滤器时在路由流程中定义阶段(尽管它可以是任何自定义字

白话SpringCloud | 第十一章：路由网关(Zuul)：利用swagger2聚合API文档

前言 通过之前的两篇文章,可以简单的搭建一个路由网关了.而我们知道,现在都奉行前后端分离开发,前后端开发的沟通成本就增加了,所以一般上我们都是通过swagger进行api文档生成的.现在由于使用了统一路由网关了,都希望各微服务的api文档统一的聚合在网关服务中,也方便前端用户查阅,不需要每个服务单独查看.当然了,也是可以做一个文档索引网页进行各微服务的api文档链接的.今天,我们就来讲下使用swagger实现自动化聚合微服务文档功能. 注:关于Swagger的介绍和使用,由于在之前的Spring

SpringCloud Zuul网关的简单理解

Zuul网关功能 请求路由.服务路由.请求过滤 请求路由 参数配置如下所示,所有能够配置path规则的请求,都会被zuul网关转发到对应的url上. zuul.routes.user-service.path=/user-service/** zuul.routes.user-service.url=http://178.69.1.39:9104/ 服务路由 参数配置如下所示,zuul会对服务user-service进行路由,所有能够配置path规则的请求,都会被zuul网关转发到serivce

springcloud(七，多个服务消费者配置，以及zuul网关案例)

spring cloud (一.服务注册demo_eureka) spring cloud (二.服务注册安全demo_eureka) spring cloud (三.服务提供者demo_provider) spring cloud (四.服务消费者demo_consumer) springcloud(五,多个服务注册中心eureka) springcloud(六,多个服务提供者) 多个服务消费者同上面的提供者和服务注册一样的哈,就是复制出来两个,把端口改一下即可 这里就不做截图了 直接开始zu

springcloud zuul 网关

zuul网关简介 Zuul 网关的核心 是系列过滤器,可以在 Http 请求发起和响应返回期间执行 系列的过滤器. Zuul 包括以下 四种过滤器: 1,PRE 过滤器 它是在请求路由到具体的服务之前执行的,这种类型的过滤器可 以做安全验证,例如身份验证. 参数验证等. 2,ROUTING 过滤器 它用于将请求路由到具体的微服务 .在默认情况下,它使用Http Client 进行网络请求. 3,POST 过滤器:它是在请求己被路由到微服务后执行的,一 般情况下,用作收集统计信息.指标,以及将响

springcloud学习之路: (三) springcloud集成Zuul网关

网关就是做一下过滤或拦截操作 让我们的服务更加安全 用户访问我们服务的时候就要先通过网关 然后再由网关转发到我们的微服务 1. 新建一个网关服务Module 2. 依然选择springboot工程 3. 老规矩起个名字 4. 勾选注册中心客户端 5. 勾选zuul网关模块 6. 编写配置文件 server: # 服务端口号 port: 8085 spring: application: # 服务名称 - 服务之间使用名称进行通讯 name: service-zuul eureka: client

Spring Cloud系列-Zuul网关集成JWT身份验证

前言 这两三年项目中一直在使用比较流行的spring cloud框架,也算有一定积累,打算有时间就整理一些干货与大家分享. 本次分享zuul网关集成jwt身份验证 业务背景 项目开发少不了身份认证,jwt作为当下比较流行的身份认证方式之一主要的特点是无状态,把信息放在客户端,服务器端不需要保存session,适合分布式系统使用. 把jwt集成在网关的好处是业务工程不需要关心身份验证,专注业务逻辑(网关可验证token后,把解析出来的身份信息如userId,放在请求头传递给业务工程). 顺便分享下

SCCM2012 R2实战系列之四：初始化配置

在之前的文章中,我们已经完成了SCCM 2012 R2 独立主站点的部署.为了客户端代理软件的顺利安装和OSD操作系统的分发,我们需要配置组策略及DHCP服务.在本系列的第四部分,跟大家一起分享下如何去实现SCCM的初始化配置. 1. 针对计算机OU的重定向 默认情况下,所有加域的计算机会自动存放到名为"computer"的容器中,为了方便对计算机的管理,我们需要重定向,让加域的计算机自动存放在名为"CMP"的OU中. 打开Active Directory用户和计算