Java 界最好的 API 网关 Soul
- 2019 年 12 月 27 日
- 笔记
soul网关发布2.1.0版本 （做Java界最好的API-Gateway）
- 这是soul网关开源以来的最大的一次更新，收集了很多社区反馈的问题，进行了更新.
- 之前的文档不是很完善，使用成本较高，这里先说声抱歉，这一个版本中，同时更新了相关文档.
- 在这个版本中，提供 http,dubbo,springcloud等服务快速接入网关的功能.
- 在这个版本中一切都是可扩展的，具体的可以看开发者文档.
- 修护了很多问题，优化了很多性能，包括线程模型，异步模型等等.
- 新增一个元数据的概念。
- 以后的版本更新，基本上以这个版本为基础原型，来进行更新了.
- 使用之前版本的用户，如果要升级的话，可以在群里问。。
- 更新了太多太多地方，无法一一列举，大家只能去看文档了.
快速启动 soul-admin
> wget https://yu199195.github.io/jar/soul-admin.jar > java -jar soul-admin.jar --spring.datasource.url="jdbc:mysql://你的url:3306/soul?useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=CONVERT_TO_NULL&failOverReadOnly=false&autoReconnect=true&useSSL=false" --spring.datasource.username='you username' --spring.datasource.password='you password'
快速启动 soul-bootstrap
> wget https://yu199195.github.io/jar/soul-bootstrap.jar > java -jar soul-bootstrap.jar
- 这样soul网关就启动了
springMvc服务接入
参考文档: https://dromara.org/zh-cn/docs/soul/joinUp-mvc.html
dubbo服务接入
参考文档: https://dromara.org/zh-cn/docs/soul/joinUp-dubbo.html
springCloud服务接入
参考文档: https://dromara.org/zh-cn/docs/soul/joinUp-springcloud.html
代码与文档
github : https://github.com/Dromara/soul
gitee : https://gitee.com/shuaiqiyu/soul
文档: https://dromara.org/zh-cn/docs/soul/soul.html
Soul网关发布2.1.X之后，它到底有多方便？
Soul 网关自从去年10月我开源以来，经历了一年的事情，接受到了来自社区很多朋友的建议，并进行持续不断的优化，已经提供了非常丰富的功能，很多功能都是高度自定义，可视化，高度可扩展的，现在做一个归纳总结。
插件
- 提供了系统自带的各种插件，比如签名，监控，限流，熔断，http代理，dubbo代理，websocket等等。
- 支持用户快速的进行插件的自定义开发。
- 插件的所有数据，开关状态支持动态变更。
数据同步
- 提供了
http长轮询，zookeeper，websocket三种不同的数据同步策略，让用户自由选择。 - 推荐用户使用websocket方式，最轻量，在集群环境下，效率更高。
对于用户
- 首先我们提供了便于用户接入的
client包，用户可以把快速的把自己的项目接入到soul网关。 - 默认情况下，用户完全不用关心
soul网关的选择器，规则等配置。 - 用户之前的接口完全是零侵入，不需要任何更改，只是需要把访问域名改成网关的域名即可。
- 比如 dubbo用户，几乎就是http的方式完成了 http协议到 dubbo协议的互相转换。
soul使用的是http协议，那么注定它就是跨语言的，net程序员，php程序员等等，要和java进行数据交互，那么就大大的可行了。 举个列子 ，比如你有一个 dubbo接口 参数定义是一个java bean,publicvoidinsert(final DubboTest dubboTest){}publicclassDubboTestimplementsSerializable{private String id;private String name;}如果你使用 soul网关要发起对它的调用，你的http传参数 就是在 body 里面 传一个json字符串 ，和普通的http调用无差别。{"id":"123","name":"xiaoyu"}
对于开发者(程序员)
- 随着使用者越来越多，每个公司使用情况又不一样,
soul网关在2.1.X版本，处处留出来更多的高度自定义扩展性，让开发者，更加方便或者有信心融入进来。 - 比如，自定义插件，过滤器，dubbo参数解析器，iphost解析器，返回结果等等。。这里我着重说一下自定义返回结果。 我们知道，
soul网关默认的返回结果是：{"code":200, "message ": "成功!","data" :"helloWorld!"}但是，在运用soul网关对你的业务系统进行调用的时候，你的业务系统可能定义的结果并不是上述结构，可能你的 字段叫msg,这样就会造成结构不一样，给前端处理带来了困扰。我们注意到了这个事情 ：https://github.com/Dromara/soul/issues/109 , 现在已经优化，用户可以定制化的来定义返回结果,具体的要看soul文档。
说了这么多，吹了这么多牛逼，那么我们来看看 soul网关到底可以在什么场景下能发挥大作用。
后台管理web
- 首先随便微服务的流行，我们的后台都划分成很多的微服务，我相信你们每个公司都有一个后台管理系统吧，如果我没猜错的话，他们大体上是如下架构。
- 很简单对吧，就是有个运营管理平台的web项目，去调用每个微服务，来进行后台的查看等等。随着你们业务需要的加大，可能这里需要调用的微服务越来越多，你的
controller越来越多，现在比如你修改了 商品模块的 接口，你要发版会造成所有其他的模块也操作不了（就是你发版影响了其他模块的使用，别杠这里只是比方，不要整蓝绿发版啥的，明白意思吧）。 如果有运营人员在操作其他模块，会不会吐槽你？ 假如你是公司架构师，我说的是假如，那么你要怎么解决这个问题呢？当然，我们把这样一个大的web系统，拆分成很多小web系统，单独的进行发布，但是这样会引入一个问题，怎么统一登陆，鉴权？（很多后台管理系统还有权限的划分） ，这个时候，soul网关 就能发挥重要的作用了，下面我只是列举了一下简单的调用图。
- 这样多方便，集成了网关，每个微服务注册到网关，网关根据路由规则来进行调用。自动发现服务，连运维配置 nginx的工作都省了，把运维的工资给你，美滋滋。
公司入口网关（开放平台）
- 如果一个公司要做开放平台或者入口网关，鉴权，限流，监控，熔断肯定少不了。
- 如果贵公司是dubbo体系，开发人员写了dubbo服务后，还要傻乎乎的新增一个web项目，来提供接口给别人调用吗？
- 如果一个接口被攻击，你怎么处理呢？如果被大流量攻击，你怎么处理呢？
- 不巧，
soul在设计之初就是来干这种事情的，我们来看一下整体的架构图。
零零总总还有很多其他功能
- 比如支持
websocket代理。 - 比如支持文件上传下载。
- 比如你可以自定义的开发你的插件啊。
