Swagger 使用情况问卷调查

[hadixlin]

最近我想做一个扩展 SpringFox 功能的项目，但是不知道有多少人在用 Swagger+SpringFox，故在此发起个问卷调查。

1. 您使用 Swagger 的项目采用的编程语言是什么？

   A：Java，B：Python，C：Kotlin，D：其他请补充

2. 使用 Swagger 的方式

   A：SpringMVC 配合 SpringFox，B：直接使用 Swagger 编写 API 文档，C：其他请补充

3. 其他使用情况请补充

4. 您期望 SpringFox 扩展的功能是什么

做了个 springfox 的扩展项目[SpringFox-Plus]( https://github.com/hadix-lin/springfox-plus)，可以读取 javadoc 作为接口文档，替代部分 swagger 注解的使用。

项目的 README 有使用说明，请有空的朋友帮忙测试一下，提提意见。

[Ahaochan]

A、A、null、null

[zjp]

A、A、null、null

[OctopusGO]

A、A、null、null

[wym7223645]

A、A、null、null

[leon0903]

D(Go)、C、null、nul

[FreeEx]

A，A，无，可自定义返回值样例。

[aliensb]

@leon0903 做 Go 的老哥不应该是 nil 吗？手动滑稽

[WispZhan]

1. A、C
2. A、B、C （手工 Markdown/Asciidoc 文档 + B ）
3. null
4. 最好重新定制一个 UI，v2.x 的新 UI 操作逻辑成迷，老 UI 渲染方式蛋疼，大文档就直接卡了

[StarkWhite]

A, B, null, null

[arrow8899]

A&B, B, None, None

[ddddad]

A,A,高版本的 UI 反而不那么方便，null

[hadixlin]

感谢大家参与这个问卷，到目前为止有 402 次点击，11 个回复。

可见 swagger 的用户还是挺多的。

我也觉得新版的 ui 对文档展示不太紧凑，看起来并不十分方便，定制 ui 还是很有价值。

[msaionyc]

A、A、""、""

[wugn]

A,B,null,null

[allanzhuo]

A、A、null、null

[xaplux]

A、A、null、null
定制 ui 貌似有个 bootstrap-ui

[hadixlin]

@xaplux 乍看起来是个很棒的 ui，有空试试

[lingxi27]

d b null null

[xaplux]

@hadixlin 这个我也没用过，目前我们是 spring boot + springfox-swagger，感觉还算够用

[515576745]

第一次听说 springfox

[RTNelo]

B B None None

[tinytin]

springfox-swagger 和 swagger api 并不完全是一个东西

[hotsymbol]

D （ Golang ），B，nill，nill

[seven123]

B B None None

[monstervivi]

A、A、null、null

[IvanLi127]

TS、NEST.JS 、Null、Null

[bxqqq]

B B redoc. None

[kkkkkrua]

SpringFox 第一次听说
你们不觉得在代码里面些一堆注解很难看么。还是觉得用 springrestful 生成离线文档好点

[90d0n]

A、A、null、"分类排序, 接口排序, 参数排序等排序功能; 搜索功能;"

[ipeony]

AC、A、Go 直接手写 yaml、UI 好看点？

[lemonEssence]

A B null null

[mirrorpen]

D(PHP)、B、null、null

[amon]

之前用过 swagger，SpringFox 相比之前有什么变化吗？

[Beeethoven]

A B 有没有人推荐一下 yaml 的生成工具.. 手写的头皮发麻

[kiddingU]

@Beeethoven 代码直接生成咯，手写格式对齐搞死你。。。

[lonfall]

A A NULL NULL

[SkyLine7]

A A undefined undefined

[ily433664]

A、A、null、null

[Encloud]

D(Node)、B、null、null

[liuxey]

null, null, null, null

[cweijan]

Swagger 有其他的替代品吗

[Rwing]

C#、null、null、null

[gerorim]

B, drf-yasg, 3.x Swagger UI 缺少 JSON editor, null

[ckrv2]

A B

[diferent]

B A NULL NULL

[run27017]

swagger 文档我一直在用，我现在还是在用我一年前 写的项目，

http://run27.top/swaggerhuge

[Lindp]

A、A、null、可以定制 UI

[utf16]

if(isSwagger) return;

[ErrorMan]

A, A, null, null

[SmithCruise]

A、A、null、null

[hadixlin]

@run27017 swaggerhuge 这个项目是做什么的？本来想体验一下的，要注册，把我挡住了

[24bit]

A、A、null、null

[GavinHua]

接口的变更记录，正打算造个轮子

[secsilm]

想问下，Python 怎么用 swagger ？

[run27017]

@hadixlin 模拟 swaggerhub 的，私人文档，支持团队协同。

注册只用输入用户名密码就好了，都没有验证。

[wo642436249]

1.go 、php
2.大众方式
3.nil 、null
4.我想问问用 java 只要求能做项目，能解决大多数问题，是不是简单会个 spring 就行了😂熟练了基本不用自己写代码，全都加载其他大神的包就行

[cz5424]

python 在测试用例 hook 了一下生成出了 swagger 文档，然后发现这东西没啥用，甚至觉得很鸡肋

[hadixlin]

@wo642436249 你的 4 是在讲段子吗？

[hadixlin]

@GavinHua 这个主意很棒，是不是可以结合 git 提交历史来做？

[hadixlin]

@run27017 试用了一下，喜欢直接用 Swagger 规范编写 API 文档，用这个还是挺好的。

我个人是推崇从代码生成文档的，文档应当作为代码的一部分存，我想做的项目也是要简化编码中嵌入文档的工作。

[hadixlin]

@cz5424 文档是沟通工具，如果没有需要沟通的目标，那真是鸡肋。

[xuanbg]

Java，但不用 swagger，手写 md 接口文档

[wo642436249]

@hadixlin 😂我的 4 在提问啊

[run27017]

@hadixlin 嗯，其实我也一直推崇代码即文档，但一直没有找到适合的方案。

你现在在做的东西是什么？是要造一个轮子吗？我看是 Spring 上的，我本人并不用 Spring.

[arthas2234]

A，A，null，可以方便的修改默认 url;现阶段 ui 接口排序太乱

[hadixlin]

@kkkkkrua 注解是有点儿难看，所以我想做个扩展，直接读取代码的 javadoc 作为接口文档。

[hadixlin]

@run27017 swagger 有一些第三方工具可以针对各种框架和语言自动生成文档的，springfox 就是针对 springmvc 的 swagger 文档生成工具。用了一段时间还不错，就是注解有点儿烦人，不那么好用，我想做个扩展直接读静态的 javadoc 出来作为接口文档。