Swaggerui 感觉不好用啊~ - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
lincya
V2EX    问与答

Swaggerui 感觉不好用啊~

  •  
  • /a>
      lincya 2020-12-23 14:24:00 +08:00 1700 次点击
    这是一个创建于 1826 天前的主题,其中的信息可能已经有所发展或是发生改变。

    更新到了 knife4j

    需求: 所有的 controller 都返回了同一个响应类,如:

    public class ResData{

    int code;

    Object data;

    String message; }

    而根据不同的情况,data 里面存放不同的数据

    问题: knife4j 无法通过注解配置或其他方式,给 data 填入特定的参数 如:

    {code: 1, data:{account:"10077", username:"小明", id:"100}}

    这样的数据就难以直观地显示了

    7 条回复    2020-12-24 16:14:30 +08:00
    starlz
        1
    starlz  
       2020-12-23 17:16:22 +08:00
    你是想要 swagger 展示 data 里各个属性的说明吗?
    hly9469
        2
    hly9469  
       2020-12-23 17:18:21 +08:00 via iPhone
    所以为什么不用泛型
    starlz
        3
    starlz  
       2020-12-23 17:18:42 +08:00
    如果是的话,ResData 改成 ResData<T>; Object data 改成 T data 并在 controller 的返回方法上加上泛型,然后在对应的实体加注解就行了
    lincya
        4
    lincya  
    OP
       2020-12-24 15:32:46 +08:00
    @starlz
    @hly9469 哈哈感谢大佬
    lincya
        5
    lincya  
    OP
       2020-12-24 15:33:37 +08:00
    @starlz 请问大佬,如果我自己定义了一堆状态码,如
    lincya
        6
    lincya  
    OP
       2020-12-24 15:34:27 +08:00
    @ApiModel(description = "自定义响应状态码")
    public class ResCode {

    // 请求成功
    @ApiModelProperty(name = "0", value = "(0) 请求成功")
    public int OK = 0;

    // 失败
    @ApiModelProperty(name = "-1", value = "(-1) 请求失败")
    public int ERROR = -1;
    }

    这样的有办法放在第一问里面的 code 里面,在界面上显示出来吗
    hly9469
        7
    hly9469  
       2020-12-24 16:14:30 +08:00 via iPhone
    @lincya rescode 如果想实现你想要的效果,推荐用枚举,相应的 json 序列化时总注解标注下 jsonvalue
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     5440 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 28ms UTC 09:12 PVG 17:12 LAX 01:12 JFK 04:12
    Do have faith in what you're doing.
    ubao msn 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