Python中的数据对象持久化存储模块pickle的使用示例
Python中可以使用pickle模块将对象转化为文件保存在磁盘上,在需要的时候再读取并还原。具体用法如下:
pickle是Python库中常用的序列化工具,可以将内存对象以文本或二进制格式导出为字符串,或者写入文档。后续可以从字符或文档中还原为内存对象。新版本的Python中用c重新实现了一遍,叫cPickle,性能更高。下面的代码演示了pickle库的常用接口用法,非常简单:
importcPickleaspickle
#dumpsandloads
#将内存对象dump为字符串,或者将字符串load为内存对象
deftest_dumps_and_loads():
t={'name':['v1','v2']}
printt
o=pickle.dumps(t)
printo
print'leno:',len(o)
p=pickle.loads(o)
printp
#关于HIGHEST_PROTOCOL参数,pickle支持3种protocol,0、1、2:
#http://stackoverflow.com/questions/23582489/python-pickle-protocol-choice
#0:ASCIIprotocol,兼容旧版本的Python
#1:binaryformat,兼容旧版本的Python
#2:binaryformat,Python2.3之后才有,更好的支持new-sytleclass
deftest_dumps_and_loads_HIGHEST_PROTOCOL():
print'HIGHEST_PROTOCOL:',pickle.HIGHEST_PROTOCOL
t={'name':['v1','v2']}
printt
o=pickle.dumps(t,pickle.HIGHEST_PROTOCOL)
print'leno:',len(o)
p=pickle.loads(o)
printp
#new-styleclass
deftest_new_sytle_class():
classTT(object):
def__init__(self,arg,**kwargs):
super(TT,self).__init__()
self.arg=arg
self.kwargs=kwargs
deftest(self):
printself.arg
printself.kwargs
#ASCIIprotocol
t=TT('test',a=1,b=2)
o1=pickle.dumps(t)
printo1
print'o1len:',len(o1)
p=pickle.loads(o1)
p.test()
#HIGHEST_PROTOCOL对new-styleclass支持更好,性能更高
o2=pickle.dumps(t,pickle.HIGHEST_PROTOCOL)
print'o2len:',len(o2)
p=pickle.loads(o2)
p.test()
#dumpandload
#将内存对象序列化后直接dump到文件或支持文件接口的对象中
#对于dump,需要支持write接口,接受一个字符串作为输入参数,比如:StringIO
#对于load,需要支持read接口,接受int输入参数,同时支持readline接口,无输入参数,比如StringIO
#使用文件,ASCII编码
deftest_dump_and_load_with_file():
t={'name':['v1','v2']}
#ASCIIformat
withopen('test.txt','w')asfp:
pickle.dump(t,fp)
withopen('test.txt','r')asfp:
p=pickle.load(fp)
printp
#使用文件,二进制编码
deftest_dump_and_load_with_file_HIGHEST_PROTOCOL():
t={'name':['v1','v2']}
withopen('test.bin','wb')asfp:
pickle.dump(t,fp,pickle.HIGHEST_PROTOCOL)
withopen('test.bin','rb')asfp:
p=pickle.load(fp)
printp
#使用StringIO,二进制编码
deftest_dump_and_load_with_StringIO():
importStringIO
t={'name':['v1','v2']}
fp=StringIO.StringIO()
pickle.dump(t,fp,pickle.HIGHEST_PROTOCOL)
fp.seek(0)
p=pickle.load(fp)
printp
fp.close()
#使用自定义类
#这里演示用户自定义类,只要实现了write、read、readline接口,
#就可以用作dump、load的file参数
deftest_dump_and_load_with_user_def_class():
importStringIO
classFF(object):
def__init__(self):
self.buf=StringIO.StringIO()
defwrite(self,s):
self.buf.write(s)
print'len:',len(s)
defread(self,n):
returnself.buf.read(n)
defreadline(self):
returnself.buf.readline()
defseek(self,pos,mod=0):
returnself.buf.seek(pos,mod)
defclose(self):
self.buf.close()
fp=FF()
t={'name':['v1','v2']}
pickle.dump(t,fp,pickle.HIGHEST_PROTOCOL)
fp.seek(0)
p=pickle.load(fp)
printp
fp.close()
#Pickler/Unpickler
#Pickler(file,protocol).dump(obj)等价于pickle.dump(obj,file[,protocol])
#Unpickler(file).load()等价于pickle.load(file)
#Pickler/Unpickler封装性更好,可以很方便的替换file
deftest_pickler_unpickler():
t={'name':['v1','v2']}
f=file('test.bin','wb')
pick=pickle.Pickler(f,pickle.HIGHEST_PROTOCOL)
pick.dump(t)
f.close()
f=file('test.bin','rb')
unpick=pickle.Unpickler(f)
p=unpick.load()
printp
f.close()
pickle.dump(obj,file[,protocol])
这是将对象持久化的方法,参数的含义分别为:
- obj:要持久化保存的对象;
- file:一个拥有write()方法的对象,并且这个write()方法能接收一个字符串作为参数。这个对象可以是一个以写模式打开的文件对象或者一个StringIO对象,或者其他自定义的满足条件的对象。
- protocol:这是一个可选的参数,默认为0,如果设置为1或True,则以高压缩的二进制格式保存持久化后的对象,否则以ASCII格式保存。
对象被持久化后怎么还原呢?pickle模块也提供了相应的方法,如下:
pickle.load(file)
只有一个参数file,对应于上面dump方法中的file参数。这个file必须是一个拥有一个能接收一个整数为参数的read()方法以及一个不接收任何参数的readline()方法,并且这两个方法的返回值都应该是字符串。这可以是一个打开为读的文件对象、StringIO对象或其他任何满足条件的对象。
下面是一个基本的用例:
#-*-coding:utf-8-*-
importpickle
#也可以这样:
#importcPickleaspickle
obj={"a":1,"b":2,"c":3}
#将obj持久化保存到文件tmp.txt中
pickle.dump(obj,open("tmp.txt","w"))
#dosomethingelse...
#从tmp.txt中读取并恢复obj对象
obj2=pickle.load(open("tmp.txt","r"))
printobj2
#-*-coding:utf-8-*-
importpickle
#也可以这样:
#importcPickleaspickle
obj={"a":1,"b":2,"c":3}
#将obj持久化保存到文件tmp.txt中
pickle.dump(obj,open("tmp.txt","w"))
#dosomethingelse...
#从tmp.txt中读取并恢复obj对象
obj2=pickle.load(open("tmp.txt","r"))
printobj2
不过实际应用中,我们可能还会有一些改进,比如用cPickle来代替pickle,前者是后者的一个C语言实现版本,拥有更快的速度,另外,有时在dump时也会将第三个参数设为True以提高压缩比。再来看下面的例子:
#-*-coding:utf-8-*-
importcPickleaspickle
importrandom
importos
importtime
LENGTH=1024*10240
defmain():
d={}
a=[]
foriinrange(LENGTH):
a.append(random.randint(0,255))
d["a"]=a
print"dumping..."
t1=time.time()
pickle.dump(d,open("tmp1.dat","wb"),True)
print"dump1:%.3fs"%(time.time()-t1)
t1=time.time()
pickle.dump(d,open("tmp2.dat","w"))
print"dump2:%.3fs"%(time.time()-t1)
s1=os.stat("tmp1.dat").st_size
s2=os.stat("tmp2.dat").st_size
print"%d,%d,%.2f%%"%(s1,s2,100.0*s1/s2)
print"loading..."
t1=time.time()
obj1=pickle.load(open("tmp1.dat","rb"))
print"load1:%.3fs"%(time.time()-t1)
t1=time.time()
obj2=pickle.load(open("tmp2.dat","r"))
print"load2:%.3fs"%(time.time()-t1)
if__name__=="__main__":
main()
#-*-coding:utf-8-*-
importcPickleaspickle
importrandom
importos
importtime
LENGTH=1024*10240
defmain():
d={}
a=[]
foriinrange(LENGTH):
a.append(random.randint(0,255))
d["a"]=a
print"dumping..."
t1=time.time()
pickle.dump(d,open("tmp1.dat","wb"),True)
print"dump1:%.3fs"%(time.time()-t1)
t1=time.time()
pickle.dump(d,open("tmp2.dat","w"))
print"dump2:%.3fs"%(time.time()-t1)
s1=os.stat("tmp1.dat").st_size
s2=os.stat("tmp2.dat").st_size
print"%d,%d,%.2f%%"%(s1,s2,100.0*s1/s2)
print"loading..."
t1=time.time()
obj1=pickle.load(open("tmp1.dat","rb"))
print"load1:%.3fs"%(time.time()-t1)
t1=time.time()
obj2=pickle.load(open("tmp2.dat","r"))
print"load2:%.3fs"%(time.time()-t1)
if__name__=="__main__":
main()
在我的电脑上执行结果为:
dumping… dump1:1.297s dump2:4.750s 20992503,68894198,30.47% loading… load1:2.797s load2:10.125s
可以看到,dump时如果指定了protocol为True,压缩过后的文件的大小只有原来的文件的30%,同时无论在dump时还是load时所耗费的时间都比原来少。因此,一般来说,可以建议把这个值设为True。
另外,pickle模块还提供dumps和loads两个方法,用法与上面的dump和load方法类似,只是不需要输入file参数,输入及输出都是字符串对象,有些场景中使用这两个方法可能更为方便。