magic-api 是一個(gè)基于Java的接口快速開發(fā)框架，編寫接口將通過magic-api提供的UI界面完成，自動(dòng)映射為HTTP接口，無需定義Controller、Service、Dao、Mapper、XML、VO等Java對象即可完成常見的HTTP API接口開發(fā)。

上邊是官方對工具的介紹，但好像還是沒明白它是干什么的，接下來咱們演示一下，你就會(huì)覺得它很哇塞 了

環(huán)境

首先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 配置更簡單，數(shù)據(jù)庫（沒數(shù)據(jù)庫操作可以不寫）和magic-api的基礎(chǔ)信息

magic-api:
web:/magic/web#UI請求的界面以及UI服務(wù)地址
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

好了~ 到這環(huán)境就搭建完成！

在具體演示之前先吐槽一下用Java開發(fā)API的缺點(diǎn)，首當(dāng)其沖的就是啰嗦，尤其是在工期緊，功能需快速迭代的時(shí)候，既要嚴(yán)格執(zhí)行開發(fā)規(guī)范，又不能耽誤工期，即便最簡單的一個(gè)API接口，也要寫對應(yīng)的 Controller、Service、Dao、Mapper、DTO、VO等類，盡管這些基礎(chǔ)編碼有對應(yīng)的代碼生成器，但維護(hù)起來還是相當(dāng)麻煩，magic-api起到一個(gè)很好的輔助作用，少寫了很多代碼。

實(shí)踐

直接打開magic-api可視化界面，看到如下的界面。

創(chuàng)建一個(gè)分組，其中分組前綴為一組API接口的訪問根目錄，相當(dāng)于@Controller("/order")注解。



接著在分組中創(chuàng)建接口 order_detail，頁面配置接口的基礎(chǔ)信息，接口名稱、請求路徑、請求方法、請求參數(shù)、請求header等，接口直接return返回內(nèi)容

return‘小富最帥’

在頁面訪問剛剛創(chuàng)建接口的全路徑，發(fā)現(xiàn)已經(jīng)成功返回?cái)?shù)據(jù)。

也可以直接拼JSON格式數(shù)據(jù)直接返回

如果URL傳參 /order_detail/{id}，導(dǎo)入request模塊獲取參數(shù)

importrequest;
a=path.id

到這一個(gè)簡單的API接口就開發(fā)完了，而此時(shí)我們還未在項(xiàng)目中寫一行代碼

但上邊只是靜態(tài)數(shù)據(jù)，在實(shí)際開發(fā)中往往要與數(shù)據(jù)庫打交道，magic-api提供了一些類似于python開發(fā)中的模塊化組件，例如引入import db 模塊，直接執(zhí)行SQL語句會(huì)返回JSON格式數(shù)據(jù)，省略了很多中間步驟。



magic-api語法與Java的差異不大，不過更加精簡了一些，只要寫過Java對它學(xué)習(xí)成本并不高，比如常用得for循環(huán)，也會(huì)有普通和lambda多種寫法。

varsum=0;
varlist=[1,2,3,4,5];
for(valinlist){
sum=sum+val;
}

list.each(it=>sum+=it+1)

這里我只簡單的介紹了使用，還有很多高級特性，比如：調(diào)用Java API、集成redis、Mongo等，感興趣的同學(xué)自己看下官方文檔吧，它還提供了很多語法demo，拿來即用就好。

心得

magic-api在我整個(gè)項(xiàng)目趕工期的過程中可謂是居功至偉，節(jié)省了一大半的開發(fā)時(shí)間，不僅后端開發(fā)接口效率顯著提升，對前端聯(lián)調(diào)幫助也很大。

前后端從開始就定義好數(shù)據(jù)結(jié)構(gòu)，后端快速提供靜態(tài)數(shù)據(jù)接口，前端用真實(shí)接口聯(lián)調(diào)，后端補(bǔ)充完業(yè)務(wù)邏輯后無縫替換成真實(shí)數(shù)據(jù)，這樣做到同步開發(fā)，前端也不用只寫偽代碼等接口聯(lián)調(diào)了。

magic-api雖然可以提高開發(fā)效率，但是實(shí)際應(yīng)用中我也只敢把它用在一些邏輯相對簡單，偏配置類接口，核心業(yè)務(wù)還是要按“規(guī)矩 ”辦事，畢竟系統(tǒng)穩(wěn)定、安全才是最重要的。

審核編輯：劉清