此章节将基于上一章节基础之上，引入Soul网关，至于Soul网关是干什么的，怎么做的，我们会在后续章节讲解，1-3章节侧重于搭建应用。

本章节的Soul网关接入，如果你1，2章节都是和我保持一致，那么只需要直接启动Soul网关即可，但是对应的provider，consumer应用是需要额外的代码接入的。

开发环境和第二章保持一致。

3.1 提供者接入Soul

3.1.1 pom

<dependency>
  <groupId>org.dromara</groupId>
  <artifactId>soul-spring-boot-starter-client-alibaba-dubbo</artifactId>
  <version>2.2.0</version>
</dependency>
<dependency>
  <groupId>org.dromara</groupId>
  <artifactId>soul-spring-boot-starter-client-springmvc</artifactId>
  <version>2.2.0</version>
</dependency>
<dependency>
  <groupId>org.dromara</groupId>
  <artifactId>soul-client-springmvc</artifactId>
  <version>2.2.0</version>
</dependency>

3.1.2 Controller

与之前不同的是，这里我们会在Controller增加一个注解，@SoulSpringMvcClient，标注其注册成为一个SoulSpringMvcClient对象。这里有两种方式，一种是全局，一种是下面示例文件的局部，我会在 3.1.3 配置文件具体讲解二者实现上的差异性。

其中@SoulSpringMvcClient(path = "/consumer/** ")， ** 标识允许访问：consumer路径下全部，如果在当前Controller中，你只想部分暴露，那么更正为：

删除Controller上的：SoulSpringMvcClient(path = "/consumer/** ")
在对应需要暴露的接口上，加上全路径，如： @SoulSpringMvcClien(path = "/consumer/getUserById")

package com.youzha.dubbo.Controller;
import com.youzha.dubbo.dto.ResultDTO;
import com.youzha.dubbo.entity.User;
import com.youzha.dubbo.service.RemoteUserService;
import lombok.extern.slf4j.Slf4j;
import org.dromara.soul.client.springmvc.annotation.SoulSpringMvcClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.*;
/**
 * @author youzhaxiaobo
 * @version 1.0
 * @date 2020/7/1 19:30
 * @Desc
 */
@Slf4j
@RestController
@RequestMapping("/consumer")
@SoulSpringMvcClient(path = "/consumer/**")
public class ConsumerController {
    @Autowired
    private RemoteUserService userService;
    @GetMapping(value = "/getUserById", produces = MediaType.APPLICATION_JSON_VALUE)
    public ResultDTO getUserById(@RequestParam("id") int id) {
        log.info("id=" + id);
        User user = userService.findById(id);
        log.info("消费者获取用户，信息为:{}", user);
        if(null == user) {
           return new ResultDTO(-1, "获取失败");
        }
        return new ResultDTO(200, "获取成功", user);
    }
    @GetMapping(value = "/helloWorld", produces = MediaType.APPLICATION_JSON_VALUE)
    public ResultDTO helloWorld() {
        log.info("id=" + 1);
        User user = userService.findById(1);
        log.info("消费者获取用户，信息为:{}", user);
        if(null == user) {
            return new ResultDTO(-1, "获取失败");
        }
        return new ResultDTO(200, "获取成功", user);
    }
}

3.1.3 配置文件

soul:
  # 网关http配置
  http:
    adminUrl: http://127.0.0.1:9093
    contextPath: /consumer
    appName: consumer
    full: false
    port: 9092

说明：

http：标注这里协议是Http，同样还有（dubbo等）
adminUrl：对应soul-admin启动的应用地址，端口
contextPath：对应注册进Soul的路由前缀(即我们后续通过网关访问的限制名，多个应用应不同)
appName：对应的应用名称，不配置的话，会默认取 dubbo配置中application 中的名称
full：true则表示代理全部，全局允许访问，权限很大；false表示非全局，只访问有注解的地方(推荐)
port：当前应用的启动端口，并非soul-admin或网关，需保持一直

另外，如果你在 application.yaml(properties) 中配置了context-path，请删除，这个配置对于Soul而言是无感知的，即你的配置文件中不应出现下面的servlet配置：

server:
  port: 9092
  servlet:
    context-path: **

如果你在这里配置的：full是false，那么对应3.1.2章节就无需调整，如果是true，直接3.1.2关于SoulPringMvcClient相关注解即可。

3.2 消费者接入Soul

消费者相关配置，和提供者是一致的，这里不再赘述，直接贴出相关代码。

3.2.1 pom

<dependency>
  <groupId>org.dromara</groupId>
  <artifactId>soul-spring-boot-starter-client-alibaba-dubbo</artifactId>
  <version>2.2.0</version>
</dependency>
<dependency>
  <groupId>org.dromara</groupId>
  <artifactId>soul-spring-boot-starter-client-springmvc</artifactId>
  <version>2.2.0</version>
</dependency>
<dependency>
  <groupId>org.dromara</groupId>
  <artifactId>soul-client-springmvc</artifactId>
  <version>2.2.0</version>
</dependency>

3.2.2 Controller

package com.youzha.dubbo.controller;
import com.youzha.dubbo.dto.ResultDTO;
import lombok.extern.slf4j.Slf4j;
import org.dromara.soul.client.springmvc.annotation.SoulSpringMvcClient;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
/**
 * @author youzhaxiaobo
 * @version 1.0
 * @date 2020/7/4 0004 13:52
 * @Desc
 */
@Slf4j
@RestController
@RequestMapping("/provider")
@SoulSpringMvcClient(path = "/provider/**")
public class ProviderController {
    @GetMapping(value = "/hello", produces = MediaType.APPLICATION_JSON_VALUE)
    public ResultDTO getUserById(@RequestParam("id") int id) {
        log.info("id=" + id);
        if (id > 0) {
            return new ResultDTO(-1, "获取失败");
        }
        return new ResultDTO(200, "获取成功");
    }
}

3.2.3 配置文件

soul:
  # 网关dubbo配置
  dubbo:
    adminUrl: http://127.0.0.1:9093
    contextPath: /provider-youzha
    appName: provider-youzha
  # 网关http配置
  http:
    adminUrl: http://127.0.0.1:9093
    contextPath: /provider
    appName: provider
    full: false
    port: 9091

说明：

这里同时暴露出去了dubbo，http两套协议，dubbo对应的就是我们提供在Service层的代码，其变更很小，如下，只是增加了一个注解：@SoulDubboClient

dubbo，http提供的contextPath的路由前缀，需要保持不同，同时全局唯一(即不能和其他应用一致)

3.3 验证

前提：启动了zookeeper，启动了MySQL。

3.3.1 启动soul-admin

直接启动相关Application即可，登陆控制台查看：localhost:9093，用户名/密码：admin/123456。

成功之后，查看插件，注意这里确保二者开启，且配置项和我吻合：

其中：divide

zk：

{"register":"zookeeper://127.0.0.1:2181"}

3.3.2 启动soul-boostrap

直接启动相关Application即可。

3.3.3 启动soul-provider

直接启动相关Application即可，出现下面的日志则表示注册成功：

3.3.4 启动soul-consumer

直接启动相关Application即可，出现下面的日志则表示注册成功：

注意：

3.3.3，3.3.4启动完成之后，查看soul-admin的网页管理端，应该出现下图：

3.3.5 验证

此时直接通过自身IP访问消费者，地址：http://localhost:9092/consumer/getUserById?id=1，查看日志：

消费者：

提供者：

通过网关访问消费者，地址：http://localhost:9094/consumer/consumer/getUserById?id=1，查看日志：

消费者：

提供者：

直接通过自身IP访问提供者，地址：http://localhost:9091/provider/hello?id=-1

通过网关访问提供者，地址：http://localhost:9094/provider/provider/hello?id=-1

Chrome POST验证provider的dubbo接口

fetch(new Request('http://localhost:9094/provider/provider-youzha/findById',{
    method:'POST', 
    headers: {'Content-Type': 'application/x-www-form-urlencoded'},
    body:"id=1"
})).then((resp)=>{console.log(resp)})

注意：

通过网关访问，其地址为boostrap对应的：ip+端口
访问地址需要加上路由前缀，即配置文件中 soul 模块中的contextPath
如果你的项目和soul不部署在同一服务器，请在你的配置文件中追加上该配置(以你实际部署机器IP为准)，保证Soul能管理你的服务

soul.http.host=168.10.54.115

3.4 完整代码

3.Soul网关接入与验证