Dromara 社区新晋开源项目 - Akali(阿卡丽)，轻量化的热点&降级处理框架！

前言

Dromara社区再添一个成员项目！

今天为大家介绍的是——Akali。

它轻量小巧，来无影去无踪，不足500行代码，却能解决高流量场景中主要的问题：热点处理和降级处理。

介绍

Akali（阿卡丽）是一个轻量级本地化热点检测/降级框架，适用于大流量场景，可轻松解决业务中超高流量的并发查询等场景。并且接入和使用极其简单，10秒钟即可接入使用！

Akali框架的理念就是小巧，实用，丝血团战，满血退场，所到之处，皆为虚无。

Gitee：https://gitee.com/dromara/Akali

Github：https://github.com/bryan31/Akali

官方网站：https://akali.yomahub.com/

使用

引入依赖：

 <dependency> <groupId>com.yomahub</groupId> <artifactId>akali</artifactId> <version>1.0.1</version> </dependency> 

对任意方法进行热点处理

只需要加上@AkaliHot这个标注，任意方法均可以获得热点检测，并在热点期间用热点数据进行返回，在热点过后，又会自动调用原本业务逻辑。

举例：比如有一个商品查询的业务，传入SkuCode，返回商品信息。当某个商品进行促销时，访问的量就会增加，但是对于相同的SkuCode而言，其短时间窗口内返回的SkuInfo是一致的，我们的目标是当某个商品sku被大量查询时，框架能够在短时间内把这个商品sku提为热点数据，并通过对其进行缓存返回来降低对下游业务的压力。而当热点值过后，框架又能够自动摘除这个热点值，使其按照原有方式进行查询。

其本质相当于实时的监测了热点，并对其热点数据做了一个短时间内的缓存。

以下示例代表了：当相同的skuCode在5秒内超过50次调用时，会自动把这个skuCode的值提为热点，并用最后一次的返回值直接返回。当调用低于5秒50次调用时，框架会自动的摘除掉这个热点。使其正常的调用你原有代码进行逻辑计算并返回。这一切都是自动的。

 @AkaliHot(grade = FlowGradeEnum.FLOW_GRADE_QPS, count = 50, duration = 5) public SkuInfo getSkuInfo(String skuCode){ //do your biz and return sku info } 

其中grade参数除了有以QPS作为维度统计，还有以Thread个数作为维度统计。比如：

 @AkaliHot(grade = FlowGradeEnum.FLOW_GRADE_THREAD, count = 50, duration = 5) public SkuInfo getSkuInfo(String skuCode){ //do your biz and return sku info } 

这就代表了，如果某个skuCode在5秒之内有超过50个线程正在运行，那么就提为热点，并用热点数据直接返回。

对开源项目比较熟悉的同学看到这肯定想到了京东的框架-hotkey，Akali不同于hotkey，完全是本地运行的，不依赖于服务端，而且接入比hotkey 方便多了。性能完全相当于hotkey。

对任意方法进行降级

只需要加上@AkaliFallback注解。任意方法均可获得降级功能。

举例：某一个方法需要调用外部的接口，但是外部的接口性能不佳，耗时高。当并发一高时，线程池就会吃满，线程池队列也会逐渐堆积从而导致超时，或者丢弃，严重时会拖垮整个系统。

这时，我们只要对这个方法加上@AkaliFallback标注，即可解决。

 @AkaliFallback(grade = FlowGradeEnum.FLOW_GRADE_THREAD, count = 100) public String sayHi(String name){ return "hi,"+name; } public String sayHiFallback(String name){ return "fallback str"; } 

以上注解表示了，当这个方法的同时运行的线程超过100个时，触发降级，降级会自动调用原方法名+Fallback方法名(并且参数要一致)，当降级触发后会直接返回fallback str，当线程数小于100时，框架也会自动摘除降级，还是输出hi,xxxx。

如果你的类中没有定义fallback方法，那么触发降级时会报错，当然你可以在降级方法中去抛错，来让上游系统知道你这个方法已经达到了瓶颈。

注意事项

Akali只针对于Springboot，Spring环境，并且所有标注了@AkaliHot或者@AkaliFallback的类一定得注册到spring上下文中。

Akali在springboot中会自动扫描所有标注的类，您无需做任何配置，在spring中，你需要配置：

 <bean class="com.yomahub.akali.strategy.FallbackStrategy"/> <bean class="com.yomahub.akali.strategy.MethodHotspotStrategy"/> <bean class="com.yomahub.akali.spring.AkaliScanner"/> 

最后

如果大家感兴趣的话，请在Gitee上为Akali点上小星星哦。

Gitee：https://gitee.com/dromara/Akali