如何用 Swagger 消除前后端分离的障碍

作者/分享人:蒋超
就职于花旗ICG,从事数据分发和数据检索的后端开发。对商业数据库MarkLogic有长时间的运用。CSDN博客专家。

随着后端技术的日渐成熟和前端框架的异军突起,前后端分离几乎已经企业开发必须要选择的方向。但是采用了 JSP、Struts2、SpringMVC 等技术的项目在实现前后端分离时,由于 Web 容器的使用,使得前端开发人员无法专注于前台展示,分离起来困难重重。

RESTful 架构的引入,让电脑端、移动端、第三方系统的数据交互和流程控制更加便捷,也使得前后端分离成为可能。但是随着项目的推进,众多的 API 如果管理不当,在项目集成时,又将陷入泥潭。而 Swagger 的出现专注于为 API 提供可视化文档,便于前后端开发人员对接。

本场 Chat 将向读者展示 Swagger 的如下方面:

  • 为什么要用到 Swagger
  • 如何最简便的用到 Swagger
  • 基于 YAML 语法的 Swagger 实例
  • 一些 Swagger 最佳实践
  • 在 Spring-boot 中使用 Swagger

实录提要:

  • 非技术人员如何能说服开发使用 swagger?
  • swagger 和 deloyd 有什么区别?什么情况下应该使用?
  • 针对 PHP 有没有工具把 phpdoc 格式的注释转化为 swg 格式?
  • 前后分离时,前端需要明确所有的输入输出参数,这个怎么配置更方便?
  • swagger-ui、swagger-editor、swagger-api、swagger-node 能不能梳理一下?
  • 从 docker hub 上 pull swaggerapi/swagger-ui 之后,如何定制自己的模拟接口?
  • 前后端分离,假设前端部署在 node 上,后端用 springboot 如何处理认证登录?
已有153人预订
预订达标
文章出炉
交流日期
     
09月12日
09月20日
09月26日 20:30
查看文章评论/提问
筱愉
写得很详细,很受用!
刘传士
不错,很详细
冰尘
请问当后端还未完成 如何通过swagger 生成假的测试数据(mock数据)供前端调试?
冰尘
swagger和deloyd有什么区别?什么情况下应该使用swagger?什么情况下应该使用deployd? 谢谢
冰尘
如果文章能在详细一点就更好了
云中漫步: 同感
陈元
我是非技术人员,如何能说服开发使用swagger。/::<
joseph.herder💭
针对php有没有工具把phpdoc格式的注释转化为swg格式?
Geek
前后分离时,前端需要明确所有的输入输出参数,这个怎么配置更方便?
光辉岁月
读完了,好像没多大用,网上都能搜到,没新东西
冰尘
前后端分离,假设前端部署在node上 后端用Springboot 如何处理认证登陆?
你可能还喜欢
Service Mesh 在华为公有云的实践
田晓亮
利用 OpenCV 和 Caffe,根据大合影构造“平均脸”
李烨
从零开始,搭建 AI 音箱 Alexa 语音服务
Mike
Web 安全恩仇录:再谈逻辑漏洞
肖志华
TensorFlow 分布式原理与应用实践
刘光聪
编程和数学基础不佳如何入门人工智能?
赵宁|Neal
微信扫描登录