annocache
介绍
annocache-spring-boot-starter是一个超轻量级的注解式缓存组件。只需要一行代码，即可实现方法返回值的自动化缓存，让方法的数据返回时间降为毫秒级，访问速度提升几十倍。
特色
1.和 Spring 提供的注解式缓存组件相比，使用方式和配置参数更加简便。只有一个方法注解 @AnnoCache，代表启用缓存；注解上只有一个参数 seconds，代表缓存数据的过期时长秒数。
2.具备自动二级缓存功能，一定程度上可以避免缓存击穿。当缓存失效时，使用一个线程执行业务代码进行缓存内容的更新，其余并发访问线程则从二级缓存获取最后一个版本的缓存值先返给前端。
使用说明
参考示例项目annocache-sample-api，这是一个简单的基于 SpringBoot 创建的 web 项目。
1.项目的 pom.xml 中增加依赖。
<dependency> <groupId>com.gitee.cs_liwei</groupId> <artifactId>annocache-spring-boot-starter</artifactId> <version>0.0.1-SNAPSHOT</version> </dependency>
复制代码
2.目前支持 Redis 缓存方式，需在 application.yml 中指定 Redis 服务器的地址和端口。
spring: redis: cluster: - localhost:6379 - localhost:6379
复制代码
示例中采用的是本地启动的 Redis 服务器 localhost:6379。
如果开发机采用的是 Windows 操作系统，可以从 这里 下载 Redis Server 的 Windows 版本，做本地启动测试。
3.在需要缓存的业务方法上，简单的添加 @AnnoCache(seconds = 45) 注解代码即可实现功能。seconds 为缓存时长，单位为秒。
/** * dummy business */@Componentpublic class TestBusiness {
@AnnoCache(seconds = 45) public TestModel test(int param1, Integer param2, String param3){ TestModel model = new TestModel(); //... //dummy process time cost（1000 milliseconds） try { Thread.sleep(1000); } catch (InterruptedException e) { e.printStackTrace(); }
return model; }}
复制代码
4.调用业务方法的地方，将会启用缓存。
@RestControllerpublic class TestController { @Autowired TestBusiness testBusiness;
@RequestMapping("/test1") public TestModel test(@RequestParam int param1, @RequestParam Integer param2, @RequestParam String param3){
//business process method with cache annotation. //the dummy process will cost over 1 second if no cache. return testBusiness.test(param1, param2, param3); }}
复制代码
5.启动 annocache-sample-api 项目，在本地浏览器中访问：
http://localhost:8080/test1?param1=1¶m2=2¶m3=3
复制代码
可以观察到，没有建立缓存的时候 API 返回耗时约 1000 毫秒以上，建立缓存后则缩短为 20 毫秒以内。
注意点
1.添加缓存注解的方法，其参数不可为实体类型。所有参数都会参与缓存 Key 的构建，因此建议都使用 String 或基本类型。实际上，坚持采用简单类型的入参，也更加符合 Java 编码的最佳实践。
2.可以缓存的返回值类型，目前已支持 Object 实体，List 以及 Map，序列化方式为 Jackson。
@Componentpublic class TestBusiness { @AnnoCache(seconds = 45) public List<TestModel> test2(int param1, Integer param2, String param3){ List<TestModel> list = new ArrayList<>(); //... return list; }
@AnnoCache(seconds = 45) public Map<String, TestModel> test3(int param1, Integer param2, String param3){ Map<String, TestModel> map = new HashMap<>(); //... return map; }}
复制代码
TODO
1.内存缓存的支持。
2.Redis 服务不可用等情况下的监控与降级。
3.其他可以性能优化的点。
评论 (1 条评论)