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 /的生成，...）