前提概要:我是一枚经验很少的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支持中文路径,但是我在这里还是建议大家项目路径全部使用英文命名,以免碰到其他问题。
出现这个的原因就是我路径里有中文,改为英文后完美解决~
下面是凯哥的博客,简单好上手