2018-08-29

Tags: 程式語言 , java , guava

基本用法

請參考下列文章

• Guava Cache 用法介紹

CacheBuilder class 裡的 expireAfterWrite, expireAfterAccess, refreshAfterWrite method 區別

• expireAfterAccess

  • 一定時間內沒有讀寫，會移除該cache key，下次取的時候從 raw data (e.g. database) 裡取
  • 在更新 cache key 對應內容時，會 block 所有存取該 cache key 的 thread
  • expireAfterAccess 行為分析請參考下列文章
    • Guava Cache特性：對於同一個key，只讓一個請求回源load數據，其他線程阻塞等待結果

• expireAfterWrite

  • 一定時間內沒有創建或覆寫時，會移除該 cache key，下次取的時候從 raw data (e.g. database) 裡取
  • 在更新 cache key 對應內容時，會 block 所有存取該 cache key 的所有 thread
  • expireAfterWrite 是時間到了就 expire。expireAfterAccess 則是以 上次取存的時間點 為基準來記算何時會 expire，也就是說只要一直被存取就不會 expire

• refreshAfterWrite

  • 指定時間內沒有被創建或覆寫，在指定時間過後再次訪問時，會去更新 cache key 對應之值，在新值沒有到來之前，始終返回舊值。注意!是再次訪問，也就是未訪問前可能都不會更新。
  • 在更新 cache key 對應內容時，不會 block 所有存取該 cache key 的 thread
  • CacheBuilder 要產生 LoadingCache 時才可以叫用這個 method，不然會產生 refreshAfterWrite requires a LoadingCache exception
  • 跟 expireAfterAccess(或 expireAfterWrite) 區別
    • 指定時間過後，expireAfterAccess(或 expireAfterWrite) 是 remove cache key，下次訪問是 同步(sync) 去獲取返回新值。新值未取回前，所有要取新值 的 thread 都會被 block。
    • refresh 是指定時間後，不會 remove cache key，直到下次訪問 才以 非同步(async) 方式 refresh cache。在 refresh cache 動作完成前，大多數針對該 cache key 的請求 thread 會立刻返回舊值，不會被 block
  • refreshAfterWrite 行為分析請參考下列文章
    • Guava Cache特性：refreshAfterWrite只阻塞回源線程，其他線程返回舊值

CacheBuilder class 裡的 expireAfterWrite, refreshAfterWrite method 可以一起使用

二者一起使用時的行為請參考下列文章

• 深入Guava Cache的refresh和expire刷新機制

  重點是這一段

  可以看出refreshAfterWrite和expireAfterWrite兩種方式各有優缺點，各有使用場景。那麼能否在refreshAfterWrite和expireAfterWrite找到一個折中？比如說控制緩存每1s進行refresh，如果超過2s沒有訪問，那麼則讓緩存失效，下次訪問時不會得到舊值，而是必須得待新值加載。由於guava官方文檔沒有給出一個詳細的解釋，查閱一些網上資料也沒有得到答案，因此只能對源碼進行分析，尋找答案。經過分析，當同時使用兩者的時候，可以達到預想的效果，這真是一個好消息吶！

• 官方文件說明

  重點是這一段，不過我沒有很懂它表達的意思

  In contrast to expireAfterWrite, refreshAfterWrite will make a key eligible for refresh after the specified duration, but a refresh will only be actually initiated when the entry is queried. (If CacheLoader.reload is implemented to be asynchronous, then the query will not be slowed down by the refresh.) So, for example, you can specify both refreshAfterWrite and expireAfterWrite on the same cache, so that the expiration timer on an entry isn't blindly reset whenever an entry becomes eligible for a refresh, so if an entry isn't queried after it comes eligible for refreshing, it is allowed to expire.

reference document

• Guava Cache 用法介紹
• Guava Cache特性：對於同一個key，只讓一個請求回源load數據，其他線程阻塞等待結果
• Guava Cache特性：refreshAfterWrite只阻塞回源線程，其他線程返回舊值
• guava緩存的expireAfterWrite與refreshAfterWrite的區別
• 深入Guava Cache的refresh和expire刷新機制

---