组件分享之后端组件——一个Go 的 Swagger 2.0 实现组件go-swagger

背景

近期正在探索前端、后端、系统端各类常用组件与工具，对其一些常见的组件进行再次整理一下，形成标准化组件专题，后续该专题将包含各类语言中的一些常用组件。欢迎大家进行持续关注。

组件基本信息

• 组件：go-swagger
• 开源协议：Apache-2.0 License

内容

本节我们分享一个Go 的 Swagger 2.0 实现组件go-swagger

特征

go-swagger为 Go 社区带来了一整套功能齐全、高性能的 API 组件，可与 Swagger API 一起使用：服务器、客户端和数据模型。

• 从 swagger 规范生成服务器
• 从 swagger 规范生成客户端
• 从 swagger 规范（alpha 阶段）生成 CLI（命令行工具）
• 支持 jsonschema 和 swagger 提供的大部分功能，包括多态性
• 从带注释的 go 代码生成一个 swagger 规范
• 使用 swagger 规范的其他工具
• 强大的自定义功能，带有供应商扩展和可自定义的模板
  我们的代码生成重点是生成惯用的、快速的代码，它与 golint、go vet 等配合得很好。

功能描述

• 序列化兼容 swagger 的 yaml 或 json 的对象模型
• 使用 swagger 的工具
  • 为任何 swagger 规范文件提供 swagger UI
  • 灵活的代码生成，带有可定制的模板
    • 基于 swagger 规范生成 go API server
    • 从 swagger 规范生成 go API 客户端
  • 验证一个招摇的规范文档，这里列出了额外的规则
  • 根据带注释的代码生成规范文档
• 使用 Rest API 和中间件的运行时
  • 服务规格
  • 路由
  • 验证
  • 授权
  • Swagger 文档用户界面
  • 如果规范中的更改破坏了向后兼容性，则会导致构建失败的 Diff 工具

还有更多...

• 一个类型化的 JSON Schema 实现，支持 Draft 4 的大部分特性
• 扩展字符串和数字格式：strfmt
• 使用 JSON、转换数据类型和指针的实用程序：swag
• 一个 jsonschema (Draft 4) 验证器，具有完整的 $ref 支持：validate
• 自定义验证界面

本文声明：

88x31.png
知识共享许可协议
本作品由 cn華少 采用 知识共享署名-非商业性使用 4.0 国际许可协议 进行许可。