记录一次使用LKAdoc时出现的很low很low很low的问题

前提概要:我是一枚经验很少的java小白

现在从事java开发的程序员应该大部分都知道或者正在使用swagger生成接口文档吧~

起初在使用swagger的时候确实感觉使用起来很nice~但是在随着使用次数越来越多,接口定义的不同,使我发现了swagger的一些处理不当的地方,例如返回List<Map<String,Object>>时接口文档页面就会报红红的error,再比如不能传JSONObject,只有几个参数专门写个实体类感觉没必要,但是swagger不支持JSONObject,只能传实体,还有其他就不一一阐述了。

然后在一次偶然的机会发现一款比swagger更好用的接口文档API,其实我之前是找过替代swagger的工具的,最初的时候我找时还没有可以替代swagger的,之后一次互联网闲逛随手搜了下,结果就让我发现了我下面说的这款利器。

这款利器就是刘凯大佬开发的LKADOC,LK是大佬名,A是Api,DOC是document,在看到这个利器的当时我就建个了项目上手使用,结论就两个字:真香~

我使用的时候还是凯哥刚发布的那段时间,中间还存在一些不足,在使用中我也是碰到了一些bug,好在CSDN可以直接联系到凯哥,在我说明问题后凯哥很及时的帮我解决,在此以表感谢~

然后前段时间我在项目中运用的时候出现一个很尴尬的错误,就是我本来在E盘建的项目,为了测试代码和已有代码不会混乱,所以我拷贝到桌面一份项目,之后就一直在桌面路径的项目上开发,前段时间开发基本OK后,我又把项目拷贝回原E盘,结果启动项目发现接口文档页面打不开了,后台报错找不到servlet什么的,给我整懵逼了好一会儿,各种新建项目、拷贝删除测试,都报错,属实让我烦躁了,不得已又去麻烦了凯哥,然后凯哥在下班前完美的还原了我存在的那个bug。。。。

其实那是一个很简单的问题,就是我在E盘的文件夹使用了中文,导致接口文档不可用,我试了swagger在中文目录下也可以使用就一直以为是哪里设置的问题,没想项目路径的问题,结果凯哥很快定位到了我的问题所在,这个问题凯哥之后可能会修改完善,使LKADOC支持中文路径,但是我在这里还是建议大家项目路径全部使用英文命名,以免碰到其他问题。

出现这个的原因就是我路径里有中文,改为英文后完美解决~

下面是凯哥的博客,简单好上手

https://blog.csdn.net/liukaitydn/article/details/107715778

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值