Thrift RPC 文件
Thrifts的基础文档是Thrift IDL,即接口描述语言。
该 IDL 以高级方式描述 API,同时用作生成语言绑定所需代码的输入。
为了实现这一点,Thrift IDL 文件不仅包含声明,还允许在其中使用机器人普通注释和所谓的“文档注释”。许多语言绑定支持从文档注释直接转换为语言特定形式,因此文档也将找到进入生成代码的方式。
源代码树中的Thrift IDL 文件内有一个很好的文档示例。此外,考虑使用 GraphViz 生成器 ( -gen gv) 来获取 IDL 或 HTML 生成器 ( -gen html) 或(相当旧的)XSD 生成器的图形文档。
Swagger(或 Apiary)提供了一种 UI 类型的交互方式来实现。这是当今 Thrift 中无法比拟的。
swagger 是否支持为 Thrift [...] 文件生成文档?
Swagger 处理 RESTful 服务。Thrift是一个RPC系统,两者有一些概念上的差异。因此,swagger 不太可能达到能够记录 REST 之外的任何内容的程度。
相关问题:Swagger可以用于SOAP吗?
| 归档时间: |
|
| 查看次数: |
1647 次 |
| 最近记录: |