Swift - 使用UserDefaults来进行本地数据存储
作者:hangge | 2015-03-24 11:16
(本文代码已升级至Swift3)

对于 UIImage 对象的存储比较特殊。注意下方高亮部分,如果我们过直接把 image1 存储起来,再取出转换回 UIImage 就变成了 nil。必须先转成 image2 再存储。
UserDefaults 适合存储轻量级的本地客户端数据,比如记住密码功能,要保存一个系统的用户名、密码。使用 UserDefaults 是首选。下次再登陆的时候就可以直接从 UserDefaults 里面读取上次登陆的信息。
一般来说本地存储数据我们还可以是用 SQlite 数据库,或者使用自己建立的 plist 文件什么的,但这还得自己显示创建文件,读取文件,很麻烦,而是用 UserDefaults 则不用管这些东西,就像读字符串一样,直接读取就可以了。
UserDefaults 支持的数据格式也很多,有:Int,Float,Double,BOOL,Array,Dictionary,甚至 Any 类型。
注意:不建议使用 UserDefaults 存储大文件数据
- UserDefaults 里面的数据最终是保存到 .plist 文件中,理论上 UserDefaults 存放好几个 G 的数据是可以实现的(取决于设备剩余的空间)。
- 但 UserDefaults 设计就不是用来存储大数据的。因为当应用启动时会自动加载 Userdefault 里所有的数据,如果太大的话就会造成启动缓慢,影响性能。
- 所以大文件还是建议使用 Core Data、 CloudKit、SQLite 等结构化存储方式。
1,下面通过一个样例演示UserDefaults的用法:
(1)如果是第一次运行程序通过 CFUUIDCreate 方法生成一个唯一字符串作为用户id储存起来(形如:B8DDB58D-73BF-4E39-A051-365858FC4626)
(2)往后运行时直接从 UserDefaults 中把用户id取出
import UIKit
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
print("用户uuid:\(get_uuid())")
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
func get_uuid() -> String{
let userid = UserDefaults.standard.string(forKey: "hangge")
//判断UserDefaults中是否已经存在
if(userid != nil){
return userid!
}else{
//不存在则生成一个新的并保存
let uuid_ref = CFUUIDCreate(nil)
let uuid_string_ref = CFUUIDCreateString(nil , uuid_ref)
let uuid = uuid_string_ref as! String
UserDefaults.standard.set(uuid, forKey: "hangge")
return uuid
}
}
执行结果如下:
2,对原生数据类型的储存和读取
let userDefault = UserDefaults.standard
//Any
userDefault.set("hangge.com", forKey: "Object")
let objectValue:Any? = userDefault.object(forKey: "Object")
//Int类型
userDefault.set(12345, forKey: "Int")
let intValue = userDefault.integer(forKey: "Int")
//Float类型
userDefault.set(3.2, forKey: "Float")
let floatValue = userDefault.float(forKey: "Float")
//Double类型
userDefault.set(5.2240, forKey: "Double")
let doubleValue = userDefault.double(forKey: "Double")
//Bool类型
userDefault.set(true, forKey: "Bool")
let boolValue = userDefault.bool(forKey: "Bool")
//URL类型
userDefault.set(URL(string:"http://hangge.com")!, forKey: "URL")
let urlValue = userDefault.url(forKey: "URL")
//String类型
userDefault.set("hangge.com", forKey: "String")
let stringValue = userDefault.string(forKey: "String")
//NSNumber类型
var number = NSNumber(value:22)
userDefault.set(number, forKey: "NSNumber")
number = userDefault.object(forKey: "NSNumber") as! NSNumber
//Array类型
var array:Array = ["123","456"]
userDefault.set(array, forKey: "Array")
array = userDefault.array(forKey: "Array") as! [String]
//Dictionary类型
var dictionary = ["1":"hangge.com"]
userDefault.set(dictionary, forKey: "Dictionary")
dictionary = userDefault.dictionary(forKey: "Dictionary") as! [String : String]
3,系统对象的存储与读取
系统对象实现存储,需要通过 archivedData 方法转换成 Data 为载体,才可以存储。下面以 UILabel 对象为例:let userDefault = UserDefaults.standard //UILabel对象存储 //将对象转换成Data流 let label = UILabel() label.text = "欢迎访问hangge.com" let labelData = NSKeyedArchiver.archivedData(withRootObject: label) //存储Data对象 userDefault.set(labelData, forKey: "labelData") //UILabel对象读取 //获取Data let objData = userDefault.data(forKey: "labelData") //还原对象 let myLabel = NSKeyedUnarchiver.unarchiveObject(with: objData!) as? UILabel print(myLabel)
对于 UIImage 对象的存储比较特殊。注意下方高亮部分,如果我们过直接把 image1 存储起来,再取出转换回 UIImage 就变成了 nil。必须先转成 image2 再存储。
let userDefault = UserDefaults.standard
//UIImage对象存储
//将对象转换成Data流
let image1 = UIImage(named: "apple.png")!
let image2 = UIImage(cgImage: image1.cgImage!, scale: image1.scale,
orientation: image1.imageOrientation)
let imageData = NSKeyedArchiver.archivedData(withRootObject: image2)
//存储Data对象
userDefault.set(imageData, forKey: "imageData")
//UIImage对象读取
//获取Data
let objData = userDefault.data(forKey: "imageData")
//还原对象
let myImage = NSKeyedUnarchiver.unarchiveObject(with: objData!) as? UIImage
print(myImage)
4,自定义对象的存储和读取
如果想要存储自己定义的类,首先需要对该类实现 NSCoding 协议来进行归档和反归档(序列化和反序列化)。即该类内添加 func encode(with coder: NSCoder) 方法和 init(coder decoder: NSCoder) 方法,将属性进行转换。let userDefault = UserDefaults.standard
//自定义对象存储
let model = UserInfo(name: "航歌", phone: "3525")
//实例对象转换成Data
let modelData = NSKeyedArchiver.archivedData(withRootObject: model)
//存储Data对象
userDefault.set(modelData, forKey: "myModel")
//自定义对象读取
let myModelData = userDefault.data(forKey: "myModel")
let myModel = NSKeyedUnarchiver.unarchiveObject(with: myModelData!) as! UserInfo
print(myModel)
//----- 自定义对象类 -----
class UserInfo: NSObject, NSCoding {
var name:String
var phone:String
//构造方法
required init(name:String="", phone:String="") {
self.name = name
self.phone = phone
}
//从object解析回来
required init(coder decoder: NSCoder) {
self.name = decoder.decodeObject(forKey: "Name") as? String ?? ""
self.phone = decoder.decodeObject(forKey: "Phone") as? String ?? ""
}
//编码成object
func encode(with coder: NSCoder) {
coder.encode(name, forKey:"Name")
coder.encode(phone, forKey:"Phone")
}
}
5,删除存储对象
通过 removeObject() 方法可以删除已保存的数据。当然如果这个存储对象不存在也不会报错。UserDefaults.standard.removeObject(forKey: "hangge")
全部评论(5)
如果需要存储很多图片,例如300多张,用文中说的对UIImage对象的存储方式可以么?Userdefault一般用来存储小数据,这么多图片是不是要用CoreData或者其他方式进行存储的呢?
站长回复:如果图片少量的话,存在UserDefaults没什么问题。但300张这么多的话还是不建议存在Userdefault里面。
因为Userdefault就不是设计用来存储大数据的,当应用启动时会自动加载Userdefault里所有的数据,如果太大的话就会造成启动缓慢。
所以大量的图片还是建议使用Core Data、 SQLite、或者本地文件存储。
楼主,可以发个demo吗
站长回复:我把文章修改了下,顺便把代码改成Swift3了,你可以再看下。
站长,我用您的这篇文章写了一个登录之后的一个带走侧栏的页面 -Swift - 侧滑菜单的实现(样例1:主页向右滑动,露出下方菜单页)-
目前的方法是这样的,登录页面登录成功以后装一个
我在侧栏的那个里面写了一个退出登录的按钮,NSUserDefaults值是ok,然后主页面的viewdidload判断NSUserDefaults值是不是ok来判断是否登录,在侧栏的退出登录键里把NSUserDefaults的值更改成别的
但是这样出现一个问题,每次退出的时候,主页面仍然记录着之前的登录状态(NSUserDefaults值为ok的)我在想,是不是因为侧栏划回来并不会触发viewdidload方法,这有什么办法解决呢?
站长回复:来回滑动不会触发viewdidload方法的,应该是其它原因引起的。这个要靠你自己调试了。
额,站长刚才忘了问了,如果我要是做一个退出账号登录的动作,该怎么实现,这个我是一点方法都没有,不会写。。。。
站长回复:退出的时候,用removeObjectForKey方法删除存储数据就好了。例如:
NSUserDefaults.standardUserDefaults().removeObjectForKey("username")
站长,我用这个存储用户名和密码的时候发现了一个问题
我正常的流程是:主页面(未登录)-登录页面-主页面(已登录),但是现在出了个问题就是当我模拟用户,头一次下载app的时候,进入主页面(未登录)时候,程序报错了,我注释了controller里viewdidload的userDefault的取出,他就没事了。所以我感觉是因为我初次进入app,userDefault里没有数据导致闪退出程序。
于是我反复测试了几次,结果和我想的一样,头一次进入的时候userDefault里面没有数据,他就会报错,这个问题怎么解决呢?我目前的想法是做一个判断,如果里面没有数据,就跳出。活着直接给一个初始值,叫用户自己更改,但是觉得还有点不对劲,请站长给我出出主意,有例子的话就更好了,谢谢站长
站长回复:这个你取数据的时候判断下得到的是否为空就好了,比如: