如何用 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 如何处理认证登录?
已有179人预订
预订达标
文章出炉
交流日期
     
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 如何处理认证登陆?
你可能还喜欢
关于为何以及如何阅读源码的一点心得
追梦
从零开始,轻松打造你的聊天机器人
微软公开课
每周一个机器学习小项目001:全链接层实现与分类问题
如是
通过前端团队管理谈谈技术管理的技法与思想
常新居士
朋友圈爆款背后的计算机视觉技术与应用
AI科技大本营
为什么说 Java 程序员到了必须掌握 Spring Boot 的时候?
纯洁的微笑
微信扫描登录