# Akali **Repository Path**: codextool/Akali ## Basic Information - **Project Name**: Akali - **Description**: Akali(阿卡丽),轻量级本地化热点检测/降级框架,10秒钟即可接入使用!大流量下的神器 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://akali.yomahub.com/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 150 - **Created**: 2024-09-08 - **Last Updated**: 2024-09-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

logo

### 官网:https://akali.yomahub.com ### 介绍 Akali(阿卡丽)是一个轻量级本地化热点检测/降级框架,适用于大流量场景,可轻松解决业务中超高流量的并发查询等场景。并且接入和使用极其简单,10秒钟即可接入使用! Akali框架的理念就是小巧,实用,来无影去无踪,丝血团战,满血退场,所到之处,皆为虚无。 ### 使用 引入依赖: ```xml org.dromara akali 1.1.4 ``` #### 对任意方法进行热点处理 只需要加上`@AkaliHot`这个标注,任意方法均可以获得热点检测,并在热点期间用热点数据进行返回,在热点过后,又会自动调用原本业务逻辑。 举例:比如有一个商品查询的业务,传入SkuCode,返回商品信息。当某个商品进行促销时,访问的量就会增加,但是对于相同的SkuCode而言,其短时间窗口内返回的SkuInfo是一致的,我们的目标是当某个商品sku被大量查询时,框架能够在短时间内把这个商品sku提为热点数据,并通过对其进行缓存返回来降低对下游业务的压力。而当热点值过后,框架又能够自动摘除这个热点值,使其按照原有方式进行查询。 其本质相当于实时的监测了热点,并对其热点数据做了一个短时间内的缓存。 以下示例代表了:当相同的skuCode在5秒内超过50次调用时,会自动把这个skuCode的值提为热点,并用最后一次的返回值直接返回。当调用低于5秒50次调用时,框架会自动的摘除掉这个热点。使其正常的调用你原有代码进行逻辑计算并返回。这一切都是自动的。 ```java @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`个数作为维度统计。比如: ```java @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`标注,即可解决。 ```java @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中,你需要配置: ```xml ``` ### 交流群