又發(fā)現(xiàn)一款牛逼的 API 敏捷開發(fā)工具

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

初衷

跟大家分享一個牛逼的 API 敏捷開發(fā)工具，用盡可能簡單的方式，完成盡可能多的需求。通過約定的方式 實現(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項目的stater方式集成,無侵入性，新老項目都能快速集成
4. 只需編寫一行代碼即可完成大部分的業(yè)務(wù)需求開發(fā)，使用難度級別（測試 or 運維）也可參與開發(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)過多次項目驗證，傳統(tǒng)業(yè)務(wù)型開發(fā)，服務(wù)端效率能夠提升3-5倍，前后端聯(lián)調(diào)提升效率1倍，測試效率2倍提升

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

1. 增加一張表
2. 創(chuàng)建實體對象，映射這張表
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. 完成一個功能點開發(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ù)邏輯處理

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

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

1. 基于springboot開發(fā)。包括接口的注冊，參數(shù)的獲取，輸入輸出的消息轉(zhuǎn)換，都是基于springboot的生態(tài)環(huán)境，能無侵入性集成于springboot項目中，如果你有基于springboot實現(xiàn)了全局異常處理，返回值統(tǒng)一封裝，權(quán)限控制等，不用擔(dān)心，都在你的管控范圍內(nèi)
2. 參考于mybatis的參數(shù)定義方式，不同點在于使用默認(rèn)大于配置的邏輯，實現(xiàn)參數(shù)的注入直接來源于請求參數(shù)，省略了傳統(tǒng)MVC 實體類，方法，VO等定義
3. 默認(rèn)擔(dān)供了內(nèi)部函數(shù)，可以很簡單的實現(xiàn) 多表/多庫的增/刪/改/查，導(dǎo)出，導(dǎo)入，上傳，下載，分頁查詢等功能
4. 提供了基于Groovy的語法解析，可以實現(xiàn)Groovy的一些邏輯處理
5. 提供了調(diào)用springboot bean對象的方法及其他任意java定義的靜態(tài)類，方法和對象，這意味著我能夠調(diào)用公共定義的類，或者之前在項目中定義的service,dao,和utils
6. 因為基于的groovy動態(tài)語法解析，所以代碼修改，或者線上問題的處理能夠不用重啟服務(wù)，也不用升級代碼就能夠完成功能開發(fā)和問題處理，這對開發(fā)效率而言會有很大的提升
7. 傳統(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ā)一個接口

接口功能邏輯頁面

接口功能自測頁面

文檔和演示地址：#Rocket API#

集成方式：

1. 添加依賴

<dependency>
    <groupId>com.github.alenfive</groupId>
    <artifactId>rocket-api-boot-starter</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</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