首页   注册   登录
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX  ›  程序员

Swagger 使用情况问卷调查

  •  
  •   hadixlin · 80 天前 · 3812 次点击
    这是一个创建于 80 天前的主题,其中的信息可能已经有所发展或是发生改变。

    最近我想做一个扩展 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 条附言  ·  78 天前
    做了个 springfox 的扩展项目[SpringFox-Plus]( https://github.com/hadix-lin/springfox-plus),可以读取 javadoc 作为接口文档,替代部分 swagger 注解的使用。

    项目的 README 有使用说明,请有空的朋友帮忙测试一下,提提意见。
    67 回复  |  直到 2019-08-03 12:47:16 +08:00
        1
    Ahaochan   80 天前
    A、A、null、null
        2
    zjp   80 天前
    A、A、null、null
        3
    OctopusGO   80 天前 via Android
    A、A、null、null
        4
    wym7223645   80 天前
    A、A、null、null
        5
    leon0903   80 天前
    D(Go)、C、null、nul
        6
    FreeEx   80 天前 via iPhone
    A,A,无,可自定义返回值样例。
        7
    aliensb   80 天前 via Android
    @leon0903 做 Go 的老哥不应该是 nil 吗?手动滑稽
        8
    WispZhan   80 天前
    1. A、C
    2. A、B、C (手工 Markdown/Asciidoc 文档 + B )
    3. null
    4. 最好重新定制一个 UI,v2.x 的新 UI 操作逻辑成迷,老 UI 渲染方式蛋疼,大文档就直接卡了
        9
    StarkWhite   80 天前
    A, B, null, null
        10
    arrow8899   80 天前
    A&B, B, None, None
        11
    ddddad   80 天前
    A,A,高版本的 UI 反而不那么方便,null
        12
    hadixlin   80 天前
    感谢大家参与这个问卷,到目前为止有 402 次点击,11 个回复。

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

    我也觉得新版的 ui 对文档展示不太紧凑,看起来并不十分方便,定制 ui 还是很有价值。
        13
    msaionyc   80 天前
    A、A、""、""
        14
    wugn   80 天前 via Android
    A,B,null,null
        15
    allanzhuo   80 天前
    A、A、null、null
        16
    xaplux   80 天前
    A、A、null、null
    定制 ui 貌似有个 bootstrap-ui
        17
    hadixlin   80 天前 via iPhone
    @xaplux 乍看起来是个很棒的 ui,有空试试
        18
    lingxi27   80 天前
    d b null null
        19
    xaplux   80 天前
    @hadixlin 这个我也没用过,目前我们是 spring boot + springfox-swagger,感觉还算够用
        20
    515576745   80 天前 via Android
    第一次听说 springfox
        21
    RTNelo   80 天前
    B B None None
        22
    tinytin   80 天前 via iPhone
    springfox-swagger 和 swagger api 并不完全是一个东西
        23
    hotsymbol   80 天前
    D ( Golang ),B,nill,nill
        24
    seven123   79 天前
    B B None None
        25
    monstervivi   79 天前
    A、A、null、null
        26
    IvanLi127   79 天前 via Android
    TS、NEST.JS 、Null、Null
        27
    bxqqq   79 天前
    B B redoc. None
        28
    kkkkkrua   79 天前
    SpringFox 第一次听说
    你们不觉得在代码里面些一堆注解很难看么。还是觉得用 springrestful 生成离线文档好点
        29
    90d0n   79 天前
    A、A、null、"分类排序, 接口排序, 参数排序等排序功能; 搜索功能;"
        30
    ipeony   79 天前
    AC、A、Go 直接手写 yaml、UI 好看点?
        31
    lemonEssence   79 天前
    A B null null
        32
    mirrorpen   79 天前
    D(PHP)、B、null、null
        33
    amon   79 天前
    之前用过 swagger,SpringFox 相比之前有什么变化吗?
        34
    Beeethoven   79 天前
    A B 有没有人推荐一下 yaml 的生成工具.. 手写的头皮发麻
        35
    kiddingU   79 天前
    @Beeethoven 代码直接生成咯,手写格式对齐搞死你。。。
        36
    lonfall   79 天前
    A A NULL NULL
        37
    SkyLine7   79 天前
    A A undefined undefined
        38
    ily433664   79 天前
    A、A、null、null
        39
    Encloud   79 天前
    D(Node)、B、null、null
        40
    liuxey   79 天前
    null, null, null, null

        41
    cweijan   79 天前
    Swagger 有其他的替代品吗
        42
    Rwing   79 天前
    C#、null、null、null
        43
    gerorim   79 天前 via iPhone
    B, drf-yasg, 3.x Swagger UI 缺少 JSON editor, null
        44
    ckrv2   79 天前
    A B
        45
    diferent   79 天前
    B A NULL NULL
        46
    run27017   79 天前 via iPhone
    swagger 文档我一直在用,我现在还是在用我一年前 写的项目,

    http://run27.top/swaggerhuge
        47
    Lindp   79 天前
    A、A、null、可以定制 UI
        48
    utf16   79 天前
    if(isSwagger) return;
        49
    ErrorMan   79 天前 via Android
    A, A, null, null
        50
    SmithCruise   79 天前
    A、A、null、null
        51
    hadixlin   79 天前 via iPhone
    @run27017 swaggerhuge 这个项目是做什么的?本来想体验一下的,要注册,把我挡住了
        52
    24bit   79 天前
    A、A、null、null
        53
    GavinHua   79 天前 via Android
    接口的变更记录,正打算造个轮子
        54
    secsilm   79 天前
    想问下,Python 怎么用 swagger ?
        55
    run27017   79 天前 via iPhone
    @hadixlin 模拟 swaggerhub 的,私人文档,支持团队协同。

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

    我个人是推崇从代码生成文档的,文档应当作为代码的一部分存,我想做的项目也是要简化编码中嵌入文档的工作。
        61
    hadixlin   79 天前
    @cz5424 文档是沟通工具,如果没有需要沟通的目标,那真是鸡肋。
        62
    xuanbg   78 天前
    Java,但不用 swagger,手写 md 接口文档
        63
    wo642436249   78 天前 via Android
    @hadixlin 😂我的 4 在提问啊
        64
    run27017   78 天前
    @hadixlin 嗯,其实我也一直推崇代码即文档,但一直没有找到适合的方案。

    你现在在做的东西是什么?是要造一个轮子吗?我看是 Spring 上的,我本人并不用 Spring.
        65
    arthas2234   78 天前
    A,A,null,可以方便的修改默认 url;现阶段 ui 接口排序太乱
        66
    hadixlin   78 天前
    @kkkkkrua 注解是有点儿难看,所以我想做个扩展,直接读取代码的 javadoc 作为接口文档。
        67
    hadixlin   78 天前
    @run27017 swagger 有一些第三方工具可以针对各种框架和语言自动生成文档的,springfox 就是针对 springmvc 的 swagger 文档生成工具。用了一段时间还不错,就是注解有点儿烦人,不那么好用,我想做个扩展直接读静态的 javadoc 出来作为接口文档。
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   731 人在线   最高记录 5043   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.3 · 28ms · UTC 21:41 · PVG 05:41 · LAX 14:41 · JFK 17:41
    ♥ Do have faith in what you're doing.