Spring Cloud Proxy

This document is intended to help the Spring Cloud service access the Apache ShenYu gateway. The Apache ShenYu gateway uses the springCloud plugin to handle Spring Cloud service.

Before the connection, start shenyu-admin correctly, start springCloud plugin, and add related dependencies on the gateway and springCloud application client. Refer to the previous Quick start with Spring Cloud .

For details about client access configuration, see Application Client Access Config .

For details about data synchronization configurations, see Data Synchronization Config .

Add springcloud plugin in gateway

• add these dependencies in gateway's pom.xml:

  <!-- apache shenyu springCloud plugin start-->  <dependency>       <groupId>org.apache.shenyu</groupId>       <artifactId>shenyu-spring-boot-starter-plugin-springcloud</artifactId>        <version>${project.version}</version>  </dependency>
  <dependency>       <groupId>org.apache.shenyu</groupId>       <artifactId>shenyu-spring-boot-starter-plugin-httpclient</artifactId>       <version>${project.version}</version>   </dependency>   <!-- apache shenyu springCloud plugin end-->
   <dependency>        <groupId>org.springframework.cloud</groupId>        <artifactId>spring-cloud-commons</artifactId>        <version>2.2.0.RELEASE</version>   </dependency>   <dependency>        <groupId>org.springframework.cloud</groupId>        <artifactId>spring-cloud-starter-netflix-ribbon</artifactId>        <version>2.2.0.RELEASE</version>   </dependency>

• If you use eureka as SpringCloud registry center.

  add these dependencies:

    <dependency>       <groupId>org.springframework.cloud</groupId>       <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>       <version>2.2.0.RELEASE</version>  </dependency>

add these config values in gateway's yaml file:

   eureka:     client:       serviceUrl:         defaultZone: http://localhost:8761/eureka/ #your eureka address     instance:       prefer-ip-address: true

• if you use nacos as Spring Cloud registry center.

  add these dependencies:

   <dependency>       <groupId>com.alibaba.cloud</groupId>       <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>       <version>2.1.0.RELEASE</version> </dependency>

add these config values in gateway's yaml file:

  spring:     cloud:       nacos:         discovery:            server-addr: 127.0.0.1:8848 # your nacos address

• restart your gateway service.

SpringCloud service access gateway

Please refer to shenyu-examples-springcloud

• Add the following dependencies to your Spring Cloud microservice :

 <dependency>      <groupId>org.apache.shenyu</groupId>      <artifactId>shenyu-spring-boot-starter-client-springcloud</artifactId>      <version>${shenyu.version}</version> </dependency>

• Add the annotation @ShenyuSpringCloudClient in your controller interface. you can apply the annotation to class-level in a controller.the name of the path variable is prefix and '/**' will apply proxy for entire interfaces.

• example (1)：both /test/payment and /test/findByUserId will be handled by gateway.

   @RestController @RequestMapping("/test") @ShenyuSpringCloudClient(path = "/test/**") public class HttpTestController {
       @PostMapping("/payment")     public UserDTO post(@RequestBody final UserDTO userDTO) {         return userDTO;     }
       @GetMapping("/findByUserId")     public UserDTO findByUserId(@RequestParam("userId") final String userId) {         UserDTO userDTO = new UserDTO();         userDTO.setUserId(userId);         userDTO.setUserName("hello world");         return userDTO;     }  }

example (2)：`/order/save` will be handled by gateway, and `/order/findById` won't.
 ```java  @RestController  @RequestMapping("/order")  @ShenyuSpringCloudClient(path = "/order")  public class OrderController {
      @PostMapping("/save")      @ShenyuSpringMvcClient(path = "/save")      public OrderDTO save(@RequestBody final OrderDTO orderDTO) {          orderDTO.setName("hello world save order");          return orderDTO;      }
      @GetMapping("/findById")      public OrderDTO findById(@RequestParam("id") final String id) {          OrderDTO orderDTO = new OrderDTO();          orderDTO.setId(id);          orderDTO.setName("hello world findById");          return orderDTO;      }  }

example (3)： isFull：true represents that all service will be represented by the gateway.

shenyu:  client:    registerType: http    serverLists: http://localhost:9095    props:      contextPath: /http      appName: http      isFull: true# registerType : service registre type, see the application client access document# serverList: server list, see the application client access document# contextPath: route prefix for your project in ShenYu gateway.# appName：your application name# isFull: set true to proxy your all service and false to proxy some of your controllers

  @RestController  @RequestMapping("/order")  public class OrderController {
      @PostMapping("/save")      @ShenyuSpringMvcClient(path = "/save")      public OrderDTO save(@RequestBody final OrderDTO orderDTO) {          orderDTO.setName("hello world save order");          return orderDTO;      }
      @GetMapping("/findById")      public OrderDTO findById(@RequestParam("id") final String id) {          OrderDTO orderDTO = new OrderDTO();          orderDTO.setId(id);          orderDTO.setName("hello world findById");          return orderDTO;      }  }

• After successfully registering your service, go to the backend management system PluginList -> rpc proxy -> springCloud ', you will see the automatic registration of selectors and rules information.

User Request

• Send the request as before, only two points need to notice.

• firstly,the domain name that requested before in your service, now need to replace with gateway's domain name.

• secondly, Apache ShenYu gateway needs a route prefix which comes from contextPath, it configured during the integration with gateway, you can change it freely in divide plugin of shenyu-admin, if your familiar with it.

For example, your have an order service and it has a interface, the request url: http://localhost:8080/test/save .

Now need to change to：http://localhost:9195/order/test/save .

We can see localhost:9195 is the gateway's ip port, default port number is 9195 , /order is the contextPath in your config yaml file.

The request of other parameters doesn't change. Then you can visit, very easy and simple.