Java开发 API接口用magic-api会如何

magic-api 是一个基于java培训的接口快速开发框架,编写接口将通过magic-api提供的UI界面完成,自动映射为HTTP接口,无需定义Controller、Service、Dao、Mapper、XML、VO等Java对象即可完成常见的HTTP API接口开发。
环境
首先pom.xml 引入magic-api核心包magic-api-spring-boot-starter

org.ssssssss magic-api-spring-boot-starter 0.7.1



mysql mysql-connector-java runtime


application.yml 配置更简单,数据库(没数据库操作可以不写)和magic-api的基础信息
magic-api:
web: /magic/web # UI请求的界面以及UI服务地址
server:
port: 9999
spring:
datasource:
driver-class-name: com.mysql.jdbc.Driver password: xinzhifu521 url: jdbc:mysql://47.93.6.5:3306/magic-api username: root

好了~ 到这环境就搭建完成!
在具体演示之前先吐槽一下用Java开发API的缺点,首当其冲的就是啰嗦,尤其是在工期紧,功能需快速迭代的时候,既要严格执行开发规范,又不能耽误工期,即便最简单的一个API接口,也要写对应的 Controller、Service、Dao、Mapper、DTO、VO等类,尽管这些基础编码有对应的代码生成器,但维护起来还是相当麻烦,magic-api起到一个很好的辅助作用,少写了很多代码。
实践
打开magic-api可视化界面,看到如下的界面。
Java开发 API接口用magic-api会如何
文章图片

创建一个分组,其中分组前缀为一组API接口的访问根目录,相当于@Controller("/order")注解。
Java开发 API接口用magic-api会如何
文章图片

接着在分组中创建接口 order_detail,页面配置接口的基础信息,接口名称、请求路径、请求方法、请求参数、请求header等,接口直接return返回内容
return ‘小富最帅’
Java开发 API接口用magic-api会如何
文章图片

在页面访问刚刚创建接口的全路径,发现已经成功返回数据。
Java开发 API接口用magic-api会如何
文章图片

也可以直接拼JSON格式数据直接返回
Java开发 API接口用magic-api会如何
文章图片

如果URL传参 /order_detail/{id},导入request模块获取参数
import request;
a = path.id
到这一个简单的API接口就开发完了,而此时我们还未在项目中写一行代码
Java开发 API接口用magic-api会如何
文章图片

但上边只是静态数据,在实际开发中往往要与数据库打交道,magic-api提供了一些类似于python开发中的模块化组件,例如引入import db 模块,直接执行SQL语句会返回JSON格式数据,省略了很多中间步骤。
Java开发 API接口用magic-api会如何
文章图片

magic-api语法与Java的差异不大,不过更加精简了一些,只要写过Java对它学习成本并不高,比如常用得for循环,也会有普通和lambda多种写法。
var sum = 0;
var list = [1,2,3,4,5];
for(val in list){
sum = sum + val;

}
【Java开发 API接口用magic-api会如何】list.each(it => sum+= it + 1)
这里我只简单的介绍了使用,还有很多高级特性,比如:调用Java API、集成redis、Mongo等,感兴趣的同学自己看下官方文档吧,它还提供了很多语法demo,拿来即用就好。

    推荐阅读