From d694c17c535a2a690491f2547f39c0d44d5df9e1 Mon Sep 17 00:00:00 2001 From: AceVest Date: Sun, 19 Mar 2017 17:28:36 +0800 Subject: [PATCH] Swift - Deinitialization ARC OptionalChaining --- .../Pages/ARC.xcplaygroundpage/Contents.swift | 323 ++++++++++++++++++ .../Contents.swift | 57 ++++ .../Contents.swift | 227 ++++++++++++ .../AcePlay.playground/Sources/Utils.swift | 1 + .../AcePlay.playground/contents.xcplayground | 3 + .../UserInterfaceState.xcuserstate | Bin 24458 -> 26940 bytes 6 files changed, 611 insertions(+) create mode 100644 learn/AcePlay/AcePlay.playground/Pages/ARC.xcplaygroundpage/Contents.swift create mode 100644 learn/AcePlay/AcePlay.playground/Pages/Deinitialization.xcplaygroundpage/Contents.swift create mode 100644 learn/AcePlay/AcePlay.playground/Pages/OptionalChaining.xcplaygroundpage/Contents.swift diff --git a/learn/AcePlay/AcePlay.playground/Pages/ARC.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/ARC.xcplaygroundpage/Contents.swift new file mode 100644 index 0000000..5f157bb --- /dev/null +++ b/learn/AcePlay/AcePlay.playground/Pages/ARC.xcplaygroundpage/Contents.swift @@ -0,0 +1,323 @@ +//: [Previous](@previous) + +import Foundation + +var str = "Hello, Automatic Reference Counting" + +//: [Next](@next) + + +// 引用计数仅仅应用于类的实例。结构体和枚举类型是值类型,不是引用类型,也不是通过引用的方式存储和传递 + + +class Apartment { + var address: String + init(address: String) { + self.address = address + } + + var tenant: Person? + + deinit { + print("Apartment \(self.address) is being deinitialized") + } +} + +class Person { + var name: String + + init(name: String) { + if name.isEmpty { + self.name = "[Unnamed]" + } else { + self.name = name + } + + print("Person \(name) is being initialized") + } + + + deinit { + print("Person \(name) is being deinitialized") + } + + var apartment: Apartment? +} + + +var reference1: Person? +var reference2: Person? +var reference3: Person? + + +reference1 = Person(name: "Ace") +reference2 = reference1 +reference3 = reference1 + +reference1 = nil +reference2 = nil + +// 现在这个Person实例还不会被销毁 + +print("----------destroy reference3------------") +reference3 = nil + + + +// 类间的循环强引用 +var abel: Person? +var unit4A: Apartment? + +abel = Person(name: "abel") +unit4A = Apartment(address: "Apartment 4A") + +abel!.apartment = unit4A +unit4A!.tenant = abel + + +// 解决实例之间的循环强引用 +// 弱引用( weak reference )和无主引用( unowned reference ) +// 1. 对于生命周期中会变为 nil 的实例使用弱引用 +// 2. 对于初始化赋值后再也不会被赋值为 nil 的实例,使用无主引用 + + +// 弱引用 +// 场景1: 一个人可以没有公寓,一个公寓也可以没有租客 +class PersonWeak { + var name: String + + init(name: String) { + if name.isEmpty { + self.name = "[Unnamed]" + } else { + self.name = name + } + + print("PersonWeak \(name) is being initialized") + } + + + deinit { + print("PersonWeak \(name) is being deinitialized") + } + + var apartment: ApartmentWeak? +} + +class ApartmentWeak { + var address: String + init(address: String) { + self.address = address + } + + + // 由于弱引用需要允许它们的值为 nil ,它们一定得是可选类型 + weak var tenant: PersonWeak? + + deinit { + print("ApartmentWeak \(self.address) is being deinitialized") + } +} + + +// 这意味着当PersonWeak bill的强引用被设置为nil时, ApartmentWeak对PersonWeak的弱引用tenant自动设置为nil +var bill: PersonWeak? +var unit7C: ApartmentWeak? + +bill = PersonWeak(name: "Bill") +unit7C = ApartmentWeak(address: "ApartmentWeak 7C") +bill!.apartment = unit7C +unit7C!.tenant = bill +print("----------destroy bill------------") +// PersonWeak实例依然保持对ApartmentWeak实例的强引用 +// 但是ApartmentWeak实例现在对PersonWeak实例是弱引用 +// 这意味着当你断开bill变量所保持的强引用时,再也没有指向PersonWeak实例的强引用了,由于再也没有指向PersonWeak实例的强引用,该实例会被释放 +bill = nil + + +print("----------destroy unit7C------------") +// 现在只剩下来自unit7C变量对ApartmentWeak实例的强引用。如果你打断这个强引用,那么ApartmentWeak实例就再也没有强引用了 +unit7C = nil + + + +// 无主引用 +// 无主引用假定是永远有值的。因此,无主引用总是被定义为非可选类型 +// 场景2: 一个用户可以没有信用卡,一张信用卡必须有持有人 +class Customer { + let name: String + var card: CreditCard? + + init(name: String) { + self.name = name + } + + deinit { + print("\(name) is being uninitialized") + } +} + +class CreditCard { + let number: UInt64 + unowned let customer: Customer + + init(number: UInt64, customer: Customer) { + self.number = number + self.customer = customer + } + + deinit { + print("Card #\(self.number) is being uninitialized") + } +} + + + +var carl: Customer? +carl = Customer(name: "Carl") +carl!.card = CreditCard(number: 314_1414_1732, customer: carl!) + +// 现在Customer实例对CreditCard实例有一个强引用,并且CreditCard实例对Customer实例有一个无主引用 +// 由于 Customer 的无主引用,当你断开 john 变量持有的强引用时,那么就再也没有指向 Customer 实例的强引用了 +// 因为不再有 Customer 的强引用,该实例被释放了。其后,再也没有指向 CreditCard 实例的强引用,该实例也随之被释放了 +print("----------destroy carl------------") +carl = nil + + + + + + +// 无主引用和隐式展开的可选属性 +// 除了两个属性的值都允许为nil和一个属性的值允许为nil,而另一个属性的值不允许为nil的场景 +// 还有第三种场景,在这种场景中,两个属性都必须有值,并且初始化完成后永远不会为nil。在这种场景中,需要一个类使用无主属性,而另外一个类使用隐式展开的可选属性 + +// 场景三: 一个国家必定有首都城市,一个城市必定属于一个国家 +class Country { + let name: String + var capital: City! + + init(name: String, capitalName: String) { + self.name = name + self.capital = City(name: capitalName, country: self) + } + + deinit { + print("Country: \(name) is being uninitialized") + } +} + + +class City { + let name: String + unowned let country: Country + + init(name: String, country: Country) { + self.name = name + self.country = country + } + + deinit { + print("City: \(name) is being uninitialized") + } +} + +var country: Country? = Country(name: "Canada", capitalName: "Ottwa") +print("\(country!.name)'s capital city is called \(country!.capital.name)") + +print("----------destroy country------------") +country = nil + + + + + +// 闭包的循环强引用 + +class HTMLElement { + + let name: String + let text: String? + + lazy var asHTML: () -> String = { + if let text = self.text { + return "<\(self.name)>\(text)" + } else { + return "<\(self.name) />" + } + } + + init(name: String, text: String? = nil) { + self.name = name + self.text = text + } + + deinit { + print("HTMLElement: \(name) is being deinitialized") + } + +} + +var paragraph: HTMLElement? = HTMLElement(name: "p", text: "hello, world") +print(paragraph!.asHTML()) + +// 此时就处把paragraph设置为nil,paragraph曾指向的实例和闭包之间还是强引用 +// HTMLElement 实例和它的闭包都不会被释放 +paragraph = nil + + +// Swift通过闭包捕获列表来解决这个问题 +// Swift要求你在闭包中引用self成员时使用self.someProperty或者self.someMethod 而不只是 someProperty或someMethod)。这有助于提醒你可能会一不小心就捕获了self + +// 捕获列表中的每一项都由 weak 或 unowned 关键字与类实例的引用(如 self )或初始化过的变量(如 delegate = self.delegate! )成对组成。这些项写在方括号中用逗号分开。 +// 把捕获列表放在形式参数和返回类型前边,如果它们存在的话 + + +//lazy var someClosure: (Int, String) -> String = { +// [unowned self, weak delegate = self.delegate!] (index: Int, stringToProcess: String) -> String in +// // closure body goes here +//} + + +// 如果闭包没有指明形式参数列表或者返回类型,是因为它们会通过上下文推断,那么就把捕获列表放在关键字 in 前边,闭包最开始的地方 +//lazy var someClosure: Void -> String = { +// [unowned self, weak delegate = self.delegate!] in +// // closure body goes here +//} + + + +// 弱引用和无主引用 +// 在闭包和捕获的实例总是互相引用并且总是同时释放时,将闭包内的捕获定义为无主引用 +// 在被捕获的引用可能会变为 nil 时,定义一个弱引用的捕获。弱引用总是可选项,当实例的引用释放时会自动变为 nil 。这使我们可以在闭包体内检查它们是否存在 +// 如果被捕获的引用永远不会变为 nil ,应该用无主引用而不是弱引用 + +class HTMLElementV2 { + + let name: String + let text: String? + + lazy var asHTML: () -> String = { + [unowned self] in + if let text = self.text { + return "<\(self.name)>\(text)" + } else { + return "<\(self.name) />" + } + } + + init(name: String, text: String? = nil) { + self.name = name + self.text = text + } + + deinit { + print("HTMLElementV2: \(name) is being deinitialized") + } +} + +print("----------destroy paragraph2------------") +var paragraph2: HTMLElementV2? = HTMLElementV2(name: "p", text: "hello ARC") +paragraph2 = nil + +print("begin deinit") \ No newline at end of file diff --git a/learn/AcePlay/AcePlay.playground/Pages/Deinitialization.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/Deinitialization.xcplaygroundpage/Contents.swift new file mode 100644 index 0000000..f0e828a --- /dev/null +++ b/learn/AcePlay/AcePlay.playground/Pages/Deinitialization.xcplaygroundpage/Contents.swift @@ -0,0 +1,57 @@ +//: [Previous](@previous) + +import Foundation + +var str = "Hello, Deinitialization" + +//: [Next](@next) + +// 析构器只适用于类类型 + +// 子类继承了父类的析构器,并且在子类析构器实现的最后,父类的析构器会被自动调用。即使子类没有提供自己的析构器,父类的析构器也同样会被调用 + +class Bank { + static var totalCoins = 10000 + + static func distribute(coins numberOfCoinsRequested: Int) -> Int { + let numberOfCoinsToVend = min(totalCoins, numberOfCoinsRequested) + + totalCoins -= numberOfCoinsToVend + + return numberOfCoinsToVend + } + + static func receive(coins: Int) { + totalCoins += coins + } +} + + +class Player { + var coinsInPurse: Int + + init(coins: Int) { + coinsInPurse = Bank.distribute(coins: coins) + } + + func win(coins: Int) { + coinsInPurse += Bank.distribute(coins: coins) + } + + deinit { + Bank.receive(coins: coinsInPurse) + } +} + + +var player: Player? = Player(coins: 100) +print("A player has joined the game with \(player!.coinsInPurse) coins") +print("There are now \(Bank.totalCoins) coins left in the bank") + +player?.win(coins: 1000) +print("A player won 1000 coins and now has \(player!.coinsInPurse) coins") +print("There are now \(Bank.totalCoins) coins left in the bank") + +player = nil +print("the player has left the game") +print("There are now \(Bank.totalCoins) coins left in the bank") diff --git a/learn/AcePlay/AcePlay.playground/Pages/OptionalChaining.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/OptionalChaining.xcplaygroundpage/Contents.swift new file mode 100644 index 0000000..0705036 --- /dev/null +++ b/learn/AcePlay/AcePlay.playground/Pages/OptionalChaining.xcplaygroundpage/Contents.swift @@ -0,0 +1,227 @@ +//: [Previous](@previous) + +import Foundation + +var str = "Hello, Optional Chaining" + +//: [Next](@next) + + +// 使用可选链式调用代替强制展开 +// 通过在想调用的属性、方法、或下标的可选值后面放一个问号(?),可以定义一个可选链。这一点很像在可选值后面放一个叹号(!)来强制展开它的值。 +// 它们的主要区别在于当可选值为空时可选链式调用只会调用失败,然而强制展开将会触发运行时错误。 + +// 特别地,可选链式调用的返回结果与原本的返回结果具有相同的类型,但是被包装成了一个可选值。 +// 例如,使用可选链式调用访问属性,当可选链式调用成功时,如果属性原本的返回结果是Int类型,则会变为Int?类型 + +class PersonV1 { + var residence: RecidenceV1? +} + +class RecidenceV1 { + var numberOfRooms = 7 +} + +let john = PersonV1() + +// 当john.residence==nil时以下这句会引发运行错误 +// let roomCount == john.residence!.numberOfRooms + +if let roomCount = john.residence?.numberOfRooms { + print("John's residence has \(roomCount) room(s)") +} else { + print("Unable to retrieve the number of rooms.") +} + + + + +john.residence = RecidenceV1() +if let roomCount = john.residence?.numberOfRooms { + print("John's residence has \(roomCount) room(s)") +} else { + print("Unable to retrieve the number of rooms.") +} + + +// 通过使用可选链式调用可以调用多层属性、方法和下标。这样可以在复杂的模型中向下访问各种子属性,并且判断能否访问子属性的属性、方法或下标。 +class Person { + var residence: Recidence? +} + +class Recidence { + var rooms = [Room]() + var numberOfRooms: Int { + return rooms.count + } + var address: Address? + + subscript(i: Int) -> Room { + get { + return rooms[i] + } + set { + rooms[i] = newValue + } + } + + func printNumberOfRooms() { + print("The number of room is \(numberOfRooms)") + } + +} + +class Room { + let name: String + init(name: String) { + self.name = name + } +} + +class Address { + var buildingName: String? + var buildingNumber: String? + var street: String? + + func buildingIdentifier() -> String? { + if buildingName != nil { + return buildingName + } else if buildingNumber != nil && street != nil { + return "\(buildingNumber!) \(street!)" + } else { + return nil + } + } +} + +let obama = Person() +if let roomCount = obama.residence?.numberOfRooms { + print("Obama's residence has \(roomCount) room(s)") +} else { + print("Unable to retrieve the number of rooms.") +} + + +let addr = Address() +addr.buildingNumber = "31" +addr.street = "Wall Street" + +obama.residence?.address = addr // 此时residence==nil,会设置失败 +// 上面的赋值过程是可选链式调用的一部分,这意味着可选链式调用失败时,等号右侧的代码不会被执行 + + +func CreateAddress() -> Address { + print("CreateAddress was Called") + let addr = Address() + addr.buildingNumber = "13" + addr.street = "Pennsylvania Avenue" + return addr +} + +obama.residence?.address = CreateAddress() // 可以通过并未输出print内容来验证出CreateAddress并未被执行 + + +// 对于Residence.printNumberOfRooms +// 如果在可选值上通过可选链式调用来调用这个方法,该方法的返回类型会是Void?,而不是Void,因为通过可选链式调用得到的返回值都是可选的 + +if obama.residence?.printNumberOfRooms() == nil { + print("It was not possible to print the number of rooms.") +} else { + print("It was possible to print the number of rooms.") +} + + +// 同样的,可以据此判断通过可选链式调用为属性赋值是否成功 +// 即使residence为nil。通过可选链式调用给属性赋值会返回Void?,通过判断返回值是否为nil就可以知道赋值是否成功 +if (obama.residence?.address = addr) == nil { + print("It was not possible to set the address.") +} else { + print("It was possible to set the address.") +} + + + + +// 通过可选链式调用访问下标 +// 注意: 通过可选链式调用访问可选值的下标时,应该将问号放在下标方括号的前面而不是后面。可选链式调用的问号一般直接跟在可选表达式的后面。 +if let firstRoomName = obama.residence?[0].name { + print("The first room name is \(firstRoomName).") +} else { + print("Unable to retrieve the first room name.") +} + + +print("It's time to buy a house for Obama") +let obamaHouse = Recidence() +obamaHouse.rooms.append(Room(name: "Kitchen")) +obamaHouse.rooms.append(Room(name: "Living Room")) + +obama.residence = obamaHouse + +if let firstRoomName = obama.residence?[0].name { + print("The first room name is \(firstRoomName).") +} else { + print("Unable to retrieve the first room name.") +} + + + + +// 访问可选类型的下标 +var scores = ["Trump": [59, 48,66], "Obama": [44, 65, 73], "Bush": [23, 32, 45], "Clinton": [37, 76, 19]] +scores["Trump"]?[0] = 58 +scores["Bush"]?[2] += 4 +// scores["Clinton"]?[5] = 33 // error 因为,可选链会返回一个数组,然后索引为5就超出了范围 +scores["Ace"]?[1] = 100 // 调用失败,但不会出错 +print(scores.description) + + + +// 连接多层可选链式调用 +// 可以通过连接多个可选链式调用在更深的模型层级中访问属性、方法以及下标。然而,多层可选链式调用不会增加返回值的可选层级。 +// 也就是说 +// 1. 如果你访问的值不是可选的,可选链式调用将会返回可选值 +// 2. 如果你访问的值就是可选的,可选链式调用不会让可选返回值变得“更可选” + +// 因此 +// 通过可选链式调用访问一个Int值,将会返回Int?,无论使用了多少层可选链式调用 +// 通过可选链式调用访问Int?值,依旧会返回Int?值,并不会返回Int?? + + +if let obamasStreet = obama.residence?.address?.street { + print("Obama's street name is \(obamasStreet)") +} else { + print("Unable to retrieve the address") +} + +print("It's time to give address to Obama's House") +obama.residence?.address = CreateAddress() +if let obamasStreet = obama.residence?.address?.street { + print("Obama's street name is \(obamasStreet)") +} else { + print("Unable to retrieve the address") +} + + + +// 在方法的可选返回值上进行可选链式调用 +// 上面的例子展示了如何在一个可选值上通过可选链式调用来获取它的属性值 +// 还可以在一个可选值上通过可选链式调用来调用方法 +// 并且可以根据需要继续在方法的可选返回值上进行可选链式调用 + +if let buildingIdentifier = obama.residence?.address?.buildingIdentifier() { + print("Obama's building identifier is \(buildingIdentifier)") +} + + +// 还可以在该方法的返回值上进行链式调用 + +if let beginWithThe = obama.residence?.address?.buildingIdentifier()?.hasPrefix("The") { + if beginWithThe { + print("Obama's building identifier begins with \"The\"") + } else { + print("Obama's building identifier does not begins with \"The\"") + } +} + +print("End") diff --git a/learn/AcePlay/AcePlay.playground/Sources/Utils.swift b/learn/AcePlay/AcePlay.playground/Sources/Utils.swift index 17f7185..0c6c20d 100644 --- a/learn/AcePlay/AcePlay.playground/Sources/Utils.swift +++ b/learn/AcePlay/AcePlay.playground/Sources/Utils.swift @@ -5,3 +5,4 @@ func printLine(_ title: String) -> Void { let line = String(format:"-----------------------------------<%@>", title) print(line) } + diff --git a/learn/AcePlay/AcePlay.playground/contents.xcplayground b/learn/AcePlay/AcePlay.playground/contents.xcplayground index 17e0832..bc794cb 100644 --- a/learn/AcePlay/AcePlay.playground/contents.xcplayground +++ b/learn/AcePlay/AcePlay.playground/contents.xcplayground @@ -13,5 +13,8 @@ + + + \ No newline at end of file diff --git a/learn/AcePlay/AcePlay.playground/playground.xcworkspace/xcuserdata/Ace.xcuserdatad/UserInterfaceState.xcuserstate b/learn/AcePlay/AcePlay.playground/playground.xcworkspace/xcuserdata/Ace.xcuserdatad/UserInterfaceState.xcuserstate index 1389b401d573fc3a705cb698621b06748decd45a..c4b2fc51b59995cfa400e1254076717c83d2968b 100644 GIT binary patch literal 26940 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 YD~i_gH7