版本：2.3.0(Legacy)

Http用户

说明

本文旨在帮助http用户。
soul网关使用 divide 插件来处理http请求。请求在soul-admin后台开启它。
接入前，请正确的启动 soul-admin，以及搭建环境 OK。

引入网关对http的代理插件

在网关的 pom.xml 文件中增加如下依赖：

  <!--if you use http proxy start this-->
   <dependency>
       <groupId>org.dromara</groupId>
       <artifactId>soul-spring-boot-starter-plugin-divide</artifactId>
        <version>${last.version}</version>
   </dependency>

   <dependency>
       <groupId>org.dromara</groupId>
       <artifactId>soul-spring-boot-starter-plugin-httpclient</artifactId>
        <version>${last.version}</version>
   </dependency>

当然是要重新启动网关。

Http请求接入网关（springMvc体系用户）

首先要确保在 soul-admin 后台 divide插件是否开启。

Soul-Client接入方式。（此方式针对SpringMvc,SpringBoot用户）

SpringBoot用户

在你的真实服务的 pom.xml 新增如下依赖:

     <dependency>
         <groupId>org.dromara</groupId>
         <artifactId>soul-spring-boot-starter-client-springmvc</artifactId>
         <version>${last.version}</version>
     </dependency>

注册中心详细接入配置请参考：注册中心接入.

SpringMvc用户

在你的真实服务的 pom.xml 新增如下依赖：

       <dependency>
           <groupId>org.dromara</groupId>
           <artifactId>soul-client-springmvc</artifactId>
           <version>${last.version}</version>
       </dependency>

在你的 bean定义的xml文件中新增如下：

   <bean id ="springMvcClientBeanPostProcessor" class ="org.dromara.soul.client.springmvc.init.SpringMvcClientBeanPostProcessor">
        <constructor-arg  ref="soulRegisterCenterConfig"/>
   </bean>
   
   <bean id="soulRegisterCenterConfig" class="org.dromara.soul.register.common.config.SoulRegisterCenterConfig">
        <property name="registerType" value="http"/>
        <property name="serverList" value="http://localhost:9095"/>
        <property name="props">
             <map>
               <entry key="contextPath" value="/你的contextPath"/>
               <entry key="appName" value="你的名字"/>
               <entry key="port" value="你的端口"/>
               <entry key="isFull" value="false"/>
             </map>
        </property>
   </bean>

在你的 controller 的接口上加上 @SoulSpringMvcClient 注解。

你可以把注解加到 Controller 类上面，里面的path属性则为前缀，如果含有 /** 代表你的整个接口需要被网关代理。

举例子（1）：代表 /test/payment，/test/findByUserId 都会被网关代理。

  @RestController
  @RequestMapping("/test")
  @SoulSpringMvcClient(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;
      }      
   }

举例子（2）：代表 /order/save，会被网关代理，而/order/findById 则不会。

  @RestController
  @RequestMapping("/order")
  @SoulSpringMvcClient(path = "/order")
  public class OrderController {
  
      @PostMapping("/save")
      @SoulSpringMvcClient(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;
      }
  }

启动你的项目，你的接口接入到了网关。

Http请求接入网关（其他语言，非springMvc体系）

首先在 soul-admin 找到 divide插件，进行选择器，和规则的添加，进行流量的匹配筛选。
如果不懂怎么配置，请看选择，规则介绍选择器规则介绍。
您也可以自定义开发属于你的 http-client，参考多语言Http客户端开发。

用户请求

说白了，你之前怎么请求就怎么请求，没有很大的变动，变动的地方有2点。
第一点，你之前请求的域名是你自己的服务，现在要换成网关的域名（这个你听的懂？）
第二点，soul网关需要有一个路由前缀，这个路由前缀就是你接入项目进行配置 contextPath，如果熟的话，可以自由在 soul-admin 中的divide插件进行自由更改。
- 比如你有一个 order服务它有一个接口，请求路径 http://localhost:8080/test/save
- 现在就需要换成：http://localhost:9195/order/test/save
- 其中 localhost:9195 为网关的ip端口，默认端口是9195 ，/order 是你接入网关配置的 contextPath
- 其他参数，请求方式不变。
- 我讲到这里还不懂？请加群问吧
然后你就可以进行访问了，如此的方便与简单。

说明​

引入网关对http的代理插件​

Http请求接入网关（springMvc体系用户）​

Soul-Client接入方式。 （此方式针对SpringMvc,SpringBoot用户）​

Http请求接入网关（其他语言，非springMvc体系）​

用户请求​

说明

引入网关对http的代理插件

Http请求接入网关（springMvc体系用户）

Soul-Client接入方式。（此方式针对SpringMvc,SpringBoot用户）

Http请求接入网关（其他语言，非springMvc体系）

用户请求