【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

API 小达人
• 阅读 236

省流版:

Eolink 有 IDEA 插件吗?

有,而且遥遥领先!我们在一年半之前就发布了,而且功能更丰富!

IDEA 插件市场搜索“Eolink Apikit”即可安装使用。

🚀 使用指引: https://plugins.jetbrains.com/plugin/19189-eolink/jie-shao

前不久用户群内有热心用户发出了这样的一个疑问“建议开发一个零代码入侵的,自动生成接口的 Idea插件 "

某个 潜水窥屏 深入调研用户需求的产品经理看到后一惊,居然还有开发同学不知道 Eolink 是国内首家上线 IDEA 插件的商业平台?😢

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

😢 都怪我们,跟华为一样不开发布会就把插件上线了。Eolink 的 IDEA 免费 插件 早在 2022 年 3 月就已经上线 IDEA 插件市场了,至今早有一年半的时间了,我们的产研团队一直默默更新,忘记告诉大家了。

今天给大家重新详细地介绍一下 Eolink Apikit 的 IDEA 插件能力~

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

Eolink 自 2016 年发布以来,就一直在 API 全生命周期管理领域深耕。在整个全生命周期的流程中,首要解决的问题是如何基于已有的历史数据转成标准规范的 API 文档,并在统一的文档仓库中管理起来。

Eolink 很早前就提供 多种生成 API 文档的方式了:

1. 手工录入或导入对应协议文件

支持 HTTP / Websocket / TCP / UDP / HSF / Dubbo / gRPC / SOAP等

2. 导入其他 API 管理平台数据

支持 Postman / Swagger / Jmeter / Yapi / ApiDoc / HAR / RAP / Apipost / Apifox / ShowDoc 等

3. 基于 Swagger URL 一键同步

4. 基于 git 仓库 URL 一键同步

支持 gitlab / github / gitee 等

5. 基于数据库表生成

支持 MySQL / Oracle / Redis / SQL Server / MongoDB / PostgreSQL / AnalyticDb / MariaDB 等

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

以上的这些生成 API 文档方式能适配大部分用户的使用场景,对于项目初期或者进行大规模数据迁移时也十分好用。但是在项目接口迭代过程中,这些方法就显得有点“笨重”。

对于开发同学来说,无论是新增还是修改接口文档,都需要在开发工具和接口管理工具上同步最新的数据。而且接口文档变更内容会比较琐碎和频繁。

那么是否有更轻便的同步接口数据方式呢?

我们提供了一个高效方案:

在开发工具上基于接口代码片段,一键生成 API 文档,支持在开发工具中调试,并可一键上传至 Eolink Apikit 的代码仓库中。

这样不仅可以减少界面的操作和系统间的切换,还可以在开发工具上完成琐碎和频繁的接口文档更新,是当前 CODE TO API 的最佳实践

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

如上图的业务流程展示,后端工程师其所有任务均可通过 IDEA 插件在 IDEA 开发工具中完成,无需跨系统跨平台,满足频繁零散更新的场景。

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

在传统的 CODE TO API 场景下,就无法不聊 Swagger 提供的解决方案了。Swagger 通过预先填写代码注解,然后再通过解析,实现了代码生成API文档的能力。

那么对比 Swagger ,Eolink Apikit 的 IDEA 插件又有什么优势呢?

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

1. 核心区别是无代码侵入

Eolink Apikit 插件与 Swagger 最大的差异在于代码侵入性上。Swagger 的运行机制决定了其需要通过在代码文件中编写注解、配置、描述等信息才能生效,一定程度上会对代码产生侵入性的影响。

Eolink Apikit 提供的 IDEA 插件方案是可通过 Java 文件的方法出入参进行解析,自动生成 API 文档的。也就是说可以在不填写任何的注解的情况下,使用 Eolink 的插件生成 API 文档。

2. 兼容多种注解,自动补全

毕竟 Swagger 是全球热门的传统 API 管理工具,部分旧代码可能已经编写了 Swagger 注解,对于这些注解 Eolink Apikit 插件也会进行兼容,作为解析接口能力的重要补充信息。

除了对 Swagger 的 V2 版本和 V3 版本注解支持外,我们还支持 Spring MVC 注解、 JavaDoc注释、Eolink注释和Dubbo注解,使得插件的适配场景更广。

如果现有的注释不全,插件还会根据对Java文件的分析,自动生成注释进行补全。

3. 更全面的协议支持

Swagger 一般仅支持 HTTP 协议,而 Eolink Apikit 插件除了支持 HTTP 协议外,还支持 Dubbo 和 HSF 协议的上传。并且后续会逐步拓宽支持更多协议类型。

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

从 2021 年开始,API 管理领域出现了一些新的优秀工具,最近一年也有很多用户希望了解 Eolink Apikit 与市面上其他同类产品能力区别。本文把对比的范围控制在插件能力给大家一个参考,Eolink Apikit 的 IDEA 插件优势在哪里?

🚀 全自研插件能力更适配

Eolink Apikit 的 IDEA 插件是完全自研的,于 2022 年 3 月 19 日上线。

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

插件研发的缘由最早是 Eolink 内部某研发线的后端同学自己编写的一些脚本,然后团队投入大量人力进行补全优化成插件,并内部运行稳定后上架到插件市场的。经过一年半的时间,Eolink 的 IDEA 插件已经获得超过17万下载量(IDEA 市场同类插件下载量排名第一),其稳定性、业务适配能力已经过大量的企业级开发团队使用和验证。

经过调研,我们可以发现市面同类产品的插件均是通过“开源插件改造”或者“开源+用户共创”的模式研发而来的。虽然这种开发模式能够很大程度上节省研发成本以及插件的研发时间。但是开源插件与自生平台的兼容性问题是不可避免的。

开源插件落后能力与 IDEA 插件新体系的矛盾冲突:

同类插件基本都是从开源插件“easy-api”进行改造上线的,但是使用“esay-api”改造的插件会面临一个核心问题是拓展能力差。

📌 划重点:

easy-api 开源插件是 18 年发布的第一个版本,并在 19 年 9 月份推出正式版本。而 IDEA 插件体系在 2020 年则进行了一次大革新,大部分核心接口都进行了调整并支持了更多新的能力。

所以用 2020 年前的接口能力来做的“esay-api”插件本身就很难支持更多的能力拓展和更好的使用体验。我们可以发现“开源魔改”这类型插件一直在改善和优化原开源插件的兼容性问题,这点可以从同类插件的历史更新记录上得到印证。

为什么我们坚持全自研 IDEA 插件?

与开源插件改版而来的 IDEA 插件相比,原生自主研发的插件在拓展能力和兼容能力会更胜一筹,同时也避免了插件能力与业务场景不适配的问题。

相对采用开源改版的开发模式而言,纵使全自研前期的研发成本会更大,从 0 开始会更加难,Eolink Apikit 仍然选择走完全自主研发的产品策略。IDEA插件的每一行代码都倾注了研发团队心血,使得我们的插件可以提供更多的服务和场景能力,真正地帮助开发者用户提升 API 研发效能。

我们把同类 IDEA 插件产品在 IDEA 插件市场的相关数据整理如下:

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

Eolink Apikit 的 IDEA 插件上线时间最早用户验证最多,并且代码完全自主研发,在业务适配能力上有充足公正的第三方平台可视化数据证明, Eolink Apikit 的 IDEA 插件早已在私有化交付中使用,已被多个研发规模超 10000 人的企业客户验证。

🎉 功能多样更强大

目前市面上同类插件提供能力比较接近 Swagger,更多的仅仅调整了上传到对应平台的能力;而 Eolink Apikit 不满足于此,我们提供了更多样的能力支持:

  • 零注解生成:目前同类插件需要编写注解才能生成 API 文档,无法支持零注解生成,以及自动生成注释的能力。

  • RPC类型接口生成: Eolink Apikit 支持 Dubbo 和 HSF 的协议接口生成,后续还会逐步支持更多接口协议。

  • 注释拓展: 为了支持更多自定义的场景,Eolink Apikit 插件提供了更多业务拓展注释,可以在设置界面添加自定义注释或兼容现有注释。

  • 多种上传方式: Eolink 关注开发者更多的使用场景,提供完整项目级别扫描上传、新接口定义上传、接口部分变更属性上传等多种不同层级的上传方式,使用更便捷更随心所欲。

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

Eolink Apikit 的 IDEA 插件,是国内商业平台中最早发布的 API 管理插件,代码完全自主研发,功能多样且安全稳定。

希望经过本文,可以让大家了解我们 “未开发布会先上线”IDEA 插件,最后,Eolink Apikit 提供的插件是免费的,更多安装使用说明可以查阅:https://plugins.jetbrains.com/plugin/19189-eolink/jie-shao

【遥遥领先】Eolink IDEA 插件:零代码入侵,自动生成接口

点赞
收藏
评论区
推荐文章
雷厉风行 雷厉风行
1年前
Mac程序员开发必备-Dash for Mac 自带激活版-全语言文档手册速查
DashforMac是一款由Kapeli公司开发的API文档和代码片段管理工具。它是一款全功能、高效、智能的开发环境,为开发人员提供了各种开发工具,包括API文档、代码片段、文档搜索等工具,可以协助开发人员快速查找和管理其相关的API文档和代码片段。
liam liam
1年前
程序员的摸鱼加速器!
最近趁摸鱼时间体验了一款神器,堪称后端前端们的摸鱼加速器,测试们的寿命催化剂。那就是:Apifox。中国自主研发的集文档、接口调试、Mock、接口自动化测试一体的协作平台。一套系统、一份数据,可解决多个系统之间的数据同步问题。定义好接口文档,则接口调试、数据Mock、接口测试就可以直接使用,无需再次定义;接口文档和接口开发调试也可以同一个工具,接口调试完成后
liam liam
1年前
怎么写一份好的接口文档?
编写一份优秀的接口文档会让软件开发中变得更加轻松,更有效率。这可是关键任务,写得好不仅可以帮助开发人员更好地理解和使用API接口,还可以提高整个团队的协作效率。大家可以在线感受一下优秀的接口文档是怎样的:https://petstore.apifox.cn
API 小达人 API 小达人
8个月前
如何进行自动化测试,提高测试效率?
作为测试人员,在进行比较大的项目时,使用自动化测试能帮助我们事半功倍地完成测试工作,提高测试效率,缩短开发周期。EolinkApikit为测试工程师提供API文档管理、快速接口调试、测试用例管理、及自动化测试等功能。协作测试工程师快速查看API文档及变更,以及更快的进行接口测试和自动化测试工作,降低测试用例编辑成本,提升自动化测试效率。
API 小达人 API 小达人
8个月前
「实用技巧」后端如何使用 Eolink Apikit 快速调试接口?
程序员最讨厌的两件事:1.写文档;别人不写文档。写文档、维护文档比较麻烦,而且费时,还会经常出现API更新了,但文档还是旧的,各种同步不一致的情况,从而耽搁彼此的时间,大多数开发人员不愿意写API文档。EolinkApikit为后端工程师提供API文档的创建与自动化生成、快速接口调试、以及API文档版本管理功能,协助后端工程师快速编写文档,调试接口,以及支持版本控制恢复历史记录。通过一套系统、一份数据,解决多个系统之间的数据同步问题。只要定义好接口文档,接口调试、数据Mock、接口测试就可以直接使用,无需再次定义。接口文档和接口开发调试使用同一个工具,接口调试完成后即可保证和接口文档定义完全一致。高效、及时、准确!
API 小达人 API 小达人
7个月前
使用 Eolink Apikit 进行 HTTP 接口测试
HTTP是互联网上应用最广泛的一种网络传输协议,所有的www文件都必须遵守这个标准。因此,在软件开发过程中,HTTP接口测试是必不可少的一环。传统的HTTP接口测试需要编写大量的测试代码,这对于开发人员来说是一项繁琐且耗时的工作。EolinkApikit是一款基于API文档的自动化HTTP接口测试工具,可以帮助开发人员快速、高效地完成HTTP接口测试。在本文中,我们将介绍EolinkApikit的HTTP接口测试流程,帮助开发人员快速入门。
API 小达人 API 小达人
7个月前
Eolink Apikit「 零代码」快速发起 RPC 接口自动化测试
RPC(RemoteProcedureCall)远程过程调用,是一种通过网络从远程计算机程序上请求服务,而不需要了解底层网络技术的协议。RPC的核心思想是将远程服务抽象成一个接口,客户端通过调用这个接口,就可以实现对远程服务的访问。EolinkApikit支持多协议,RPC、DUBBO、HTTP、REST、Websocket、gRPC、TCP、UDP、SOAP、HSF等。零代码快速发起RPC接口自动化测试,可以根据RPC接口文档自动生成测试用例,开发者只需简单修改即可使用。
API 小达人 API 小达人
7个月前
Eolink Apikit 快速发起 API 测试,一键生成测试数据
我们在测试接口时,通常需要先创建API文档,再根据API文档生成测试用例。未创建该接口文档,仅临时调试接口,EolinkApikit支持创建API快速测试页面,输入接口相关的信息即可进行快速测试。EolinkApikit支持操作数据库,API测试时,可以一键生成测试请求数据。这可以减少数据输入步骤,提高调试接口效率。
liam liam
1年前
横空出世!IDEA 版 API 接口神器来了,一键生成文档!
每个开发都不想写文档。当你不想写接口文档时,可以通过安装插件在IDEA里实现自动同步,一边写代码一边同步接口文档给你的前端、测试同学。以下内容手把手教你怎么操作(这里仅面向使用IDEA编辑器、遵循JavaSpring框架注释规范的同学):首先,你需要安装一
API 小达人 API 小达人
9个月前
【前端小技巧】如何使用 Eolink Apilkit 调用 Mock
在开发过程中,进度比较赶的情况下,前端人员当页面写完时,后台的接口还没写完,等要交付的时候后端才把接口给你,这个时候就很尴尬。这个时候Mock就可以很好的解决这个问题,前端团队可以在API还没开发完成的情况下,借助MockAPI实现预对接,加速开发进程。测试团队可以通过MockAPI解决不必要的系统,完成集成测试。EolinkApikit为前端工程师提供API文档管理,快速接口测试,以及MockAPI创建与调用,及查看文档变更历史的能力。有助于前端工程师快速查看API文档详情与历史记录,快速生成和使用MockAPI提前进行页面效果验证。