我想使用 Swagger 2.0 来记录 REST API,因为这似乎被广泛用于记录 RET API。
但是,我不确定如何将文档和实现保持在 Sync 中?例如,当我添加一个新 API 时,我必须确保 API 文档中使用的模型(表示响应)应该与 REST 实现中创建的模型相同。同样,文档中给出的资源名称应该与实现中的资源名称匹配。
有没有办法从使用 swagger 2.0 规范生成的文档中只生成资源接口和模型类?
我想使用 Swagger 2.0 来记录 REST API,因为这似乎被广泛用于记录 RET API。
但是,我不确定如何将文档和实现保持在 Sync 中?例如,当我添加一个新 API 时,我必须确保 API 文档中使用的模型(表示响应)应该与 REST 实现中创建的模型相同。同样,文档中给出的资源名称应该与实现中的资源名称匹配。
有没有办法从使用 swagger 2.0 规范生成的文档中只生成资源接口和模型类?
您可以使用这些工具生成服务器源(它们也可以生成客户端源):