面向声明式API编程（DAP）- Mars-java框架

声明式API编程(DAP) 框架

* 10秒钟就可以建立一个后端服务
* 甚至没有Controller的概念
* 分布式锁，只需要一行注解
* 本机测试，响应时间最低可达9毫秒，吐吞量最高可达1200

什么是声明式API编程(DAP)

按照传统的开发方式，如果要开发一个后端接口，需要分为以下三步

* 创建controller
* 创建service
* 创建dao（甚至会创建存放sql的xml）

但是，我们编写一个接口，重点应该是放在业务逻辑上的，也就是说 我们的关注点应该在第二步，但是通常第一步和第三步的重复工作量让我们感到窒息，所以我梳理了一下，制定了一个新玩法，这套新玩法就叫声明式API

* 写业务逻辑
* 声明一个API给前端
* 将API与业务逻辑关联

所以我们是这样玩的

编写业务逻辑

@MarsBean("testService")
public class TestService {

    要返回的数据类型 selectListForName(参数1, 参数2, 参数3, 参数4){
        // 第一步 根据testDTO里的参数从xx表查询需要的数据
        // 第二步 根据查出来的数据，去操作xx2表
        // 第三步 对前两步的结果汇总，进行xxx操作

        return 数据（直接返回即可，会自动变成json）；
    }
}

声明一个API接口

@MarsApi
public interface TestApi {

    Object selectList(TestVO testVO);
}

将api与业务逻辑关联

@MarsApi
public interface TestApi {

    @MarsReference(beanName = "testService",refName = "selectListForName")
    Object selectList(TestVO testVO);
}

对，你没看错，API的方法和他引用的那个方法，参数列表可以不一样， 框架会自动把API的参数的值赋值到引用的那个方法的参数列表

引用的方法甚至可以无参，参数目前只支持自定义对象和Map

这套思想的核心是，把后端看作是一个独立个体，并不是为服务前端而存在的， 后端就写后端的业务逻辑好了，如果前端需要数据，那我们就开个门给他

这么做的好处，还可以散藕

通过更换MarsReference的配置，可以关联到不同的业务逻辑
如果前端不需要这个接口了，直接无脑删就好了，因为这只是一个抽象方法
后端专注业务逻辑就好了，不需要考虑跟前端互动，前端需要的时候开个门就好了

还可以做什么

首先声明式API是对前后端交互方式的一次变革，省去了Controller。

其实这种风格在微服务里很常见，比如Dubbo的api， 既然微服务接口可以用interface来提供对外的服务，那么我们也可以把它用到http接口上吧。

除了声明式API，我们还提供以下功能

* 单表操作和固定sql操作，仅需一行注解
* 分页仅需调用一个方法，没有任何第三方依赖
* 分布式锁，只需要一行注解
* 没有像Mybatis一样的sqlMapper.xml
* 支持AOP,IOC,声明式事务
* 搭建仅需三步，并提供官方中文文档，再也不需要满大街的搜Spring的机翻文档或者个人博客了

分布式锁示例

在要加锁的方法上添加RedisLock注解

@RedisLock(key = "自己定义一个key")
public int insert(){
  return 1;
}

这个锁会在事务开启之前获取，在事务提交以后解锁，并且只对MarsBean有效，对API和DAO无效

如果你不需要锁住整个方法，只需要锁一小段代码，那么可以去我的官网查看相应的方法

官网：http://mars-framework.com/