Java 界最好的 API 網關 Soul

soul網關發佈2.1.0版本 (做Java界最好的API-Gateway)

  • 這是soul網關開源以來的最大的一次更新,收集了很多社區反饋的問題,進行了更新.

  • 之前的文檔不是很完善,使用成本較高,這裡先說聲抱歉,這一個版本中,同時更新了相關文檔.

  • 在這個版本中,提供 http,dubbo,springcloud等服務快速接入網關的功能.

  • 在這個版本中一切都是可擴展的,具體的可以看開發者文檔.

  • 修護了很多問題,優化了很多性能,包括線程模型,異步模型等等.

  • 新增一個元數據的概念。

  • 以後的版本更新,基本上以這個版本為基礎原型,來進行更新了.

  • 使用之前版本的用戶,如果要升級的話,可以在群裡問。。

  • 更新了太多太多地方,無法一一列舉,大家只能去看文檔了.

快速啟動 soul-admin

<code>> 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_&failOverReadOnly=false&autoReconnect=true&useSSL=false"
--spring.datasource.username='you username' --spring.datasource.password='you password'
/<code>

快速啟動 soul-bootstrap

<code>> wget https://yu199195.github.io/jar/soul-bootstrap.jar

> java -jar soul-bootstrap.jar
/<code>
  • 這樣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等等。

  • 支持用戶快速的進行插件的自定義開發。

  • 插件的所有數據,開關狀態支持動態變更。

數據同步

  • 提供了 <code>http長輪詢/<code>,<code>zookeeper/<code>,<code>websocket/<code>三種不同的數據同步策略,讓用戶自由選擇。

  • 推薦用戶使用websocket方式,最輕量,在集群環境下,效率更高。

對於用戶

  • 首先我們提供了便於用戶接入的 <code>client/<code>包,用戶可以把快速的把自己的項目接入到<code>soul/<code>網關。

  • 默認情況下,用戶完全不用關心 <code>soul/<code>網關的選擇器,規則等配置。

  • 用戶之前的接口完全是零侵入,不需要任何更改,只是需要把訪問域名改成網關的域名即可。

  • 比如 dubbo用戶,幾乎就是http的方式完成了 http協議到 dubbo協議的互相轉換。

  • <code>soul/<code>使用的是http協議,那麼註定它就是跨語言的,net程序員,php程序員等等,要和java進行數據交互,那麼就大大的可行了。

    舉個列子 ,比如你有一個 dubbo接口 參數定義是一個java bean,

    <code>public void insert(final DubboTest dubboTest) {

    }

    public class DubboTest implements Serializable {

    private String id;

    private String name;
    }
    /<code>

    如果你使用 soul網關要發起對它的調用,你的http傳參數 就是在 body 裡面 傳一個json字符串 ,和普通的http調用無差別。

    <code>{"id":"123","name":"xiaoyu"}
    /<code>

對於開發者(程序員)

  • 隨著使用者越來越多,每個公司使用情況又不一樣,<code>soul/<code>網關在2.1.X版本,處處留出來更多的高度自定義擴展性,讓開發者,更加方便或者有信心融入進來。

  • 比如,自定義插件,過濾器,dubbo參數解析器,iphost解析器,返回結果等等。。這裡我著重說一下自定義返回結果。

    我們知道,<code>soul/<code>網關默認的返回結果是:

    <code>{"code":200, "message ": "成功!","data" :"helloWorld!"}
    /<code>

    但是,在運用 <code>soul/<code>網關對你的業務系統進行調用的時候,你的業務系統可能定義的結果並不是上述結構,可能你的 字段叫<code>msg/<code>,這樣就會造成結構不一樣,給前端處理帶來了困擾。我們注意到了這個事情 :https://github.com/Dromara/soul/issues/109 , 現在已經優化,用戶可以定製化的來定義返回結果,具體的要看<code>soul/<code>文檔。

說了這麼多,吹了這麼多牛逼,那麼我們來看看 soul網關到底可以在什麼場景下能發揮大作用。

後臺管理web

首先隨便微服務的流行,我們的後臺都劃分成很多的微服務,我相信你們每個公司都有一個後臺管理系統吧,如果我沒猜錯的話,他們大體上是如下架構。

Java 界最好的 API 网关 Soul

很簡單對吧,就是有個運營管理平臺的web項目,去調用每個微服務,來進行後臺的查看等等。隨著你們業務需要的加大,可能這裡需要調用的微服務越來越多,你的 <code>controller/<code>越來越多,現在比如你修改了 商品模塊的 接口,你要發版會造成所有其他的模塊也操作不了(就是你發版影響了其他模塊的使用,別槓這裡只是比方,不要整藍綠髮版啥的,明白意思吧)。

如果有運營人員在操作其他模塊,會不會吐槽你?

假如你是公司架構師,我說的是假如,那麼你要怎麼解決這個問題呢?當然,我們把這樣一個大的web系統,拆分成很多小web系統,單獨的進行發佈,但是這樣會引入一個問題,怎麼統一登陸,鑑權?(很多後臺管理系統還有權限的劃分) ,這個時候,<code>soul/<code>網關 就能發揮重要的作用了,下面我只是列舉了一下簡單的調用圖。

Java 界最好的 API 网关 Soul

這樣多方便,集成了網關,每個微服務註冊到網關,網關根據路由規則來進行調用。自動發現服務,連運維配置 nginx的工作都省了,把運維的工資給你,美滋滋。

公司入口網關(開放平臺)

如果一個公司要做開放平臺或者入口網關,鑑權,限流,監控,熔斷肯定少不了。

如果貴公司是dubbo體系,開發人員寫了dubbo服務後,還要傻乎乎的新增一個web項目,來提供接口給別人調用嗎?

如果一個接口被攻擊,你怎麼處理呢?如果被大流量攻擊,你怎麼處理呢?

不巧,<code>soul/<code>在設計之初就是來幹這種事情的,我們來看一下整體的架構圖。

Java 界最好的 API 网关 Soul

零零總總還有很多其他功能

  • 比如支持 <code>websocket/<code>代理。

  • 比如支持文件上傳下載

  • 比如你可以自定義的開發你的插件啊。

最後最後

  • github地址 :https://github.com/Dromara/soul

  • gitee地址 :https://gitee.com/shuaiqiyu/soul

  • 文檔:https://dromara.org/zh-cn/docs/soul/soul.html

  • 最後 3.0 已經在進行開源了,3.0是經歷過2年雙11大併發場景驗證過的,現在一步一步將它開源出來,希望給大家帶來幫助.


分享到:


相關文章: