shelve --- Python 對(duì)象持久化?

限制?

• 可選擇使用哪種數(shù)據(jù)庫包 (例如 dbm.ndbm 或 dbm.gnu) 取決于支持哪種接口。 因此使用 dbm 直接打開數(shù)據(jù)庫是不安全的。 如果使用了 dbm，數(shù)據(jù)庫同樣會(huì)（不幸地）受限于它 --- 這意味著存儲(chǔ)在數(shù)據(jù)庫中的（封存形式的）對(duì)象尺寸應(yīng)當(dāng)較小，并且在少數(shù)情況下鍵沖突有可能導(dǎo)致數(shù)據(jù)庫拒絕更新。

• shelve 模塊不支持對(duì) Shelf 對(duì)象的 并發(fā) 讀/寫訪問。 （多個(gè)同時(shí)讀取訪問則是安全的。） 當(dāng)一個(gè)程序打開一個(gè) shelve 對(duì)象來寫入時(shí)，不應(yīng)再有其他程序同時(shí)打開它來讀取或?qū)懭搿?Unix 文件鎖定可被用來解決此問題，但這在不同 Unix 版本上會(huì)存在差異，并且需要有關(guān)所用數(shù)據(jù)庫實(shí)現(xiàn)的細(xì)節(jié)知識(shí)。

class shelve.Shelf(dict, protocol=None, writeback=False, keyencoding='utf-8')?

collections.abc.MutableMapping 的一個(gè)子類，它會(huì)將封存的值保存在 dict 對(duì)象中。

在默認(rèn)情況下，會(huì)使用以 pickle.DEFAULT_PROTOCOL 創(chuàng)建的 pickle 來序列化值。 pickle 協(xié)議的版本可通過 protocol 形參來指定。 請(qǐng)參閱 pickle 文檔來查看 pickle 協(xié)議的相關(guān)討論。

如果 writeback 形參為 True，對(duì)象將為所有訪問過的條目保留緩存并在同步和關(guān)閉時(shí)將它們寫回到 dict。 這允許對(duì)可變的條目執(zhí)行自然操作，但是會(huì)消耗更多內(nèi)存并讓同步和關(guān)閉花費(fèi)更長時(shí)間。

keyencoding 形參是在下層字典被使用之前用于編碼鍵的編碼格式。

Shelf 對(duì)象還可以被用作上下文管理器，在這種情況下它將在 with 語句塊結(jié)束時(shí)自動(dòng)被關(guān)閉。

在 3.2 版更改: 添加了 keyencoding 形參；之前，鍵總是使用 UTF-8 編碼。

在 3.4 版更改: 添加了上下文管理器支持。

在 3.10 版更改: pickle.DEFAULT_PROTOCOL 現(xiàn)在會(huì)被用作默認(rèn)的 pickle 協(xié)議。

class shelve.BsdDbShelf(dict, protocol=None, writeback=False, keyencoding='utf-8')?

Shelf 的一個(gè)子類，將 first(), next(), previous(), last() 和 set_location() 對(duì)外公開，在來自 pybsddb 的第三方 bsddb 模塊中可用，但在其他數(shù)據(jù)庫模塊中不可用。 傳給構(gòu)造器的 dict 對(duì)象必須支持這些方法。 這通常是通過調(diào)用 bsddb.hashopen(), bsddb.btopen() 或 bsddb.rnopen() 之一來完成的。 可選的 protocol, writeback 和 keyencoding 形參具有與 Shelf 類相同的含義。

class shelve.DbfilenameShelf(filename, flag='c', protocol=None, writeback=False)?

Shelf 的一個(gè)子類，它接受一個(gè) filename 而非字典類對(duì)象。 下層文件將使用 dbm.open() 來打開。 默認(rèn)情況下，文件將以讀寫模式打開。 可選的 flag 形參具有與 open() 函數(shù)相同的含義。 可選的 protocol 和 writeback 形參具有與 Shelf 類相同的含義。

示例?

對(duì)接口的總結(jié)如下 (key 為字符串，data 為任意對(duì)象):

import shelve

d = shelve.open(filename)  # open -- file may get suffix added by low-level
                           # library

d[key] = data              # store data at key (overwrites old data if
                           # using an existing key)
data = d[key]              # retrieve a COPY of data at key (raise KeyError
                           # if no such key)
del d[key]                 # delete data stored at key (raises KeyError
                           # if no such key)

flag = key in d            # true if the key exists
klist = list(d.keys())     # a list of all existing keys (slow!)

# as d was opened WITHOUT writeback=True, beware:
d['xx'] = [0, 1, 2]        # this works as expected, but...
d['xx'].append(3)          # *this doesn't!* -- d['xx'] is STILL [0, 1, 2]!

# having opened d without writeback=True, you need to code carefully:
temp = d['xx']             # extracts the copy
temp.append(5)             # mutates the copy
d['xx'] = temp             # stores the copy right back, to persist it

# or, d=shelve.open(filename,writeback=True) would let you just code
# d['xx'].append(5) and have it work as expected, BUT it would also
# consume more memory and make the d.close() operation slower.

d.close()                  # close it