registerWebInterface和registerRestInterface和RestInterfaceClient有什么區別？

Question

我無法通過docs理解registerRestInterface ， registerWebInterface和RestInterfaceClient有什么區別。

它們都可以按類生成方法。 但是我不知道何時應該使用另一個。

Answer 1

理解差異的關鍵是要認識到vibe.web.rest和vibe.web.web是兩個不同的模塊，並考慮了不同的用例：

vibe.web.rest

• 用於無狀態通信
• 需要定義一個抽象接口
• RestInterfaceClient可用於與其他Rest接口通信
• 可以從API接口生成JS客戶端
• 可以用registerRestInterface 注冊

何時使用：

• 大型公共API
• API需要與他人共享

-> 用法示例

vibe.web.web

• 用於網絡服務
• 允許直接訪問當前會話和請求上下文
• 根據請求提供許多便利功能（例如redirect ）
• 允許@auth （ 示例 ）
• 可以使用registerWebInterface 注冊

何時使用：Web服務，小型API

-> 用法示例

我個人更經常使用vibe.web.web因為對於我的小型項目而言，保持界面文件同步的開銷是不值得的。 此外，我喜歡在vibe.web.web方便地訪問請求上下文和會話變量。 實際上，我維護着一個插入式分叉 ，它添加了更多便利功能（到/來自Json的自動序列化，基於方法params的自動路由/：param /的生成，...）