v1.0.0

讀取時過期

最後更新


本頁說明 TTL 如何儲存、每一層讀取如何判斷過期,以及背景掃除涵蓋的範圍。

TTL 的儲存方式


Set 把 TTL 轉成整數秒存入 Cache.TTL,並記錄寫入當下的 Unix 秒數 Cache.Timestamp(set.go:16-25)。
Set 的 ttl 參數Cache.TTL結果
10 * time.Minute600600 秒後過期
0 或負值0不過期
500 * time.Millisecond0(無條件捨去)不過期
1500 * time.Millisecond11 秒後過期

未滿 1 秒的 TTL 會被捨去成 0,等同不設過期;Redis 端同樣以 0 寫入(無過期)。

過期判斷


isExpired(unit.go:26-31):TTL ≤ 0 永不過期;否則 now > Timestamp + TTL 即過期,精度為秒。

每一層的處理


位置發現過期時原始碼
正常模式讀記憶體刪記憶體項目+刪本地檔,回傳 Not foundget.go:29-34
Fallback 模式讀記憶體只刪記憶體項目,回傳 Not foundget.go:68-72
Fallback 模式讀檔案刪檔案,回傳 Not foundget.go:95-100
恢復回灌過期項目不寫入 Redissync.go:109
Redis 本身由 Redis 的 key 過期機制處理—

背景掃除


New 啟動一個每 30 秒觸發的 Ticker(sync.go:135-154),遍歷記憶體快取,刪除過期項目與其本地檔案。
項目行為
掃描範圍只有記憶體快取中的鍵;從未載入記憶體的本地檔案不會被掃到
間隔固定 30 秒,不可設定
停止Close 不會停止這個 Ticker
跳過條件只在 New 當下檢查一次 isRecovering;為 true 時整個掃除不啟動

對讀取的影響


過期資料不會被 Get 回傳:每一層讀取都先判斷過期再回傳。背景掃除只影響記憶體與磁碟占用,不影響讀取結果。
EN