介绍一款 API 敏捷开发工具

分手后的思念是犯贱 2021-09-02 05:39 431阅读 0赞

点击上方 [Java后端][Java]，选择 设为星标

优质文章，及时送达

--------------------

**初衷**

###  ###

用尽可能简单的方式，完成尽可能多的需求。通过约定的方式 实现统一的标准。告别加班，拒绝重复劳动，远离搬砖

### **特性** ###

1.  用于快速开发API接口。不再定义`Controller`,`Service`,`Dao`,`Mybatis`,`xml`,`Entity`,`VO`等对象和方法.
2.  可视化界面，将入参自动封装到可执行的脚本上，支持所有关系性数据库SQL执行语句，非关系型`MONGODB`查询语句.欢迎扩展
3.  完全基于springboot2.x 作为springboot项目的stater方式集成,无侵入性，新老项目都能快速集成
4.  只需编写一行代码即可完成大部分的业务需求开发，使用难度级别（测试 or 运维）也可参与开发
5.  在线动态编译，无需重启，即时生效，多数据源操作
6.  版本控制,历史记录比对，回滚等功能
7.  远程一键发布到线上环境
8.  线上POSTMAN调试,保存POSTMAN信息或三方文档的自动生成，历史调用记录存储，回塑
9.  代码提示，SQL提示，语法提示
10. 用户管理控制，安全性控制，以及历史行为记录
11. 经过多次项目验证，传统业务型开发，服务端效率能够提升3-5倍，前后端联调提升效率1倍，测试效率2倍提升

### 传统开发步骤: ###

1.  增加一张表
2.  创建实体对象，映射这张表
3.  创建API入参VO
4.  创建API出参VO
5.  创建Controller
6.  创建Service
7.  创建Dao
8.  创建Mapper, xml或者JPA
9.  在mysql客户端，或者mongo客户端中写执行脚本语句，复制到代码中
10. 反复重启，进行接口自测
11. 编写API文档
12. 完成一个功能点开发

使用一些工具比如mybatis plus，jpa，或者idea的Easy code,MybatisCodeHelperPro等可以一键生成一些基于单表的操作的相关代码，但是业务场景来说，可能喜欢更灵活，代码执行效率更高的一些操作方式,并且一个项目开发中，从来不仅仅是单表的一些操作操作

市面上就上面的这些问题，提供了APIJSON和GraphQL等解决方案,这两个工具相对操作数据库相对很灵活，但是操作难度，和学习成本高，并且适合场景也是有限，如果要实现简单的业务处理逻辑会比较复杂

那么，我希望有一种功具，它可以像mybatis xml，像metabase BI,一样，能够直接操作原生的数据库查询及操作语句，并且可以有springboot的restful这种业界标准的接口定义/及参数定义方式，并且按照统一约定的方式，省略三层MVC的定义，并且能够对数据进行一些逻辑处理，以满足多元化的业务需求。最好是作为一个插件的形式，能够很好的集成在现有项目中，不会影响到现有的业务逻辑处理

这就是我要介绍的一款工具 \#Rocket API\#

区别于前两类的设计方式不同点在于:

1.  基于springboot开发。包括接口的注册，参数的获取，输入输出的消息转换，都是基于springboot的生态环境，能无侵入性集成于springboot项目中，如果你有基于springboot实现了全局异常处理，返回值统一封装，权限控制等，不用担心，都在你的管控范围内
2.  参考于mybatis的参数定义方式，不同点在于使用默认大于配置的逻辑，实现参数的注入直接来源于请求参数，省略了传统MVC 实体类，方法，VO等定义
3.  默认担供了内部函数，可以很简单的实现 多表/多库的增/删/改/查，导出，导入，上传，下载，分页查询等功能
4.  提供了基于Groovy的语法解析，可以实现Groovy的一些逻辑处理
5.  提供了调用springboot bean对象的方法及其他任意java定义的静态类，方法和对象，这意味着我能够调用公共定义的类，或者之前在项目中定义的service,dao,和utils
6.  因为基于的groovy动态语法解析，所以代码修改，或者线上问题的处理能够不用重启服务，也不用升级代码就能够完成功能开发和问题处理，这对开发效率而言会有很大的提升
7.  传统业务开发，不仅有服务端的开发，还有相对应的文档生成，前后端对接，以及测试配合。“Rocket API” 提供了POSTMAN的操作页面，能够将参数的请求值，请求类型，响应等保存起来，给予前端做真实数据的对接，而不是类yapi，或者swagger之类生成的不能使用的假数据。基于这些真实的请求参数和返回值，提供了外部接口能力，测试团队可以以此来做接口的一键冒烟测试，和文档的一键生成

### **演示说明** ###

##### https://blog.csdn.net/maple\_son/article/details/108196584 #####

##### 接口功能逻辑页面 #####

![format_png][]

##### 接口功能自测页面 #####

![format_png 1][]

文档和演示地址：https://gitee.com/alenfive/rocket-api-doc/wikis/pages

##### 集成方式： #####

**1. 添加依赖**

<dependency>
      <groupId>com.github.alenfive</groupId>
      <artifactId>rocket-api-boot-starter</artifactId>
      <version>0.0.1-SNAPSHOT</version>
    </dependency>

**2. 数据源配置**

@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

**文末送书**

今天送 5 本《SQL必知必会》书籍，这本书非常经典，文末参与。

**![format_png 2][]**

麻省理工学院、伊利诺伊大学等众多大学的参考教材，中文版累计销量超13万，没有过多阐述数据库基础理论，而是专门针对一线软件开发人员，直接从SQL SELECT开始，讲述实际工作环境中最常用和最必需的SQL知识，实用性极强。新版对书中的案例进行了全面的更新，并增加了章后挑战题，便于读者巩固所学知识。

**参与抽奖：****扫描下方二维码**，关注后回复 **送书** 两个字，即可获取抽奖码。

![format_png 3][]

▲扫描上方二维码，关注后回复 **送书** 两个字即可

[Java]: http://mp.weixin.qq.com/s?__biz=Mzg2MjEwMjI1Mg%3D%3D&chksm=ce0da17bf97a286df119047a25b7de51621fe542816673bb4aa3ebd8ab97b09a86ed7db2e2ee&idx=3&mid=2247489272&scene=21&sn=ce74938072fc73a808d83ccb474db46d#wechat_redirect
[format_png]: /images/20210730/c3372fa424464285bf2587344c444969.png
[format_png 1]: /images/20210730/ef11df83b0d147c4b9dbe5f889aedfa4.png
[format_png 2]: /images/20210730/4e295476f2ba4d79a78f06b729821e07.png
[format_png 3]: /images/20210730/15871dc9168b4b5fa929e131807b1260.png