自定义头部 -->

IDEA 插件 EasyYapi

IDEA 插件 EasyYapi

通过 YAPI 的 开放 API , 首先我们会产生一个想法, 开发一个 IDEA 的插件, 产生这个想法以后, 就去先去插件市场里搜寻, 果然已经有很多大佬先一步开发好了. 这里先一步帮大家也筛选了一下, 选择了对代码 0 入侵的 EasyYapi

功能

  1. 导出http到
    • Yapi
    • Postman
    • markdown
  2. 导出rpc到
    • Yapi
    • markdown
  3. Call api 调用 API

安装

Preferences → Plugins → Marketplace → 搜索“EasyYapi” → 安装该插件 → 重启IDE

配置

进入 Preferences(Settings) > Other Settings > EasyApi > Support, 主有三项:

  • Postman token 配置
  • Yapi 配置 , 第一次导出的时候会引导配置, 这里不用手动配置
  • RPC : Support >[ √ ] methodDoc

YAPI token 获取

Postman token 获取

Postman token 获取页面

使用

  1. 导出

    选中 一个或多个 API 文件(Controller 或是 RPC Interface), 使用快捷键alt shift E(windows)/ctrl E(mac)

    选导出类型以及导出的接口, 确定后回车

    导出到 YAPI 服务

    NAnOKS.gif

    导出到 PostMan

    PostMan 是给功能强大的 工具, 应该有很多人跟我一样接口测试会习惯性依赖 PostMan

    1. postmantoken,可以从Postman Integrations Dashboard获得

    2. 可以在Preferences(Settings) > Other Settings > EasyApi 中手动配置

    3. 在 API 文件类中使用 快捷键 Ctrl+Enter 选择 ExportPostman.

    4. 反应会慢一点. 之后就会在你的PostMan 中出现

导出到Markdown

  1. Call API

在 api/rpc 文件中 使用 快捷键 Ctrl+Enter 选择 Call API , 发起对当前文件中的API的请求(有点鸡肋的功能, 不过在没有 yapi 和 postMan 的情况下可以使用)

NAhKYD.png

总结

可以看到 EasyYapi 提供了 丰富的 API 导出功能, 即使不依赖 YAPI , PostMan 也可以满足基本需求.

另外EasyYapi 对注释规范要求很高. 不过这另一方面也提高了对编码的注释规范, 有利有弊.

按照YAPI + EasyYapi 的方式书写 API . 我们一个字段的注释.在先编写代码再导出到 YAPI 的方式 , 我们只需要写一遍注释即可 .

先写完接口即可 , 后续逻辑导出后再补充也不迟 .

写在最后

还是老三样. 欢迎 点赞, 转发, 评论 ~

posted @ 2020-06-17 22:05  AllenAlan  阅读(18622)  评论(0编辑  收藏  举报