轻量级web框架cicada----（转）

时间：2024-09-27 09:33:56

源码地址：

　　https://github.com/TogetherOS/cicada

快速启动

下面来看看如何快速启动一个 HTTP 服务。

只需要创建一个 Maven 项目，并引入核心包。

<dependency>

    <groupId>top.crossoverjie.opensource</groupId>

    <artifactId>cicada-core</artifactId>

    <version>1.0.0</version>

</dependency>

如上图所示，再配置一个启动类即可。

public class MainStart {

    public static void main(String[] args) throws InterruptedException {

        CicadaServer.start(MainStart.class,"/cicada-example") ;

    }

}

配置业务 Action

当然我们还需要一个实现业务逻辑的地方。cicada 提供了一个接口，只需要实现该接口即可实现具体逻辑。

创建业务 Action 实现 top.crossoverjie.cicada.server.action.WorkAction 接口。

@CicadaAction(value = "demoAction")

public class DemoAction implements WorkAction {

    private static final Logger LOGGER = LoggerBuilder.getLogger(DemoAction.class) ;

    private static AtomicLong index = new AtomicLong() ;

    @Override

    public void execute(CicadaContext context, Param param) throws Exception {

        String name = paramMap.getString("name");

        Integer id = paramMap.getInteger("id");

        LOGGER.info("name=[{}],id=[{}]" , name,id);

        DemoResVO demoResVO = new DemoResVO() ;

        demoResVO.setIndex(index.incrementAndGet());

        WorkRes<DemoResVO> res = new WorkRes();

        res.setCode(StatusEnum.SUCCESS.getCode());

        res.setMessage(StatusEnum.SUCCESS.getMessage());

        res.setDataBody(demoResVO) ;

　　　　context.text(res.toString());
    }

}

同时需要再自定义类中加上 @CicadaAction 注解，并需要指定一个 value，该 value 主要是为了在请求路由时能找到业务类。

这样启动应用并访问

http://127.0.0.1:7317/cicada-example/demoAction?name=12345&id=10

便能执行业务逻辑同时得到服务端的返回。

轻量级web框架cicada----（转）

目前默认支持的是 json 响应，后期也会加上模板解析。

服务中也会打印相关日志。

轻量级web框架cicada----（转）

灵活的参数配置

这里所有的请求参数都封装在 Param 中，可以利用其中的各种 API 获取请求数据。

之所以是灵活的：我们甚至可以这样请求：

http://127.0.0.1:7317/cicada-example/demoAction?jsonData="info": {

    "age": 22,

    "name": "zhangsan"

  }

这样就可以传递任意结构的数据，只要业务处理时进行解析即可。

自定义拦截器

拦截器是一个框架的基本功能，可以利用拦截器实现日志记录、事务提交等通用工作。

为此 cicada 提供一个接口: top.crossoverjie.cicada.server.intercept.CicadaInterceptor。

我们只需要实现该接口即可编写拦截功能：

@Interceptor(value = "executeTimeInterceptor")

public class ExecuteTimeInterceptor implements CicadaInterceptor {

    private static final Logger LOGGER = LoggerBuilder.getLogger(ExecuteTimeInterceptor.class);

    private Long start;

    private Long end;

    @Override

    public void before(Param param) {

        start = System.currentTimeMillis();

    }

    @Override

    public void after(Param param) {

        end = System.currentTimeMillis();

        LOGGER.info("cast [{}] times", end - start);

    }

}

这里演示的是记录所有 action 的执行时间。

目前默认只实现了 action 的拦截，后期也会加入自定义拦截器。

拦截适配器

虽说在拦截器中提供了 before/after 两个方法，但也不是所有的方法都需要实现。

因此 cicada 提供了一个适配器：

top.crossoverjie.cicada.server.intercept.AbstractCicadaInterceptorAdapter

我们需要继承他便可按需实现其中的某个方法，如下所示：

@Interceptor(value = "loggerInterceptor")

public class LoggerInterceptorAbstract extends AbstractCicadaInterceptorAdapter {

    private static final Logger LOGGER = LoggerBuilder.getLogger(LoggerInterceptorAbstract.class) ;

    @Override

    public void before(Param param) {

        LOGGER.info("logger param=[{}]",param.toString());

    }

}

性能测试

既然是一个 HTTP 服务框架，那性能自然也得保证。

在测试条件为：300 并发连续压测两轮；1G 内存、单核 CPU、1Mbps。用 Jmeter 压测情况如下：

轻量级web框架cicada----（转）

同样的服务器用 Tomcat 来压测看看结果。

Tomcat 的线程池配置:

<Executor name="tomcatThreadPool" namePrefix="consumer-exec-"

        maxThreads="510" minSpareThreads="10"/>

轻量级web框架cicada----（转）

我这里请求的是 Tomcat 的一个 doc 目录，虽说结果看似 cicada 的性能比 Tomcat 还强。

但其实这个对比过程中的变量并没有完全控制好，Tomcat 所返回的是 HTML，而 cicada 仅仅返回了 json，当然问题也不止这些。

但还是能说明 cicada 目前的性能还是不错的。

转自：https://my.oschina.net/crossoverjie/blog/1941207

相关文章