项目场景:
我本是一个前端和GIS开发工程师,但新单位并没有配置完整的开发团队,确切说目前只有我一个人做开发,那么肯定避免不了要研究下后端。最近有一个小程序要开发,管理平台我直接用的fastAdmin+thinkphp写完了页面和接口。秉着持续学习的精神,小程序的接口我想试着用java写。但是我从来没有写过一行java代码,经过一系列的考察,我选择了Magic-api这个低代码开发工具来写我的首个java项目。正因为我没接触过后端,所以在配置这么一个简单的项目上我还踩了许多的坑,谨以此篇帮助类似我这样的入门选手。
MagicAPI项目下载
gitee:
https://gitee.com/ssssssss-team/magic-api
github:
https://github.com/ssssssss-team/magic-api
以上两个链接是MagicAPI的完整包,对于新手来说我还没理解项目代码。下面这个链接是示例项目,正好可以下载下来给我写接口。
https://gitee.com/ssssssss-team/magic-api-example
运行过程:
(1)示例项目下载下来后,用IDEA打开,项目的目录结构如下,红框圈定的应该是入口文件。
(2)我们对这个文件右键就可以将这个项目跑起来。
(3)得到这样的一个输出,则表示成功,端口默认的是9999,可以application.yml中修改,修改后重启项目即可。
(4)点击第三个连接,跳转到接口平台页面。
(5)在这个项目里有两个文件:application.yml和pom.xml,application.yml这个文件可以配置数据库(mysql、mongo等主流数据库,具体配置可以查阅官方文档);还可以配置多源数据库等其他配置(参考:https://ssssssss.org/magic-api/config/)。pom.xml主要修改 <dependencies> </dependencies>
内的代码(你想使用的依赖),比如mysql、swagger。
这块我没有详细研究,可以配置试试。
链接数据库:
官方文档写的很简单,建两张表就可以了,这让我这个新手是一头雾水。捣鼓了半天我都不知道怎么建数据库和表(别笑我)。后面问了做java的同事,他告诉我得下载一个数据库。既然这个项目使用的是mysql,那么我就下了一个mysql得数据库。链接如下:
https://dev.mysql.com/downloads/installer/
选择第二个下载:
安装步骤很多,其中有几步比较重要
(1)数据库密码设置,这里我使用了Magic-API里得默认密码123456789来设置的。
(2)检查链接
进行到下几步,会有一个链接测试,输入你刚刚设置的密码,测试一下能连接就成功了。
(3)mysql页面
安装完的mysql会自动打开一个页面和一个操作终端。如下:
(4)建库
在mysql里新建一个数据库,名字是:magic(别写错了数据库名字,否则代码里也要改,改哪里我还没研究过)。
(5)建表
此时我们就可以用以下SQL建表了:
mysql 建表语句
CREATE TABLE `magic_api_file` (
`file_path` varchar(512) NOT NULL,
`file_content` mediumtext,
PRIMARY KEY (`file_path`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
备份表建表语句
CREATE TABLE `magic_api_backup` (
`id` varchar(32) NOT NULL COMMENT '原对象ID',
`create_date` bigint(13) NOT NULL COMMENT '备份时间',
`tag` varchar(32) DEFAULT NULL COMMENT '标签',
`type` varchar(32) DEFAULT NULL COMMENT '类型',
`name` varchar(64) DEFAULT NULL COMMENT '原名称',
`content` blob COMMENT '备份内容',
`create_by` varchar(64) DEFAULT NULL COMMENT '操作人',
PRIMARY KEY (`id`,`create_date`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
(6)我不是很喜欢用mysql得页面,又下载了一个navicat来操作数据库。这样可以清楚的看到我刚刚建的两张表。
(7)接口平台页面建组。
这里要修改下application.yml里的配置。红框圈定的就是你建的表名,需要一致,否则建组就会报错。修改完记得重新运行下(我这前端选手总是会忽略这点)。
(8)建组。点加号,输入组名,组路径就可以了。一个类别的接口组就建好了。
(9)新建接口。
右键组,新建接口,填写接口的名称和路径。使用快捷键ctrl+s
保存后才可以访问接口的链接。
结尾:
终于搞定了,后面就开始编写接口之旅了,希望顺利。