造輪子 | golang | 支持過期時間的LRU緩存

本文代碼已上傳github,歡迎交流。

最近在學習go語言,正好有遇到需要使用緩存的地方,于是決定自己造個輪子。主要特性如下:

  • 線程安全;
  • 支持被動觸發的過期時間;
  • 支持key和value任意類型;
  • 基于雙向鏈表和hash表實現;

雙向鏈表的插入、刪除和元素移動效率非常高,LRU緩存通常都有大量的以上操作。使用hash表來存儲每個key對應的元素的指針,避免每次查詢緩存都需要遍歷整個鏈表,提高效率。

被動的過期的時間表示并不會主動的刪除緩存中已經過期的元素,而是在需要使用的時候才去檢查是否過期,如果過期的話再去刪除。

數據結構

每個緩存的元素至少包含兩個:緩存的關鍵字key、緩存的數據data;為了支持過期時間,每個元素還要有一個值來表示其過期時間;另外基于雙向鏈表實現,還需要指向前一個元素和后一個元素的指針;于是,每個緩存元素的結構定義:

type elem struct {
    key        interface{}
    data       interface{}
    expireTime int64
    next       *elem
    pre        *elem
}

那么對于整個緩存來說,事實上就是一個個元素組成的列表,但是為了更高效的查詢,使用一個hash表來存放key對應的元素的指針,提升查詢效率,于是cache的結構定義:

type lrucache struct {
    maxSize   int
    elemCount int
    elemList  map[interface{}]*elem
    first     *elem
    last      *elem
    mu        sync.Mutex
}

保存鏈表首尾元素的指針是為了在淘汰元素和插入元素的時候更高效。

基本方法

一個緩存基本的方法應該包括新建緩存、添加元素、刪除元素、查詢元素。

新建緩存

新建一個緩存實際上就是新建一個lrucache結構體,并對里面的元素進行初始化:

// New create a new lrucache
// size: max number of element
func New(size int) (*lrucache, error) {
    newCache := new(lrucache)
    newCache.maxSize = size
    newCache.elemCount = 0
    newCache.elemList = make(map[interface{}]*elem)
    return newCache, nil
}

入參表示這個緩存最多能存放的元素的個數,當到達最大個數的時候就開始淘汰最久沒使用的元素。

添加元素

添加元素使用Set方法來實現,如果緩存中已經存在該key,就更新值;否則新建一個緩存元素并保存。過期時間是可選的,如果沒傳入過期時間,這個元素就會一直存在知道被淘汰。

// Set create or update an element using key
//      key:    The identity of an element
//      value:  new value of the element
//      ttl:    expire time, unit: second
func (c *lrucache) Set(key interface{}, value interface{}, ttl ...int) error {

    // Ensure ttl are correct
    if len(ttl) > 1 {
        return errors.New("wrong para number, 2 or 3 expected but more than 3 received")
    }
    var elemTTL int64
    if len(ttl) == 1 {
        elemTTL = int64(ttl[0])
    } else {
        elemTTL = -1
    }

    c.mu.Lock()
    defer c.mu.Unlock()

    if e, ok := c.elemList[key]; ok {
        e.data = value
        if elemTTL == -1 {
            e.expireTime = elemTTL
        } else {
            e.expireTime = time.Now().Unix() + elemTTL
        }
        c.mvKeyToFirst(key)
    } else {
        if c.elemCount+1 > c.maxSize {
            if c.checkExpired() <= 0 {
                c.eliminationOldest()
            }
        }
        newElem := &elem{
            key:        key,
            data:       value,
            expireTime: -1,
            pre:        nil,
            next:       c.first,
        }
        if elemTTL != -1 {
            newElem.expireTime = time.Now().Unix() + elemTTL
        }
        if c.first != nil {
            c.first.pre = newElem
        }
        c.first = newElem
        c.elemList[key] = newElem

        c.elemCount++
    }
    return nil
}

如果一個key已經存在就更新它所對應的值,并將這個key對應的元素移動到鏈表的最前面;如果key不存在就需要新建一個鏈表元素,流程如下:

新增key流程圖

由于采用的是過期時間是被動觸發的方式,因此在元素滿的時候并不能確定是否存在過期的元素,因此目前采用的方式是,當滿了之后每次新增元素就去遍歷的檢查一次過期的元素,時間復雜度為O(n),感覺這種實現方式不太好,但是目前沒想到更好的實現方式。

上面使用到的內部方法實現如下:

// updateKeyPtr 更新對應key的指針,放到鏈表的第一個
func (c *lrucache) mvKeyToFirst(key interface{}) {
    elem := c.elemList[key]
    if elem.pre == nil {
        // 當key是第一個元素時,不做動作
        return
    } else if elem.next == nil {
        // 當key不是第一個元素,但是是最后一個元素時,提到第一個元素去
        elem.pre.next = nil

        c.last = elem.pre

        elem.pre = nil
        elem.next = c.first
        c.first = elem

    } else {
        elem.pre.next = elem.next
        elem.next.pre = elem.pre

        elem.next = c.first
        elem.pre = nil
        c.first = elem
    }
}

func (c *lrucache) eliminationOldest() {
    if c.last == nil {
        return
    }
    if c.last.pre != nil {
        c.last.pre.next = nil
    }
    key := c.last.key
    c.last = c.last.pre
    delete(c.elemList, key)
}

func (c *lrucache) deleteByKey(key interface{}) {
    if v, ok := c.elemList[key]; ok {
        if v.pre == nil && v.next == nil {
            // 當key是第一個元素時,清空元素列表,充值指針和元素計數
            c.elemList = make(map[interface{}]*elem)
            c.elemCount = 0
            c.last = nil
            c.first = nil
            return
        } else if v.next == nil {
            // 當key不是第一個元素,但是是最后一個元素時,修改前一個元素的next指針并修改c.last指針
            v.pre.next = v.next
            c.last = v.pre
        } else if v.pre == nil {
            c.first = v.next
            c.first.pre = nil
        } else {
            // 中間元素,修改前后指針
            v.pre.next = v.next
            v.next.pre = v.pre
        }
        delete(c.elemList, key)
        c.elemCount--
    }
}

// 遍歷鏈表,檢查并刪除已經過期的元素
func (c *lrucache) checkExpired() int {
    now := time.Now().Unix()
    tmp := c.first
    count := 0
    for tmp != nil {
        if tmp.expireTime != -1 && now > tmp.expireTime {
            c.deleteByKey(tmp.key)
            count++
        }
        tmp = tmp.next
    }
    return count
}

獲取元素

使用Get方法來獲取嘗試獲取一個緩存的元素,在獲取的時候同時會檢查是否過期,如果過期的話會返回響應的錯誤并刪掉該元素:

// Get Get the value of a cached element by key. If key do not exist, this function will return nil and a error msg
//      key:    The identity of an element
//      return:
//          value:  the cached value, nil if key do not exist
//          err:    error info, nil if value is not nil
func (c *lrucache) Get(key interface{}) (value interface{}, err error) {
    if v, ok := c.elemList[key]; ok {
        if v.expireTime != -1 && time.Now().Unix() > v.expireTime {
            // 如果過期了
            c.deleteByKey(key)
            return nil, errors.New("the key was expired")
        }
        c.mvKeyToFirst(key)
        return v.data, nil
    }
    return nil, errors.New("no value found")
}

刪除元素

刪除元素通過Delete來實現,實際上在之前的內部方法中已經實現了刪除一個元素的功能,只需要封裝給外部調用即可:

// Delete delete an element
func (c *lrucache) Delete(key interface{}) error {
    c.mu.Lock()
    defer c.mu.Unlock()
    if _, ok := c.elemList[key]; !ok {
        return errors.New(fmt.Sprintf("key %T do not exist", key))
    }
    c.deleteByKey(key)
    return nil
}

算是熟悉了go語言的基本使用,但是還有很多需要優化的地方,比如優化Set方法的效率,使用讀寫鎖替換互斥鎖。。。。
歡迎討論。

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,321評論 6 543
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,559評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,442評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,835評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,581評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,922評論 1 328
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,931評論 3 447
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,096評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,639評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,374評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,591評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,104評論 5 364
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,789評論 3 349
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,196評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,524評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,322評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,554評論 2 379

推薦閱讀更多精彩內容