一、2.3 更新内容?

通过 2.3 releases可以了解;做了如下的更新;这里简单的中文介绍:

soul-admin(dashboard)

admin是整个网关的控制面板,掌管所有的流量,规则的匹配。

  • 整合shior框架,完成了用户按钮级别的权限控制。
  • 模板化插件,让用户无需感知前端页面,只专注于数据的配置。
  • admin整个后端的国际化,支持中英文切换。
  • 新增支持H2来存储数据。
  • admin界面的美观优化(表格,按钮)。
  • 新增单元测试,覆盖率达到百分之七十。

soul网关插件

插件新增
  • 新增GRPC插件,全面支持GRPC协议。
  • 新增 Tars插件,支持腾讯 tars RPC协议。
  • 新增Sofa 插件,支持 sofa RPC协议。
  • 新增 Sentinel 插件,整合 sentinel 框架的熔断限流功能。
  • 新增 Resilience4j 插件,整合 Resilience4j框架的熔断限流功能。
  • 新增 Rediect 插件,支持用户的重定向。
  • 新增 Context-path插件,支持用户自定义 context-path
插件优化
  • Divide 插件 : 节点探活方式的优化,流量预热方式的优化。
  • Ratelimiter插件 :新增并发,漏桶等不同的限流算法,供用户选择。
  • Sgin 插件 : 修复必须设置 url的bug,新增是否验证 标记,可以用来做开放平台的URI认证。
  • Dubbo插件 : 新增 form表单,URI参数请求, 新增注册中心直连,参数校验等功能。

Soul Client

soul-client只是提供一种快速接入网关的客户端,不是必须的。如果用户不使用,可以在soul-admin自行配置规则即可。

  • spring-mvc客户端的优化,支持springspring-boot所有版本。
  • spring-cloud客户端的优化,支持springspring-boot所有版本。
  • dubbo客户端的优化,支持springspring-boot所有版本。
  • 新增 soul-grpc-client 支持 grpc-java用户接入。
  • 新增 soul-tars-client 支持 tars-java用户接入。
  • 新增 soul-sofa-client 支持 sofa-java用户接入。

在之前的版本中,只支持 http 方式接入 而这次新增注册中心方式接入。

  • 新增 zookeeper 作为注册中心的方式接入soul网关。
  • 新增 Nacos 作为注册中心的方式接入soul网关。
  • 新增 Consul 作为注册中心的方式接入soul网关。
  • 新增 Etcd 作为注册中心的方式接入soul网关。

使用方式请参考: https://dromara.org/projects/soul/register-center-access/

Soul 数据同步

  • 修复Nacos 配置中心同步未设置 NameSpace 的Bug。
  • 优化 Websocket 同步方式。
  • 解决 soul-admin集群部署时候, Http长轮询方式同步数据Bug。

二、动手运行–环境搭建

官方文档中的 环境搭建 · dromara(Open source organization) 本身详细的说明,启动搭建的方式:

  • Docker
  • 远程下载
  • 本地搭建

本着学习的目的;这里推荐使用使用本地搭建的方式(笔者也是通过本地搭建的方式搭建的);其余两种方式适合快速搭建;大家可以试试。

1. Soul Admin 安装

> git clone https://github.com/dromara/soul.git
> cd soul

注意:启动 SoulAdminBootstrap

  • 如果使用h2来存储,设置变量 --spring.profiles.active = h2
  • 如果使用mysql来存储,修改 application.yaml 中的 mysql 配置。

这里我们使用 h2 的内存数据库。

启动 SoulAdminBootstrap类;看到如下内容启动成功:

android soul 首页效果 soul主页怎么设置_android soul 首页效果

访问 http://localhost:9095 用户名密码为: admin/123456

2. Soul Bootstrap 安装

> git clone https://github.com/dromara/soul.git
> cd soul

启动 SoulBootstrapApplication类;看到 websocket成功连接网关管理台的内容:

android soul 首页效果 soul主页怎么设置_客户端_02

接入 Spring Boot 应用

写简单测试案例的时候;这次我们使用 示例代码 代码运行。

<properties>
	<soul.version>2.3.0-RELEASE</soul.version>
</properties>
    
<!--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>

application.yaml关于soul的配置如下:

soul:
  client:
    registerType: http #zookeeper #etcd #nacos #consul
    serverLists: http://localhost:9095 #localhost:2181 #http://localhost:2379 #localhost:8848 # Soul Admin 地址目前也支持注册中心
    props:
      contextPath: /http # 设置在 Soul 网关的路由前缀,例如说 /order、/product 等等。
                               # 后续,网关会根据该 context-path 来进行路由
      appName: http  #应用名。未配置情况下,默认使用 `spring.application.name` 配置项
      port: 8189 #应用名端口;和配置server.port保持一致;作为路由端口
      nacosNameSpace: SoulRegisterCenter

OrderController内容:

@RestController
@RequestMapping("/order")
@SoulSpringMvcClient(path = "/order")
public class OrderController {
    //...
    @PostMapping("/save")
    @SoulSpringMvcClient(path = "/save" , desc = "Save order")
    public OrderDTO save(@RequestBody final OrderDTO orderDTO) {
        orderDTO.setName("hello world save order");
        return orderDTO;
    }
    //...
   }

@SoulSpringMvcClient 注解;有如下内容:

  • path:映射的 HTTP 接口的请求路径。
  • desc:接口的描述,便于知道其用途。
  • enable:是否开启,默认为 true 开启。

启动 SoulTestHttpApplicationmain方法启动项目。

android soul 首页效果 soul主页怎么设置_spring_03

访问 http://localhost:9195/http/order/save ;值得说明:9195是soul网关地址;http是配置的 contextpath

android soul 首页效果 soul主页怎么设置_android soul 首页效果_04

通过简单案例理解如下数据同步原理:

android soul 首页效果 soul主页怎么设置_java_05