此章节将基于上一章节基础之上，引入Soul网关，至于Soul网关是干什么的，怎么做的，我们会在后续章节讲解，1-3章节侧重于搭建应用。
本章节的Soul网关接入，如果你1，2章节都是和我保持一致，那么只需要直接启动Soul网关即可，但是对应的provider，consumer应用是需要额外的代码接入的。
开发环境和第二章保持一致。
1 提供者接入Soul
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>
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);
}
}
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相关注解即可。
2 消费者接入Soul
消费者相关配置，和提供者是一致的，这里不再赘述，直接贴出相关代码。
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>
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, "获取成功");
}
}
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 验证
前提：启动了zookeeper，启动了MySQL。
3.1 启动soul-admin
直接启动相关Application即可，登陆控制台查看：localhost:9093，用户名/密码：admin/123456。
成功之后，查看插件，注意这里确保二者开启，且配置项和我吻合：
其中：divide
zk：
{"register":"zookeeper://127.0.0.1:2181"}
3.2 启动soul-boostrap
直接启动相关Application即可。
3.3 启动soul-provider
直接启动相关Application即可，出现下面的日志则表示注册成功：
3.4 启动soul-consumer
直接启动相关Application即可，出现下面的日志则表示注册成功：
注意：
3.3.3，3.3.4启动完成之后，查看soul-admin的网页管理端，应该出现下图：
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
