Skip to main content
版本：2.7.0

1. 概述

1.1 插件名称​

  • 上下文路径插件

1.2 适用场景​

  • 不同的服务可以通过设置不同的上下文路径来做服务的流量治理

1.3 插件功能​

  • 设置服务的上下文路径
  • 在接口调用的时候插件统一给服务的接口地址加上前缀

1.4 插件代码​

  • 核心模块 shenyu-plugin-context-path
  • 核心类 org.apache.shenyu.plugin.context.path.ContextPathPlugin

1.5 添加自哪个 shenyu 版本​

  • 2.3.0

2. 如何使用插件

2.1 插件使用流程图​

2.2 导入 pom​

  • 在网关的 pom.xml 文件中添加插件 maven 配置。
  <dependency>
      <groupId>org.apache.shenyu</groupId>
      <artifactId>shenyu-spring-boot-starter-gateway</artifactId>
     <version>${project.version}</version>
  </dependency>

2.3 启用插件​

  • 在 shenyu-admin --> 基础配置 --> 插件管理 --> contextPath 设置为开启。

2.4 配置插件​

  • 配置客户端项目的 contextPath

  • 选择器和规则设置，请参考：选择器和规则管理。
  • shenyu-admin contextPath 插件配置，可以配置 contextPath 和 addPrefix：contextPath 定义了 contextPath 的值，addPrefix 定义了接口调用时需要自动增加的的前缀。

2.5 示例​

2.5.1 示例 设置服务的上下文路径​

2.5.1.1 参考本地部署启动 admin 和网关​

2.5.1.2 参考 2.2 导入 pom 并重启网关​

2.5.1.3 参考 2.3 启用插件​

2.5.1.4 客户端项目配置 contextPath​

客户端项目可以直接使用 shenyu-examples-http，并在 application.yml 中配置 contextPath。

配置完成后启动，可以看到 shenyu-admin 中多了一条 context 的 selector 和 rule 配置。

2.5.1.5 接口调用​

2.5.2 示例 增加前缀​

2.5.2.1 参考本地部署启动 admin 和网关​

2.5.2.2 参考 2.2 导入 pom 并重启网关​

2.5.2.3 参考 2.3 启用插件​

2.5.2.4 客户端项目配置 contextPath​

客户端项目可以直接使用 shenyu-examples-http，并在 application.yml 中配置 contextPath。

配置完成后启动，可以看到 shenyu-admin 中多了一条 context 的 selector 和 rule 配置。

2.5.2.5 修改 addPrefix 的值​

2.5.2.6 修改选择器和条件配置中 uri 的值，删除掉 addPrefix 部分，由于本例使用了 http 协议的服务，因此需要修改 divide 插件。​

2.5.2.7 接口调用​

2.5.3 示例 应用切流​

2.5.3.1 参考本地部署启动 admin 和网关​

2.5.3.2 参考 2.2 导入 pom 并重启网关​

2.5.3.3 参考 2.3 启用插件​

2.5.3.4 客户端项目启动​

客户端项目可以直接使用 shenyu-examples-http和 shenyu-examples-https。

启动后，可以看到 shenyu-admin 中多了2条 context 的 selector 和 rule 配置。

2.5.3.5 修改 rewriteContextPath 的值​

注意：percentage可以调节切流比例，0~100，默认100，表示全部切流。

2.5.2.6 接口调用​

3. 如何禁用插件

  • 在 shenyu-admin --> 基础配置 --> 插件管理 --> contextPath 设置为禁用。