Swagger 使用情况问卷调查 - V2EX
首页 注册 登录
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
请不要在回答技术问题时复制粘贴 AI 生成的内容
hadixlin
V2EX    程序员

Swagger 使用情况问卷调查

  •   
  •   hadixlin 2019-08-01 19:21:15 +08:00 7091 次点击
    这是一个创建于 2262 天前的主题，其中的信息可能已经有所发展或是发生改变。

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

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

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

    2. 使用 Swagger 的方式

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

    3. 其他使用情况请补充

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

    第 1 条附言    2019-08-03 23:52:49 +08:00
    做了个 springfox 的扩展项目[SpringFox-Plus]( https://github.com/hadix-lin/springfox-plus)，可以读取 javadoc 作为接口文档，替代部分 swagger 注解的使用。

    项目的 README 有使用说明，请有空的朋友帮忙测试一下，提提意见。
  • swagger
  • springfox
  • 问卷调查
  • 补充
    67 条回复    2019-08-03 12:47:16 +08:00
    Ahaochan
        1
    Ahaochan  
       2019-08-01 19:40:18 +08:00
    A、A、null、null
    zjp
        2
    zjp  
       2019-08-01 19:55:19 +08:00
    A、A、null、null
    OctopusGO
        3
    OctopusGO  
       2019-08-01 20:15:32 +08:00 via Android
    A、A、null、null
    wym7223645
        4
    wym7223645  
       2019-08-01 20:43:36 +08:00
    A、A、null、null
    leon0903
        5
    leon0903  
       2019-08-01 20:46:13 +08:00
    D(Go)、C、null、nul
    FreeEx
        6
    FreeEx  
       2019-08-01 20:47:35 +08:00 via iPhone
    A，A，无，可自定义返回值样例。
    aliensb
        7
    aliensb  
       2019-08-01 20:47:47 +08:00 via Android
    @leon0903 做 Go 的老哥不应该是 nil 吗？手动滑稽
    WispZhan
        8
    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
        9
    StarkWhite  
       2019-08-01 21:02:33 +08:00
    A, B, null, null
    arrow8899
        10
    arrow8899  
       2019-08-01 21:06:14 +08:00
    A&B, B, None, None
    ddddad
        11
    ddddad  
       2019-08-01 22:02:26 +08:00
    A,A,高版本的 UI 反而不那么方便，null
    hadixlin
        12
    hadixlin  
    OP
       2019-08-01 22:08:25 +08:00
    感谢大家参与这个问卷，到目前为止有 402 次点击，11 个回复。

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

    我也觉得新版的 ui 对文档展示不太紧凑，看起来并不十分方便，定制 ui 还是很有价值。
    msaionyc
        13
    msaionyc  
       2019-08-01 22:13:13 +08:00
    A、A、""、""
    wugn
        14
    wugn  
       2019-08-01 22:18:58 +08:00 via Android
    A,B,null,null
    allanzhuo
        15
    allanzhuo  
       2019-08-01 22:45:06 +08:00
    A、A、null、null
    xaplux
        16
    xaplux  
       2019-08-01 23:08:18 +08:00
    A、A、null、null
    定制 ui 貌似有个 bootstrap-ui
    hadixlin
        17
    hadixlin  
    OP
       2019-08-01 23:50:58 +08:00 via iPhone
    @xaplux 乍看起来是个很棒的 ui，有空试试
    lingxi27
        18
    lingxi27  
       2019-08-01 23:52:30 +08:00
    d b null null
    xaplux
        19
    xaplux  
       2019-08-01 23:53:09 +08:00
    @hadixlin 这个我也没用过，目前我们是 spring boot + springfox-swagger，感觉还算够用
    515576745
        20
    515576745  
       2019-08-01 23:54:52 +08:00 via Android
    第一次听说 springfox
    RTNelo
        21
    RTNelo  
       2019-08-01 23:56:33 +08:00
    B B None None
    tinytin
        22
    tinytin  
       2019-08-02 00:38:32 +08:00 via iPhone
    springfox-swagger 和 swagger api 并不完全是一个东西
    hotsymbol
        23
    hotsymbol  
       2019-08-02 01:14:19 +08:00
    D （ Golang ），B，nill，nill
    seven123
        24
    seven123  
       2019-08-02 08:25:04 +08:00
    B B None None
    monstervivi
        25
    monstervivi  
       2019-08-02 08:45:46 +08:00
    A、A、null、null
    IvanLi127
        26
    IvanLi127  
       2019-08-02 09:16:37 +08:00 via Android
    TS、NEST.JS 、Null、Null
    bxqqq
        27
    bxqqq  
       2019-08-02 09:26:27 +08:00
    B B redoc. None
    kkkkkrua
        28
    kkkkkrua  
       2019-08-02 09:29:20 +08:00
    SpringFox 第一次听说
    你们不觉得在代码里面些一堆注解很难看么。还是觉得用 springrestful 生成离线文档好点
    BrbiwsFtd9zDGZqB
        29
    BrbiwsFtd9zDGZqB  
       2019-08-02 09:31:51 +08:00
    A、A、null、"分类排序, 接口排序, 参数排序等排序功能; 搜索功能;"
    ipeony
        30
    ipeony  
       2019-08-02 09:38:05 +08:00
    AC、A、Go 直接手写 yaml、UI 好看点？
    lemonEssence
        31
    lemonEssence  
       2019-08-02 09:40:00 +08:00
    A B null null
    mirrorpen
        32
    mirrorpen  
       2019-08-02 09:41:42 +08:00
    D(PHP)、B、null、null
    amon
        33
    amon  
       2019-08-02 09:41:53 +08:00
    之前用过 swagger，SpringFox 相比之前有什么变化吗？
    Beeethoven
        34
    Beeethoven  
       2019-08-02 10:33:46 +08:00
    A B 有没有人推荐一下 yaml 的生成工具.. 手写的头皮发麻
    kiddingU
        35
    kiddingU  
       2019-08-02 12:36:00 +08:00
    @Beeethoven 代码直接生成咯，手写格式对齐搞死你。。。
    lonfall
        36
    lonfall  
       2019-08-02 14:35:36 +08:00
    A A NULL NULL
    SkyLine7
        37
    SkyLine7  
       2019-08-02 16:06:25 +08:00
    A A undefined undefined
    lovelive1024
        38
    lovelive1024  
       2019-08-02 16:19:03 +08:00
    A、A、null、null
    Encloud
        39
    Encloud  
       2019-08-02 16:31:20 +08:00
    D(Node)、B、null、null
    liuxey
        40
    liuxey  
       2019-08-02 16:32:05 +08:00
    null, null, null, null
    cweijan
        41
    cweijan  
       2019-08-02 16:34:08 +08:00
    Swagger 有其他的替代品吗
    Rwing
        42
    Rwing  
       2019-08-02 16:53:20 +08:00
    C#、null、null、null
    gerorim
        43
    gerorim  
       2019-08-02 16:56:07 +08:00 via iPhone
    B, drf-yasg, 3.x Swagger UI 缺少 JSON editor, null
    ckrv2
        44
    ckrv2  
       2019-08-02 17:15:14 +08:00
    A B
    diferent
        45
    diferent  
       2019-08-02 17:16:24 +08:00
    B A NULL NULL
    run27017
        46
    run27017  
       2019-08-02 17:26:50 +08:00 via iPhone
    swagger 文档我一直在用，我现在还是在用我一年前 写的项目，

    http://run27.top/swaggerhuge
    Lindp
        47
    Lindp  
       2019-08-02 17:29:40 +08:00
    A、A、null、可以定制 UI
    utf16
        48
    utf16  
       2019-08-02 17:32:24 +08:00
    if(isSwagger) return;
    ErrorMan
        49
    ErrorMan  
       2019-08-02 18:50:40 +08:00 via Android
    A, A, null, null
    SmithCruise
        50
    SmithCruise  
       2019-08-02 19:27:44 +08:00
    A、A、null、null
    hadixlin
        51
    hadixlin  
    OP
       2019-08-02 20:45:23 +08:00 via iPhone
    @run27017 swaggerhuge 这个项目是做什么的？本来想体验一下的，要注册，把我挡住了
    24bit
        52
    24bit  
       2019-08-02 20:56:19 +08:00
    A、A、null、null
    GavinHua
        53
    GavinHua  
       2019-08-02 21:05:52 +08:00 via Android
    接口的变更记录，正打算造个轮子
    secsilm
        54
    secsilm  
       2019-08-02 21:12:58 +08:00
    想问下，Python 怎么用 swagger ？
    run27017
        55
    run27017  
       2019-08-02 22:09:53 +08:00 via iPhone
    @hadixlin 模拟 swaggerhub 的，私人文档，支持团队协同。

    注册只用输入用户名密码就好了，都没有验证。
    wo642436249
        56
    wo642436249  
       2019-08-02 22:20:40 +08:00 via Android
    1.go 、php
    2.大众方式
    3.nil 、null
    4.我想问问用 java 只要求能做项目，能解决大多数问题，是不是简单会个 spring 就行了熟练了基本不用自己写代码，全都加载其他大神的包就行
    cz5424
        57
    cz5424  
       2019-08-02 22:43:26 +08:00
    python 在测试用例 hook 了一下生成出了 swagger 文档，然后发现这东西没啥用，甚至觉得很鸡肋
    hadixlin
        58
    hadixlin  
    OP
       2019-08-02 23:56:33 +08:00
    @wo642436249 你的 4 是在讲段子吗？
    hadixlin
        59
    hadixlin  
    OP
       2019-08-02 23:57:37 +08:00
    @GavinHua 这个主意很棒，是不是可以结合 git 提交历史来做？
    hadixlin
        60
    hadixlin  
    OP
       2019-08-03 00:04:38 +08:00
    @run27017 试用了一下，喜欢直接用 Swagger 规范编写 API 文档，用这个还是挺好的。

    我个人是推崇从代码生成文档的，文档应当作为代码的一部分存，我想做的项目也是要简化编码中嵌入文档的工作。
    hadixli
        61
    hadixlin  
    OP
       2019-08-03 00:05:58 +08:00
    @cz5424 文档是沟通工具，如果没有需要沟通的目标，那真是鸡肋。
    xuanbg
        62
    xuanbg  
       2019-08-03 07:37:38 +08:00
    Java，但不用 swagger，手写 md 接口文档
    wo642436249
        63
    wo642436249  
       2019-08-03 07:42:48 +08:00 via Android
    @hadixlin 我的 4 在提问啊
    run27017
        64
    run27017  
       2019-08-03 08:30:08 +08:00
    @hadixlin 嗯，其实我也一直推崇代码即文档，但一直没有找到适合的方案。

    你现在在做的东西是什么？是要造一个轮子吗？我看是 Spring 上的，我本人并不用 Spring.
    arthas2234
        65
    arthas2234  
       2019-08-03 09:27:42 +08:00
    A，A，null，可以方便的修改默认 url;现阶段 ui 接口排序太乱
    hadixlin
        66
    hadixlin  
    OP
       2019-08-03 12:44:13 +08:00
    @kkkkkrua 注解是有点儿难看，所以我想做个扩展，直接读取代码的 javadoc 作为接口文档。
    hadixlin
        67
    hadixlin  
    OP
       2019-08-03 12:47:16 +08:00
    @run27017 swagger 有一些第三方工具可以针对各种框架和语言自动生成文档的，springfox 就是针对 springmvc 的 swagger 文档生成工具。用了一段时间还不错，就是注解有点儿烦人，不那么好用，我想做个扩展直接读静态的 javadoc 出来作为接口文档。
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     5970 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 48ms UTC 02:47 PVG 10:47 LAX 19:47 JFK 22:47
    Do have faith in what you're doing.
    ubao snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86