王定福

Results 31 comments of 王定福

应该是IDEA发布的最新版本和插件有些不兼容 我这两天验证下

我这周处理下 之前一不小心把没重构完的代码提交上去了 大概下周一重新拉下代码就可以正常跑起来了

更新下 main 分支的代码 就可以了哦 前端时间比较忙 一直忘记处理了

是在idea上上传时新增的目录还是在showdoc中创建的目录啊 这两种场景我刚都没复线出来,能提供具体点的截图吗

我也用的是最新版本的插件去验证了下是没问题的 目前怀疑可能是因为你创建了两个重名的项目导致的 ![image](https://github.com/wangdingfu/fu-api-doc-plugin/assets/100477650/9e3956c2-60bc-436f-b6f4-5d7a291fe183) ![image](https://github.com/wangdingfu/fu-api-doc-plugin/assets/100477650/96fb80b0-043b-4c15-8b3a-391037631b23) 如果按照以上方案发现问题还是存在的话 麻烦在回复下 我用你这个idea的版本来验证试下。因为不同idea版本底层调用的api确实会存在一些差异

> 还有一个问题,想问一下上传以后是根据什么来判断是创建一个接口文档还是更新一个接口文档的呢。 目前showDoc是根据同一个目录下文件名称来判断的。如果名称相同则会更新这个文件。所以如果你有多个接口名称是一样的 可以吧这些接口分别放在不同的目录 或则为接口起不同的名称来区分 接口名称一般默认取的是Controller接口方法上的注释

> 是一样的 可 目前因为时间原因 还没有做用户名密码登陆实现的功能 这个用户名和密码是预留的 后期只用输入用户名和密码会直接在idea和showDoc之间做数据项目的同步。目前主要是配置每个项目的apiKey和apiToken来向showDoc项目中推送接口文档这个功能

> 还有一个问题,是当我使用了Fu Request的时候,我再次生成该接口的接口文档里面的请求示例和返回示例变成了Fu Request里面的请求参数和返回参数了。这里能改一下吗?我目前一个场景是我使用Fu Request调试的时候接口返回错误了,这个时候如果上传文档,那么文档里面的示例就变成错误示例了。当我从Fu Request里面删除这个接口请求以后,再次同步该接口就报错了。并且Fu Request里面好像没办法查看其他的接口请求,有没有一个接口请求列表呢 首先第一个问题,我最初的设计是希望在Fu Request里完成接口调试,当接口调试成功后在生成接口文档,这个时候生成的接口文档是最符合实际场景要求的,至于接口报错了建议接口调试成功后在尝试同步一次文档。第二个问题是删除这个接口请求,再次同步报错这个问题我待会儿提个issue, 在下一个版本里会修复这个问题。第三个问题Fu Request里没办法查看接口请求,在最初的设计是会吧每个接口和每一次请求记录都会存储下来,实际代码中这块也实现了一部分,但是后来要做的功能实在太多了,优先去实现一些主要的功能了,这块不是非常重要,我就暂时放在一边搁置了。后面重构整个项目时会考虑实现这个功能

> 我设置了两个不同的项目名称,但是还是不好使。 当我再次点击上传的时候,其实也不能切换项目名称,应该是因为我的作用范围不同。这是我再次创建了一个目录为test2 当我上传以后再次点击上传的时候,test2不见了 还有我记得之前点击"sync api confirm"是跳转到插件的设置里面,现在是弹出上传窗口。 ![image](https://github.com/wangdingfu/fu-api-doc-plugin/assets/100477650/bbb1435c-cd39-4ed0-9166-628ca5b75994) 应该是个bug导致的,但是我本地可能不太好复现,建议你将上图中fudoc的目录给删掉,并重新安装最新版插件。目前fudoc一些持久化的配置是保存在这个目录下的。 另外sync api confirm这个动作是打开窗口确认将文档同步至哪个具体目录的意思,所以会总是打开窗口,而sync api当一个接口之前没有同步过时,会打开窗口选择一个目录同步,第二次在同步时,不会在弹出窗口选择目录同步,而是会默认将文档同步至上一次同步过的目录中,这是sync api和sync api confirm的区别。带confirm的就是每次要确认将接口同步到哪个目录 不带的会使用历史记忆功能。另外当没有配置时,不管是sync api还是sync api confirm都会跳转到设置页面去添加配置。

> 当我换了一个电脑使用同样版本的idea安装fudoc以后是好使的了,并且当我第一次点击上传的时候,在根目录下会自动出现一个 > > xxxx > > 的目录,xxxx为控制器的注释,并且我点击“sync api confirm”也会跳转到设置界面,所以我怀疑这是一个问题导致的。不过我这两个电脑系统不一样,Mac M1 pro的电脑就出现了这个问题,换了一个win10就是好使的,可是我没更新前,Mac也是好使的。。 建议删除fudoc目录 在上一条消息中有截图回复。然后重装插件,最好是能重启idea。这个问题应该能得到解决。目前我还不能复现这种场景,后面我计划重构这个项目,会用新的存储方案替换掉现在这种存储方案来彻底解决这类问题,目前是使用idea提供的操作方案来持久化数据的,有时候内存不足或者特殊场景下会出现无法持久化的情况,导致一些莫名的bug产生。