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

作者/分享人:蒋超
向 Ta 提问
就职于花旗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 如何处理认证登录?
已有231人预订
预订达标
文章出炉
交流日期
     
17.09.12
17.09.20
17.09.26 20:30
查看文章评论/提问
冰尘
请问当后端还未完成 如何通过swagger 生成假的测试数据(mock数据)供前端调试?
筱愉
写得很详细,很受用!
刘传士
不错,很详细
冰尘
swagger和deloyd有什么区别?什么情况下应该使用swagger?什么情况下应该使用deployd? 谢谢
冰尘
如果文章能在详细一点就更好了
云中漫步: 同感
陈元
我是非技术人员,如何能说服开发使用swagger。/::<
joseph.herder💭
针对php有没有工具把phpdoc格式的注释转化为swg格式?
Geek
前后分离时,前端需要明确所有的输入输出参数,这个怎么配置更方便?
光辉岁月
读完了,好像没多大用,网上都能搜到,没新东西
冰尘
前后端分离,假设前端部署在node上 后端用Springboot 如何处理认证登陆?
你可能还喜欢
如何设计一个灵活的 MySQL 数据表,应对灵活多变的需求
李岩
Jenkins 自动化构建部署实战
火币集团研发中心
Java 程序员应掌握的 Nginx 实战应用
JPM
带你玩转 JSON
能量架构师
Python Pandas 做数据分析之玩转 Excel 报表分析
WinterLeo
小程序从入门到进阶
loonglong
微信扫描登录