Swagger 使用情况问卷调查

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

这是一个创建于 1942 天前的主题，其中的信息可能已经有所发展或是发生改变。

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

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

A：Java，B：Python，C：Kotlin，D：其他请补充
使用 Swagger 的方式

A：SpringMVC 配合 SpringFox，B：直接使用 Swagger 编写 API 文档，C：其他请补充
其他使用情况请补充
您期望 SpringFox 扩展的功能是什么

第 1 条附言 · 2019-08-03 23:52:49 +08:00

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

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

67 条回复 • 2019-08-03 12:47:16 +08:00

Ahaochan

2019-08-01 19:40:18 +08:00

A、A、null、null

zjp

2019-08-01 19:55:19 +08:00

A、A、null、null

OctopusGO

2019-08-01 20:15:32 +08:00 via Android

A、A、null、null

wym7223645

2019-08-01 20:43:36 +08:00

A、A、null、null

leon0903

2019-08-01 20:46:13 +08:00

D(Go)、C、null、nul

FreeEx

2019-08-01 20:47:35 +08:00 via iPhone

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

aliensb

2019-08-01 20:47:47 +08:00 via Android

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

WispZhan

2019-08-01 20:50:08 +08:00

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

StarkWhite

2019-08-01 21:02:33 +08:00

A, B, null, null

arrow8899

2019-08-01 21:06:14 +08:00

A&B, B, None, None

ddddad

2019-08-01 22:02:26 +08:00

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

hadixlin

2019-08-01 22:08:25 +08:00

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

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

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

msaionyc

2019-08-01 22:13:13 +08:00

A、A、""、""

wugn

2019-08-01 22:18:58 +08:00 via Android

A,B,null,null

allanzhuo

2019-08-01 22:45:06 +08:00

A、A、null、null

xaplux

2019-08-01 23:08:18 +08:00

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

hadixlin

2019-08-01 23:50:58 +08:00 via iPhone

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

lingxi27

2019-08-01 23:52:30 +08:00

d b null null

xaplux

2019-08-01 23:53:09 +08:00

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

515576745

2019-08-01 23:54:52 +08:00 via Android

第一次听说 springfox

RTNelo

2019-08-01 23:56:33 +08:00

B B None None

tinytin

2019-08-02 00:38:32 +08:00 via iPhone

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

hotsymbol

2019-08-02 01:14:19 +08:00

D （ Golang ），B，nill，nill

seven123

2019-08-02 08:25:04 +08:00

B B None None

monstervivi

2019-08-02 08:45:46 +08:00

A、A、null、null

IvanLi127

2019-08-02 09:16:37 +08:00 via Android

TS、NEST.JS 、Null、Null

bxqqq

2019-08-02 09:26:27 +08:00

B B redoc. None

kkkkkrua

2019-08-02 09:29:20 +08:00

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

90d0n

2019-08-02 09:31:51 +08:00

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

ipeony

2019-08-02 09:38:05 +08:00

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

lemonEssence

2019-08-02 09:40:00 +08:00

A B null null

mirrorpen

2019-08-02 09:41:42 +08:00

D(PHP)、B、null、null

amon

2019-08-02 09:41:53 +08:00

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

Beeethoven

2019-08-02 10:33:46 +08:00

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

kiddingU

2019-08-02 12:36:00 +08:00

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

lonfall

2019-08-02 14:35:36 +08:00

A A NULL NULL

SkyLine7

2019-08-02 16:06:25 +08:00

A A undefined undefined

ily433664

2019-08-02 16:19:03 +08:00

A、A、null、null

Encloud

2019-08-02 16:31:20 +08:00

D(Node)、B、null、null

liuxey

2019-08-02 16:32:05 +08:00

null, null, null, null

cweijan

2019-08-02 16:34:08 +08:00

Swagger 有其他的替代品吗

Rwing

2019-08-02 16:53:20 +08:00

C#、null、null、null

gerorim

2019-08-02 16:56:07 +08:00 via iPhone

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

ckrv2

2019-08-02 17:15:14 +08:00

A B

diferent

2019-08-02 17:16:24 +08:00

B A NULL NULL

run27017

2019-08-02 17:26:50 +08:00 via iPhone

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

http://run27.top/swaggerhuge

Lindp

2019-08-02 17:29:40 +08:00

A、A、null、可以定制 UI

utf16

2019-08-02 17:32:24 +08:00

if(isSwagger) return;

ErrorMan

2019-08-02 18:50:40 +08:00 via Android

A, A, null, null

SmithCruise

2019-08-02 19:27:44 +08:00

A、A、null、null

hadixlin

2019-08-02 20:45:23 +08:00 via iPhone

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

24bit

2019-08-02 20:56:19 +08:00

A、A、null、null

GavinHua

2019-08-02 21:05:52 +08:00 via Android

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

secsilm

2019-08-02 21:12:58 +08:00

想问下，Python 怎么用 swagger ？

run27017

2019-08-02 22:09:53 +08:00 via iPhone

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

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

wo642436249

2019-08-02 22:20:40 +08:00 via Android

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

cz5424

2019-08-02 22:43:26 +08:00

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

hadixlin

2019-08-02 23:56:33 +08:00

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

hadixlin

2019-08-02 23:57:37 +08:00

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

hadixlin

2019-08-03 00:04:38 +08:00

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

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

hadixlin

2019-08-03 00:05:58 +08:00

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

xuanbg

2019-08-03 07:37:38 +08:00

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

wo642436249

2019-08-03 07:42:48 +08:00 via Android

@hadixlin 😂我的 4 在提问啊

run27017

2019-08-03 08:30:08 +08:00

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

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

arthas2234

2019-08-03 09:27:42 +08:00

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

hadixlin

2019-08-03 12:44:13 +08:00

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

hadixlin

2019-08-03 12:47:16 +08:00

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