Mars-java - 面向声明式 API 编程(DAP)框架


MIT
跨平台
Java

软件简介

Mars-java是一个声明式API编程(DAP) 框架

项目功能

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

面向声明式API编程(DAP)

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

  1. 创建controller
  2. 创建service
  3. 创建dao(甚至会创建存放sql的xml)

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

  1. 写业务逻辑
  2. 声明一个API给前端
  3. 将API与业务逻辑关联

所以我们是这样玩的

编写业务逻辑

父接口

public interface TestService {

    要返回的数据类型 selectList(TestVO testVO);
}

实现类

@MarsBean("testService")
public class TestServiceImpl implements TestService{

    要返回的数据类型 selectList(TestVO testVO){

        // 编写业务逻辑

        return 数据(直接返回即可,会自动变成json);
    }
}

在Service的父接口上加上两个注解

@MarsApi
public interface TestService {

    @MarsReference(beanName = "testService[要引用的bean名称]")
    要返回的数据类型 selectList(TestVO testVO);

}

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

接下来怎么做

看到这里,大家肯定会有疑问,前端要怎么调用api,后端怎么操作数据库? 这个就需要你们动动手指,去我的官网一探究竟

还可以做什么

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

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

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

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

分布式锁示例

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

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

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

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