又發(fā)現(xiàn)一款牛逼的 API 敏捷開發(fā)工具
點擊上方?java項目開發(fā),選擇?設(shè)為星標(biāo)
優(yōu)質(zhì)文章,及時送達(dá)
作者:棒錘
xie.infoq.cn/article/b5c3a339267e1351c6151b42a
初衷
用盡可能簡單的方式,完成盡可能多的需求。通過約定的方式 實現(xiàn)統(tǒng)一的標(biāo)準(zhǔn)。告別加班,拒絕重復(fù)勞動,遠(yuǎn)離搬磚
特性
用于快速開發(fā)API接口。不再定義
Controller,Service,Dao,Mybatis,xml,Entity,VO等對象和方法.可視化界面,將入?yún)⒆詣臃庋b到可執(zhí)行的腳本上,支持所有關(guān)系性數(shù)據(jù)庫SQL執(zhí)行語句,非關(guān)系型
MONGODB查詢語句.歡迎擴(kuò)展完全基于springboot2.x 作為springboot項目的stater方式集成,無侵入性,新老項目都能快速集成
只需編寫一行代碼即可完成大部分的業(yè)務(wù)需求開發(fā),使用難度級別(測試 or 運維)也可參與開發(fā)
在線動態(tài)編譯,無需重啟,即時生效,多數(shù)據(jù)源操作
版本控制,歷史記錄比對,回滾等功能
遠(yuǎn)程一鍵發(fā)布到線上環(huán)境
線上POSTMAN調(diào)試,保存POSTMAN信息或三方文檔的自動生成,歷史調(diào)用記錄存儲,回塑
代碼提示,SQL提示,語法提示
用戶管理控制,安全性控制,以及歷史行為記錄
經(jīng)過多次項目驗證,傳統(tǒng)業(yè)務(wù)型開發(fā),服務(wù)端效率能夠提升3-5倍,前后端聯(lián)調(diào)提升效率1倍,測試效率2倍提升
傳統(tǒng)開發(fā)步驟:
增加一張表
創(chuàng)建實體對象,映射這張表
創(chuàng)建API入?yún)O
創(chuàng)建API出參VO
創(chuàng)建Controller
創(chuàng)建Service
創(chuàng)建Dao
創(chuàng)建Mapper, xml或者JPA
在mysql客戶端,或者mongo客戶端中寫執(zhí)行腳本語句,復(fù)制到代碼中
反復(fù)重啟,進(jìn)行接口自測
編寫API文檔
完成一個功能點開發(fā)
使用一些工具比如mybatis plus,jpa,或者idea的Easy code,MybatisCodeHelperPro等可以一鍵生成一些基于單表的操作的相關(guān)代碼,但是業(yè)務(wù)場景來說,可能喜歡更靈活,代碼執(zhí)行效率更高的一些操作方式,并且一個項目開發(fā)中,從來不僅僅是單表的一些操作操作
市面上就上面的這些問題,提供了APIJSON和GraphQL等解決方案,這兩個工具相對操作數(shù)據(jù)庫相對很靈活,但是操作難度,和學(xué)習(xí)成本高,并且適合場景也是有限,如果要實現(xiàn)簡單的業(yè)務(wù)處理邏輯會比較復(fù)雜
那么,我希望有一種功具,它可以像mybatis xml,像metabase BI,一樣,能夠直接操作原生的數(shù)據(jù)庫查詢及操作語句,并且可以有springboot的restful這種業(yè)界標(biāo)準(zhǔn)的接口定義/及參數(shù)定義方式,并且按照統(tǒng)一約定的方式,省略三層MVC的定義,并且能夠?qū)?shù)據(jù)進(jìn)行一些邏輯處理,以滿足多元化的業(yè)務(wù)需求。最好是作為一個插件的形式,能夠很好的集成在現(xiàn)有項目中,不會影響到現(xiàn)有的業(yè)務(wù)邏輯處理
這就是我要介紹的一款工具:
https://gitee.com/alenfive/rocket-api-doc/wikis/pages
區(qū)別于前兩類的設(shè)計方式不同點在于:
基于springboot開發(fā)。包括接口的注冊,參數(shù)的獲取,輸入輸出的消息轉(zhuǎn)換,都是基于springboot的生態(tài)環(huán)境,能無侵入性集成于springboot項目中,如果你有基于springboot實現(xiàn)了全局異常處理,返回值統(tǒng)一封裝,權(quán)限控制等,不用擔(dān)心,都在你的管控范圍內(nèi)
參考于mybatis的參數(shù)定義方式,不同點在于使用默認(rèn)大于配置的邏輯,實現(xiàn)參數(shù)的注入直接來源于請求參數(shù),省略了傳統(tǒng)MVC 實體類,方法,VO等定義
默認(rèn)擔(dān)供了內(nèi)部函數(shù),可以很簡單的實現(xiàn) 多表/多庫的增/刪/改/查,導(dǎo)出,導(dǎo)入,上傳,下載,分頁查詢等功能
提供了基于Groovy的語法解析,可以實現(xiàn)Groovy的一些邏輯處理
提供了調(diào)用springboot bean對象的方法及其他任意java定義的靜態(tài)類,方法和對象,這意味著我能夠調(diào)用公共定義的類,或者之前在項目中定義的service,dao,和utils
因為基于的groovy動態(tài)語法解析,所以代碼修改,或者線上問題的處理能夠不用重啟服務(wù),也不用升級代碼就能夠完成功能開發(fā)和問題處理,這對開發(fā)效率而言會有很大的提升
傳統(tǒng)業(yè)務(wù)開發(fā),不僅有服務(wù)端的開發(fā),還有相對應(yīng)的文檔生成,前后端對接,以及測試配合。“Rocket API” 提供了POSTMAN的操作頁面,能夠?qū)?shù)的請求值,請求類型,響應(yīng)等保存起來,給予前端做真實數(shù)據(jù)的對接,而不是類yapi,或者swagger之類生成的不能使用的假數(shù)據(jù)。基于這些真實的請求參數(shù)和返回值,提供了外部接口能力,測試團(tuán)隊可以以此來做接口的一鍵冒煙測試,和文檔的一鍵生成
演示說明
1分鐘開發(fā)一個接口
第一步,創(chuàng)建接口

第二步,定義接口

第三步,接口邏輯

第四步,接口訪問測試

來源:
https://blog.csdn.net/maple_son/article/details/108196584
接口功能邏輯頁面

接口功能自測頁面

文檔和演示地址:
https://gitee.com/alenfive/rocket-api-doc/wikis/pages
集成方式:
#1. 添加依賴
<dependency>
????<groupId>com.github.alenfivegroupId>
????<artifactId>rocket-api-boot-starterartifactId>
????<version>0.0.1-SNAPSHOTversion>
dependency>
#2. 數(shù)據(jù)源配置
@Component
public?class?DefaultDataSourceManager?extends?DataSourceManager?{
????@Autowired
????private?JdbcTemplate?jdbcTemplate;
????@PostConstruct
????public?void?init()?{
????????Map<String,DataSourceDialect>?dialects?=?new?HashMap<>();
????????dialects.put("mysql",new?SqlDataSource(jdbcTemplate,true));
????????super.setDialectMap(dialects);
????}
}
#3. 最新建表腳本查看:
https://gitee.com/alenfive/rocket-api-doc/wikis/pages?sort_id=2670007&doc_id=859283
啟動項目,訪問地址:
http://localhost:8080/interface-ui
-?END - 推薦案例
溫暖提示
為了方便大家更好的學(xué)習(xí),本公眾號經(jīng)常分享一些完整的單個功能案例代碼給大家去練習(xí),如果本公眾號沒有你要學(xué)習(xí)的功能案例,你可以聯(lián)系小編(微信:xxf960513)提供你的小需求給我,我安排我們這邊的開發(fā)團(tuán)隊免費幫你完成你的案例。 注意:只能提單個功能的需求不能要求功能太多,比如要求用什么技術(shù),有幾個頁面,頁面要求怎么樣?
請長按識別二維碼
想學(xué)習(xí)更多的java功能案例請關(guān)注
Java項目開發(fā)
如果你覺得這個案例以及我們的分享思路不錯,對你有幫助,請分享給身邊更多需要學(xué)習(xí)的朋友。別忘了《留言+點在看》給作者一個鼓勵哦


