Skip to main content
Version: 2.4.2

1. Overview

1.1 Plugin Name​

  • ModifyResponse Plugin

1.2 Appropriate Scenario​

  • This plugin is used for modifying HTTP response status code, response headers or response body parameters.

1.3 Plugin functionality​

  • Reset HTTP response status code
  • Add, set, replace or remove HTTP response headers.
  • Add, replace or remove HTTP response body(JSON) parameters.

1.4 Plugin Code​

  • Core module shenyu-plugin-modify-response
  • Core class org.apache.shenyu.plugin.modify.response.ModifyResponsePlugin

1.5 Added since which shenyu version​

  • 2.4.0

2. How to use plugin

2.1 Plugin-use procedure chart​

2.2 Import pom​

  • import maven config in shenyu-bootstrap project's pom.xml file.
  <dependency>
  <groupId>org.apache.shenyu</groupId>
  <artifactId>shenyu-spring-boot-starter-gateway</artifactId>
  <version>${project.version}</version>
</dependency>

2.3 Enable plugin​

  • In shenyu-admin --> BasicConfig --> Plugin --> modifyResponse set Status enable.

2.4 Config plugin​

  • Selector and rule config, please refer: Selector and rule config.
  • In shenyu-admin --> PluginList --> HttpProcess --> modifyResponse, add selector config first，then add rule config：
    • Add selector config
    • Add rule config

2.5 Examples​

Here is an example of client project shenyu-examples-http.

2.5.1 Example reset HTTP response status code​

2.5.1.1 Refer Local Deployment to start admin and bootstrap.​

2.5.1.2 Refer 2.2 to import pom and restart bootstrap.​

2.5.1.3 Refer 2.3 to enable plugin.​

2.5.1.4 Refer 2.4 to add plugin config.​

Add plugin config:

2.5.1.5 Call Interface​

2.5.2 Example modify HTTP response headers​

2.5.2.1 Refer Local Deployment to start admin and bootstrap.​

2.5.2.2 Refer 2.2 to import pom and restart bootstrap.​

2.5.2.3 Refer 2.3 to enable plugin.​

2.5.2.4 Refer 2.4 to add plugin config.​

Add plugin config:

2.5.2.5 Call Interface​

2.5.3 Example modify HTTP response body​

2.5.3.1 Refer Local Deployment to start admin and bootstrap.​

2.5.3.2 Refer 2.2 to import pom and restart bootstrap.​

2.5.3.3 Refer 2.3 to enable plugin.​

2.5.3.4 Refer 2.4 to add plugin config.​

Add plugin config:

2.5.3.5 Call Interface​

3. How to disable plugin​

  • In shenyu-admin --> BasicConfig --> Plugin --> modifyResponse set Status disable.

4. rule parameter list​

for modifying status code:

  • statusCode: reset response status code

for modifying response headers:

  • addHeaders: add response headers, k-v format
  • setHeaders: set response headers, k-v format
  • replaceHeaderKeys: replace response headers，key is matching to the header key that should be replacing, value is target value after replacing
  • removeHeaderKeys: remove response headers，key is matching to the header key that should be removing

for modifying response body:

  • addBodyKeys: add response body parameters
  • replaceBodyKeys: replace response body parameters，key is matching to the body(JSON) key that should be replacing, value is target value after replacing
  • removeBodyKeys: remove response body parameters，key is matching to the body(JSON) key that should be removing