使用magic-api开发时多人协作问题

前言

前面有讲过对于小型简易项目可以使用 magic-api 快速发布 http 接口实现功能,简单使用可参考 SpringBoot整合magic-api快速发布http接口 - 掘金 (juejin.cn), 这篇文章只是给出一个示例代码,实际对于数据库, redis 等操作都是可以通过 magic-api 完成,详细的功能可以参考 简介 | magic-api (ssssssss.org), 接下来这一篇主要是对多人使用 magic-api 协作开发的个人思考梳理

低代码平台多人开发协作的难点

低代码开发平台一般都是通过页面拖拽或者在页面编写部分代码通过平台生成元数据,和源码编写还是有很大区别的,重点是元数据合并有冲突不易解决,对于低代码开发平台多人协作问题有参考了如下文章

低代码多分支协同开发的建设与实践 - 掘金 (juejin.cn)

低代码实践 | CodeWave如何支持多人协作开发应用_低代码_网易数帆_InfoQ写作社区

这些都是比较大型的低代码开发平台解决多人协作问题的思路,总结起来基本是

  • 细化任务,减少冲突的概率
  • 项目的多版本管理(对于后端同学来说基本都是使用 git 了)
  • 任务合并,若有冲突则基于可视化界面解决冲突

对于大型低代码开发平台来说,任务合并后冲突解决还是比较麻烦的,但是 magic-api 这种后端代码开发平台来说多人协作就要简单很多了,下面使用不同分支来模拟多人协作场景看看是如何基于 git 来进行版本管理

magic-api 多人协作场景模拟

生产分支代码

如下图所示,目前是 master 分支,可以认为是生产环境的代码,此时在 application.properties 中配置的 magic-api 资源地址是 magic-api.resource.location=classpath:magic-api, 这是为了保证线上代码 magic-api 接口资源的不可编辑性, 目前 resource 目录下已经有了一些接口

两个开发者创建本地分支

dev1 分支创建

现在有第一个开发者基于该项目的 master 分支开发, 基于 master 分支创建 dev1 分支,如下图所示

dev2 分支创建

新加入一个开发者,同样的还是基于 master 分支创建 dev2

dev1分支开发接口

看一下 dev1 分支 magic-api 资源目录的变化

可以看到因为包不同,所以元数据生成的目录也不同,也就是说 dev1 分支和 master 分支其实并没有冲突

dev2分支开发接口

上面 dev1 分支是创建了新的目录,接口都是在新目录中,接下来 dev2 则将接口创建在原来的目录中 此时 magic-api 资源目录结构

合并 dev1 dev2master

接下来的合并其实除了 application.propertiesmagic-api.resource.location=D:/code/test-web/src/main/resources/magic-api 这部分有冲突外,其他的都不会有任务冲突,而这部分的冲突只要合并一次后续合并也不会有冲突

总结

使用 magic-api 开发多人协作和源码开发多人协作其实差别不大,git 操作流程原来的开发模式都是一样的,只需要注意一点,即多个尽量不要开发同一个接口,因为多人开发同一个接口时,magic-api 生成的元数据就会有冲突,其他情况下基本不会有冲突,因为不同接口元数据文件不同

相关推荐
二十雨辰几秒前
[尚庭公寓]07-Knife快速入门
java·开发语言·spring
掉鱼的猫12 分钟前
Java MCP 实战:构建跨进程与远程的工具服务
java·openai·mcp
我爱Jack41 分钟前
时间与空间复杂度详解:算法效率的度量衡
java·开发语言·算法
米饭「」43 分钟前
C++AVL树
java·开发语言·c++
Zonda要好好学习1 小时前
Python入门Day4
java·网络·python
SimonKing1 小时前
告别传统读写!RandomAccessFile让你的Java程序快人一步
java·后端·程序员
Little-Hu1 小时前
QML TextEdit组件
java·服务器·数据库
Edingbrugh.南空2 小时前
Flink ClickHouse 连接器数据读取源码深度解析
java·clickhouse·flink
NE_STOP2 小时前
SpringBoot--简单入门
java·spring
hqxstudying3 小时前
Java创建型模式---原型模式
java·开发语言·设计模式·代码规范