IDEA 插件上新! 生成接口文档就是这么快!

栏目:行业资讯 作者:新安网 时间:2023-09-10 06:21:37
IDEA 插件上新! 生成接口文档就是这么快! 当有接口对接需求的时候,开发终于不用再担心 API 文档难写了,也不用再一个个接口文档重新写!安装这个 IDEA 插...

IDEA 插件上新! 生成接口文档就是这么快!

当有接口对接需求的时候,开发终于不用再担心 API 文档难写了,也不用再一个个接口文档重新写!安装这个 IDEA 插件,可以一步将文档导入到 Postcat向日葵app下载汅api免费旧版。

这款插件操作简单,容易上手,能够让开发者省去API文档编写的工作,更专注于开发向日葵app下载汅api免费旧版。插件通过分析用户注释进行接口解析,最终生成接口文档并上传至 Postcat 服务器,使得开发者可以在 Postcat 上进行 API 管理和分享,提高协作能力和开发速度。

和 Swagger 有什么区别呢向日葵app下载汅api免费旧版?

Postcat 插件不会入侵到代码内部,无需添加任何jar包依赖向日葵app下载汅api免费旧版。

插件通过分析用户注释进行接口解析,最终生成接口文档并上传至 Postcat 服务器,使得开发者可以在 Postcat 上进行 API 管理和分享,提高协作能力和开发速度向日葵app下载汅api免费旧版。

Postcat 提供了多种拓展注释,如@path、@url、@method、@name、@hidden和@required,这些注释可以在设置界面进行自定义或兼容现有注释向日葵app下载汅api免费旧版。

Postcat 还提供了注释生成功能,对于没有或仅有少量注释的类和方法,开发者无需费力手动添加,该功能可以分析方法字段含义并自动生成注释向日葵app下载汅api免费旧版。开发者只需要检查或根据实际场景进行微调,即可生成一份较完善的API文档。

如果原有注释不足,Postcat 会通过添加方式补充注释,移除注释时只会移除Postcat提供的那些拓展性注释,不会破坏用户自身的注释向日葵app下载汅api免费旧版。同时,开发者还可以使用"意图"功能局部生成插件注释,并进行调整和修改。

Postcat提供了多种 API 上传方式向日葵app下载汅api免费旧版,方便开发者在不同的场景下使用:

对于首次使用Postcat的现有项目,开发者可以使用主菜单中Tools分组下的Upload Project Api Doc来完成项目级别的接口上传向日葵app下载汅api免费旧版。

对于新需求下创建的Controller,在完成接口定义后,开发者可以右键菜单,选择 Upload All Api 来进行单个文件级别全部上传,做到先有文档再有逻辑,前后端工作不再串行阻塞向日葵app下载汅api免费旧版。

对于某个部分单独接口的改动,无需全部上传,开发者可以右键菜单,选择Upload Api功能,该功能会展示当前编辑类的接口信息,并提供接口预览和接口选择界面,使得用户可以勾选需要更新或上传的目标API进行信息核对和上传向日葵app下载汅api免费旧版。

如何安装配置向日葵app下载汅api免费旧版?

IDEA 版本需大于 IntelliJ IDEA 2022.03

在 IDEA “设置-插件-Marketplace” 中搜索 Postcat,找到 Postcat 插件安装即可向日葵app下载汅api免费旧版。同时也可在IDEA插件市场上进行下载安装,本地的IDEA没有自动唤起时,可以直接把zip包拖入IDEA中即可完成安装/更新。

1.填写配置信息

首次上传需要填写配置信息,配置信息项目之间独立向日葵app下载汅api免费旧版。

配置信息获取途径:登陆 Postcat 进入项目中获取 Token、WorkspaceID 和 ProjectID向日葵app下载汅api免费旧版。

Server 默认填写:免费旧版, 用户无需修改

Token获取

3.WorkspaceID 和 ProjectID 获取

进入项目设置页面向日葵app下载汅api免费旧版,点击项目名右侧“问号”

4.StringType 决定出入参的字符串类型向日葵app下载汅api免费旧版,只有参数名一开始就是遵守驼峰规范才会发现改变,预览窗口可看到变化结果

1. 当参数名为userInfo向日葵app下载汅api免费旧版,选择 camelCase,依旧是userInfo,这是默认选项

2. 当参数名为userInfo向日葵app下载汅api免费旧版,选择 lower_underscore,会变成user_info

3. 当参数名为userInfo向日葵app下载汅api免费旧版,选择 UPPER_UNDERSCORE,会变成USER_INFO

2.注意事项

进行解析上传前,请确保 IDEA 在项目中已经构建完,相关依赖已经下载好向日葵app下载汅api免费旧版。

强烈推荐使用插件定义的注释,插件有强大的生成注释功能,强烈建议先生成插件的注释进行编辑再上传,注释可以在设置也进行自定义向日葵app下载汅api免费旧版。

在识别不到插件注释时,仅对Spring MVC、Swagger.v2和Swagger(OpenAPI).v3的注解只做部分简单支持向日葵app下载汅api免费旧版。为避免必要参数的缺失,推荐使用插件注释。

生成注释功能会对Spring MVC、Swagger.v2 和Swagger(OpenAPI).v3的注解只做部分简单支持,而不会让你重头编写向日葵app下载汅api免费旧版。

HTTP接口通过路由和请求方式判断唯一做覆盖更新处理

对于已经上传的 API,在 web 上进行过手动修改,不建议再使用上传功能,因为插件上传会覆盖掉之前的内容向日葵app下载汅api免费旧版。

在生成/手敲了插件javadoc后,对接口uri,请求方式(GET/POST)等做了修改,需要手动修改插件javadoc,否则插件还是会识别到旧的插件javadoc信息向日葵app下载汅api免费旧版。

自动生成的类注释默认会上传到默认分组,请用户自行填写真实的分组,分组通过名字识别向日葵app下载汅api免费旧版。

如多级分组,则用.隔开,比如需要把接口传到第三方分组下的用户分组,则 group-name 填写 第三方.用户向日葵app下载汅api免费旧版。

@group-name注释 支持到方法级别,默认不生成,可手动添加到方法注释,插件会帮你将当前方法存到对应分组中向日葵app下载汅api免费旧版。

项目级别的 api 扫描和上传,顶部菜单[Tools -> Upload Project Api Doc],具体使用规则看 项目级上传向日葵app下载汅api免费旧版。

生成类注释不在默认生成@required注释,只会针对有javax.validation.constraints.NotNull注解的字段才生成向日葵app下载汅api免费旧版。

不推荐使用@remark注释,插件保留了识别功能且将内容拼接到字段说明中,生成类注释不会自动生成向日葵app下载汅api免费旧版。

通过@PathVariable,POST方法默认把参数识别成 Formdata 类型,GET方法默认把参数识别成 query 类型向日葵app下载汅api免费旧版。

//标识的注释无法被识别出来,请使用/** */标识向日葵app下载汅api免费旧版。

向日葵app下载汅api免费旧版了解 Postcat:

Postcat 是一个强大的开源、跨平台(Windows、Mac、Linux、Browsers...)的 API 开发测试工具,支持 REST、Websocket 等协议(即将支持 GraphQL、gRPC、TCP、UDP),帮助你加速完成 API 开发和测试工作向日葵app下载汅api免费旧版。

Postcat 核心功能:

API 文档管理:可视化 API 设计向日葵app下载汅api免费旧版,生成 API 文档

API 测试:自动生成测试参数向日葵app下载汅api免费旧版,自动生成测试用例,可视化数据编辑

插件拓展:众多插件扩展产品功能向日葵app下载汅api免费旧版,打造属于你和团队的 API 开发平台

Mock:根据文档自动生成 Mock,或创建自定义 Mock 满足复杂场景

团队协作:既能实现 API 分享也能可以创建云空间共同协作

Postcat 优势:

免登录即可测试:省去繁琐的验证登录的操作

界面简洁:没有冗余的功能与复杂选项

免费:中小团队以及个人使用

丰富的插件:支持数据迁移、主题、API 安全等高达 25 款插件

国产:能更好的理解国内用户的需求向日葵app下载汅api免费旧版,与开发团队沟通无障碍

完善的用户文档:跟着操作就能快速上手

多提 Issue !多反馈向日葵app下载汅api免费旧版!

在使用过程中有任何疑问向日葵app下载汅api免费旧版,可以进***流,也可以在线提 Issue(强烈推荐这种开源的方式),提问题本身就已经在贡献社区了:

如果喜欢向日葵app下载汅api免费旧版,不妨 Star 支持一下

这个项目是开源的向日葵app下载汅api免费旧版,如果你觉得这个项目还不错的话,不妨点个 Star 支持一下!

Github :

阅读:1次

相关文章

gif制作软件大全-gif制作软件哪个好

gif制作软件大全是小编为各位小伙伴们收集准备的关于gif制作软件的下载专题。gif制作软件大全可以帮助用户制作出各种好看的gif动态...
2023-10-02

gif录制软件大全-gif录制软件哪个好

gif录制软件大全是小编为大家推荐的一些好用的gif录制软件下载合集。gif录制软件大全可以让我们将需要的画面录制成gif动图,非常清...
2023-10-02

手机杀毒软件大全-手机杀毒软件哪个好

手机杀毒软件大全是小编给大家收集并整理的手机杀毒软件的汇总。手机杀毒软件大全可以检测到我们手机中潜伏的木马病毒,从而一键杀...
2023-10-02

ico图标制作大全-ico图标制作哪个好

ico图标制作大全是小编收集的一些比较好用的ico图标制作软件合集。ico图标制作大全可以快速制作出ico格式的图片,操作方法也十分简...
2023-10-02

H5页面制作工具大全-H5页面制作工具哪个好

H5页面制作工具大全是小编整理的几款好用的H5页面制作软件合集,满足不同用户的使用需求。H5页面制作工具大全可以帮助用户快速制作...
2023-10-02

Flash动画制作大全-Flash动画制作哪个好

Flash动画制作大全是小编为各位小伙伴推荐的一些好用的flash动画制作软件,为用户提供了大量同类软件下载。Flash动画制作大全主要用...
2023-10-01

AutoCAD软件大全-AutoCAD软件哪个好

AutoCAD软件是一款专业的计算机绘图软件,用于二维绘图、详细绘制、设计文档和基本三维设计。AutoCAD软件具有广泛的适应性,可以在...
2023-10-01

FTP工具大全-FTP工具哪个好

FTP工具大全是小编为大家带来的最好用ftp工具下载合集。FTP工具大全允许用户在计算机之间轻松地传输文件,同时还可以提供文件的管理...
2023-10-01

分类栏目