作者：棒錘

來源：xie.infoq.cn/article/b5c3a339267e1351c6151b42a_

初衷

用盡可能簡單的方式，完成盡可能多的需求。通過約定的方式 實(shí)現(xiàn)統(tǒng)一的標(biāo)準(zhǔn)。告別加班，拒絕重復(fù)勞動，遠(yuǎn)離搬磚

特性

1. 用于快速開發(fā)API接口。不再定義Controller,Service,Dao,Mybatis,xml,Entity,VO等對象和方法.

2. 可視化界面，將入?yún)⒆詣臃庋b到可執(zhí)行的腳本上，支持所有關(guān)系性數(shù)據(jù)庫SQL執(zhí)行語句，非關(guān)系型MONGODB查詢語句.歡迎擴(kuò)展

3. 完全基于springboot2.x 作為springboot項(xiàng)目的stater方式集成,無侵入性，新老項(xiàng)目都能快速集成

4. 只需編寫一行代碼即可完成大部分的業(yè)務(wù)需求開發(fā)，使用難度級別（測試 or 運(yùn)維）也可參與開發(fā)

5. 在線動態(tài)編譯，無需重啟，即時生效，多數(shù)據(jù)源操作

6. 版本控制,歷史記錄比對，回滾等功能

7. 遠(yuǎn)程一鍵發(fā)布到線上環(huán)境

8. 線上POSTMAN調(diào)試,保存POSTMAN信息或三方文檔的自動生成，歷史調(diào)用記錄存儲，回塑

9. 代碼提示，SQL提示，語法提示

10. 用戶管理控制，安全性控制，以及歷史行為記錄

11. 經(jīng)過多次項(xiàng)目驗(yàn)證，傳統(tǒng)業(yè)務(wù)型開發(fā)，服務(wù)端效率能夠提升3-5倍，前后端聯(lián)調(diào)提升效率1倍，測試效率2倍提升

傳統(tǒng)開發(fā)步驟:

1. 增加一張表

2. 創(chuàng)建實(shí)體對象，映射這張表

3. 創(chuàng)建API入?yún)O

4. 創(chuàng)建API出參VO

5. 創(chuàng)建Controller

6. 創(chuàng)建Service

7. 創(chuàng)建Dao

8. 創(chuàng)建Mapper, xml或者JPA

9. 在mysql客戶端，或者mongo客戶端中寫執(zhí)行腳本語句，復(fù)制到代碼中

10. 反復(fù)重啟，進(jìn)行接口自測

11. 編寫API文檔

12. 完成一個功能點(diǎn)開發(fā)

使用一些工具比如mybatis plus，jpa，或者idea的Easy code,MybatisCodeHelperPro等可以一鍵生成一些基于單表的操作的相關(guān)代碼，但是業(yè)務(wù)場景來說，可能喜歡更靈活，代碼執(zhí)行效率更高的一些操作方式,并且一個項(xiàng)目開發(fā)中，從來不僅僅是單表的一些操作操作

市面上就上面的這些問題，提供了APIJSON和GraphQL等解決方案,這兩個工具相對操作數(shù)據(jù)庫相對很靈活，但是操作難度，和學(xué)習(xí)成本高，并且適合場景也是有限，如果要實(shí)現(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àng)目中，不會影響到現(xiàn)有的業(yè)務(wù)邏輯處理

這就是我要介紹的一款工具 Rocket API

https://gitee.com/alenfive/rocket-api-doc/wikis/pages

區(qū)別于前兩類的設(shè)計(jì)方式不同點(diǎn)在于:

1. 基于springboot開發(fā)。包括接口的注冊，參數(shù)的獲取，輸入輸出的消息轉(zhuǎn)換，都是基于springboot的生態(tài)環(huán)境，能無侵入性集成于springboot項(xiàng)目中，如果你有基于springboot實(shí)現(xiàn)了全局異常處理，返回值統(tǒng)一封裝，權(quán)限控制等，不用擔(dān)心，都在你的管控范圍內(nèi)

2. 參考于mybatis的參數(shù)定義方式，不同點(diǎn)在于使用默認(rèn)大于配置的邏輯，實(shí)現(xiàn)參數(shù)的注入直接來源于請求參數(shù)，省略了傳統(tǒng)MVC 實(shí)體類，方法，VO等定義

3. 默認(rèn)擔(dān)供了內(nèi)部函數(shù)，可以很簡單的實(shí)現(xiàn) 多表/多庫的增/刪/改/查，導(dǎo)出，導(dǎo)入，上傳，下載，分頁查詢等功能

4. 提供了基于Groovy的語法解析，可以實(shí)現(xiàn)Groovy的一些邏輯處理

5. 提供了調(diào)用springboot bean對象的方法及其他任意java定義的靜態(tài)類，方法和對象，這意味著我能夠調(diào)用公共定義的類，或者之前在項(xiàng)目中定義的service,dao,和utils

6. 因?yàn)榛诘膅roovy動態(tài)語法解析，所以代碼修改，或者線上問題的處理能夠不用重啟服務(wù)，也不用升級代碼就能夠完成功能開發(fā)和問題處理，這對開發(fā)效率而言會有很大的提升

7. 傳統(tǒng)業(yè)務(wù)開發(fā)，不僅有服務(wù)端的開發(fā)，還有相對應(yīng)的文檔生成，前后端對接，以及測試配合?！癛ocket API” 提供了POSTMAN的操作頁面，能夠?qū)?shù)的請求值，請求類型，響應(yīng)等保存起來，給予前端做真實(shí)數(shù)據(jù)的對接，而不是類yapi，或者swagger之類生成的不能使用的假數(shù)據(jù)?；谶@些真實(shí)的請求參數(shù)和返回值，提供了外部接口能力，測試團(tuán)隊(duì)可以以此來做接口的一鍵冒煙測試，和文檔的一鍵生成

演示說明

接口功能邏輯頁面

接口功能自測頁面

文檔和演示地址：

https://gitee.com/alenfive/rocket-api-doc/wikis/pages

集成方式：

1. 添加依賴

`??
????com.github.alenfive??
????rocket-api-boot-starter??
????0.0.1-SNAPSHOT??
??
`

2. 數(shù)據(jù)源配置

`@Component??
public?class?DefaultDataSourceManager?extends?DataSourceManager?{??
??
????@Autowired??
????private?JdbcTemplate?jdbcTemplate;??
??
????@PostConstruct??
????public?void?init()?{??
????????Map?dialects?=?new?HashMap<>();??
????????dialects.put("mysql",new?SqlDataSource(jdbcTemplate,true));??
????????super.setDialectMap(dialects);??
????}??
}??
`

3. 最新建表腳本查看:

https://gitee.com/mihuajun/rocket-api-doc/wikis/pages?sort_id=2670007&doc_id=859283

啟動項(xiàng)目，訪問地址:

http://localhost:8080/interface-ui

（完）

特別推薦一個分享架構(gòu)+算法的優(yōu)質(zhì)內(nèi)容，還沒關(guān)注的小伙伴，可以長按關(guān)注一下：

長按訂閱更多精彩▼
如有收獲，點(diǎn)個在看，誠摯感謝