我在一些项目中使用了 core.cache。这是一个非常棒的库,我非常喜欢它。但它缺少统计信息,因此我无法根据一些统计信息调整缓存大小。我决定编写一个自定义的缓存实现,以便能够获取缓存的命中/未命中统计信息。最初这是一个独立的项目,但我后来意识到我在 core.cache 本身需要做出一些改变,而无法通过任何巧妙的方式来实现。因此,这里是添加统计感知缓存实现的补丁。
快速演示
{code:none}
(require '[clojure.core.cache :as core.cache]
'[clojure.core.cache.stats :as ccs]
'[clojure.core.cache.stats.counters :as ccs.counters])
(def cache (-> {} core.cache/lru-cache-factory ccs/measured-cache))
(ccs/stats cache) ; {:hit 0, :miss 0, :request 0, :hit-ratio 1.0, :miss-ratio 1.0}
(def cache (assoc cache :foo "bar"))
(ccs/stats cache) ; {:hit 0, :miss 1, :request 1, :hit-ratio 0.0, :miss-ratio 1.0}
(get cache :foo) ; "bar"
(get cache :foo) ; "bar"
(ccs/stats cache) ; {:hit 2, :miss 1, :request 3, :hit-ratio 0.6666666666666666, :miss-ratio 0.3333333333333333}
新特性
* core.cache.stats 命名空间提供了 MeasuredCache,它实现了 CacheProtocol 并提供了一个测量缓存函数来实例化它。MeasuredCache 还实现了 MeasuredCacheProtocol,它的唯一职责是返回成功/失败统计信息的快照。
* core.cache.stats.counters 命名空间提供了一个协议(StatsCounterProtocol),允许实现命中/失败计数器。已有两种实现:一种是基于原子封装的长整型,另一种(默认使用)是基于 LongAdder。
* 对所有可调用的方法都进行了测试
注意事项(不分先后顺序)
* LongAdderStatsCounter 引入了 LongAdder 类的强制依赖,该类是在 Java 1.8 中添加的。我已经尝试使其可选项,但失败了(
https://stackoverflow.com/questions/45045314/clojure-optional-definitions)
* 我已修改了 defcache 宏(所有测试都通过),这样我实际上可以覆盖定义
合并前需要完成的事宜
* 如果您想看相关的文档(可能我本应该先做这个,这样可能会更容易被接受?),请添加更多文档
* 精简代码(我不是 Clojure 专家),命名和命名空间
提前感谢您的 feedback