用 SwiftFoursquare API 和 Realm 創建一個咖啡屋 App
Posted 颐和园
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了用 SwiftFoursquare API 和 Realm 創建一個咖啡屋 App相关的知识,希望对你有一定的参考价值。
- 原文链接 : Building a Coffee Shop App with Swift, Foursquare API and Realm
- 原文作者 : De Vries Reinder
- 译文出自 : APPCODA
- 译者 : kmyhy
人們常說,程序員能將咖啡變成電腦程式。接下來,我們將編寫一個 App,列出距離你最近的咖啡屋!
在本教程中,你將使用到如下技能:
- Swift、Xcode 和 Interface Builder (自動佈局、約束和故事板)
- Realm,一個輕量級的 Core Data 封裝,用於本地數據庫。
- Foursquare,用 “Das Quadrat” 庫來訪問 Foursquare 的 REST API。
- CocoaPods 和 Geolocation
這個 App 會以你當前位置為中心,從 Foursquare 抓取以此為中心 500*500 米範圍內的地標信息。然後用一個地圖視圖(MKMapView)和表格視圖(UITableView)來顯示這些數據。并使用 Realm 來篩選數據,并在閉包中對數據進行排序。
你可以從 GitHub 上下載完整的的源代碼和 Xcode 項目:reinderdevries/CoffeeGuide
如此簡單?讓我們快快進入正題吧!
設置 Xcode 項目
首先,我們需要在 Xcode 進行一些設置。打開 Xcode,選擇 File\New\Project…
在 ios\Application 類別下選擇 Single View Application。然後,填写這些内容:
- Product Name: Coffee
- Organization Name: 任意
- Organization Identifier: 任意,用反域名格式:com.mycompanyname
- Language: Swift
- Devices: iPhone
- 反選 Use Core Data、Include Unit Tests 以及 Incluse UI Tests
然後選擇項目存放路徑,“創建本地庫”(create a local Git repository)一項可選可不選。
接下來,需要創建一個 Podfile 文件。在項目導航窗口,在項目名稱上右鍵,選擇 New File…,如下圖所示,選擇 iOS\Other 下的 Empty 模板。
將文件命名為 Podfile(沒有擴展名),然后將它保存在 .xcodeproj 文件的同一目錄下。最後,確認一下 Tagets 列表下 Coffee 前面的選擇框已被正確勾選。
然後,在 Podfile 文件中輸入以下內容:
source ‘https://github.com/CocoaPods/Specs.git‘ platform :ios, ‘8.0‘ use_frameworks! pod ‘QuadratTouch‘, ‘>= 1.0‘ pod ‘RealmSwift‘
在本項目中,我們要用到兩個外部庫:Realm 和一個用於 Foursquare REST API 的 Swift 庫 Das Quadrat。
然後,關閉項目,關閉 Xcode。打開 OS X 的終端窗口,將目錄切換到你的項目目錄。如果你不知道怎麼做,請遵循如下步驟:
- 打開終端程式
- 輸入 cd (c、d、空格)
- 打開 Finder
- 在 Finder 中找到你的項目目錄,但不要進到目錄裡面
- 從 Finder 窗口中將項目目錄拖拽到終端窗口
- 項目的絕對路徑將自動填寫到 cd 命令之後
- 敲回車
- 這樣你就將當前工作目錄切換到項目目錄下了
然後在終端窗口中輸入:
pod install
命令的執行大約要個幾分鐘時間,同時屏幕上將有大量信息滾動顯示。Cocoapods 將為你的項目安裝所需的庫。同時將你的項目轉換為工作空間(由多個項目組成)。
然後,在 Finder 中找到新生成的 .xcworkspace 文件并打開它。這個文件就位於你的項目的根目錄下。
注意:當你在 Xcode 中打開這個工作空間時,你的項目很可能是處於折叠狀態。你可以將項目文件恢復到原來的打開狀態 ── 關閉工作空間,然後再打開工作空間。這會導致項目文件不再是折叠狀態。
這就是你需要為本 App 的 Xcode 項目所進行的所有設置。如果一切順利,你應該擁有了一個包含了兩個項目的工作空間。其中 Pods 項目包含了 Realm 和 Das Quadrat 庫的代碼。
用故事板創建 UI
Coffee 的 UI 非常簡單。它只有兩個 UI 元素:一個地圖視圖和一個表格視圖。
Xcode 已經為我們做了大量的工作。Single View Application 模板包含了一個故事板文件 Main.storyboard,它是 App 的入口。
要創建地圖視圖,需要:
- 打開 Main.storyboard
- 在 Xcode 右下角的 Object Library 窗口中,找到 Map Kit View (MKMapKitView)
- 將它拖到故事板編輯器中,并放到 View Controller 的左上角。讓它的高度大致等於 View Controller 的一半,寬度則完全佔滿。
- 在 Object Library 窗口中找到 Table View (UITableView) 并將它拖到故事板編輯器的 View Controller 上。讓它的寬度完全佔滿,高度則佔據 View Controller 的下半部。
接著為這兩個 View 設置自動佈局約束。首先,選中地圖視圖,點擊故事板編輯器右下角的 Pin 按鈕,這個按鈕位於右邊第二個位置,形如星戰中鈦式戰機 …
然後會彈出一個小窗口,接下來你需要做:
- 反選“Constrain to margins”。
- 點擊左、上、右三個 I 形線,讓它們依次變成紅色。
- 每個 I 形線旁邊都有一個輸入框,將它們分別設置為 0。
- 點擊“Add 3 constraints”
接下來,在表格視圖上重複同樣的動作。但是將上面的 I 形線替換成下面的 I 形線(同時還有左和右)。同樣地,反選“Constrain to margins”選項,然後點擊“Add 3 constraints”按鈕。
我們讓兩個 View 分別相對於上對齊和下對齊,寬度都是父 View 的百分之百。還有一件事情,就是讓兩個 View 的垂直高度都等於整個屏幕高度的 50%。
我們可以用多個約束來實現這點,但這是最簡單的:
- 選中地圖視圖和表格視圖(按住 Command 鍵,然後分別點擊這兩個 View)。
- 點擊 Pin 按鈕。
- 勾選 Equal Heights 選項。
- 點擊“Add 1 constraint”。
現在 Xcode 可能會報錯說“有佈局衝突”。別擔心,我們會來修復它。
- 點擊地圖視圖,然後點擊 Pin 按鈕。
- 反選 “Constrain to margins” 選項,然後點擊下面的 I 形線,將它的值修改為 0。
- 點擊“Add 1 constraint”。
現在紅線消失了,IB 又開始顯示黃線。這表示有部份約束當前顯示不正確。所有的約束都是對的,僅僅是 IB 在顯示上不正確。
要解決這個問題,點擊黃色的帶圈的箭頭,這個圖標位於故事板編輯器 Document Outline 窗口的右上角。
點擊這個圖標后,會顯示一個新的界面。點擊黃色的三角,然後點 Update frames,再點擊 Fix misplacement。在每個黃色的三角上重複同樣步驟。當然,Update frames 的辦法并不是每次都有效,因此確保你的約束都創建正確,再讓你的 frame 也正確。
不幸的是,佈局約束經常會出現大量錯誤。如果你搞錯了某些事情,你可以從 Document Outline 窗口中將約束刪除,然後重建。
編譯 App 并修復錯誤
讓我們來運行一下 App。在開發的時候,我們經常需要運行 App,以檢驗我們的改動是否正確。
當你已經非常熟練的時候,你可以修改很多內容而不用檢查這些修改是否正確。通過本能來判斷自己有沒有做錯。但如果你還是一個新手,則儘量不要步子邁得太大。一次只解決一個問題,然後就檢查 App 是否能正常工作。如果出錯,你就會知道剛才修改的地方出錯了。這個道理很簡單。
要運行 App,這樣做:按下 Command + B 或者 Command + R。一個是編譯,一個是編譯并運行。在 Xcode 的左上角,你可以選擇在什麼樣的 iPhone 上運行 App。如果你將 iPhone 或者 iPad 連上 Mac,同時這些設備已經可以用於開發,則你也可以在這個地方選擇它們。
看一下 App 能運行嗎?
答案是不能運行!讓我們來找出問題并解決它。找到 Debug 窗口,它位於 Xcode 窗口的底部。在 Debug 窗口的右邊你會看到有一個錯誤。
如果你不能看到上圖的畫面,點擊右上角的按鈕和右下角的按鈕讓它顯示。
這個錯誤是:
2015-11-04 14:37:56.353 Coffee[85299:6341066] *** Terminating app due to uncaught exception ‘NSInvalidUnarchiveOperationException‘, reason: ‘Could not instantiate class named MKMapView‘ *** First throw call stack: ( 0 CoreFoundation 0x0000000109fdff65 exceptionPreprocess + 165
編程中錯誤信息經常不是很直觀,甚至有時候根本就算不上是錯誤信息。大部份運行時錯誤都會由一個異常,一條消息和一個調用堆棧構成。
這三個部份都有利於你找出錯誤的原因。例如,你可以用這個異常去定位拋出該錯誤的代碼片段。而調用堆棧會列出在錯誤出現時的類以及方法的調用列表。也就是所謂的“回溯”,以倒序列出錯誤發生之前執行過的代碼。
現在,先看一下錯誤信息,因為這是最容易利用的部份。它說的是:
不能實例化 MKMapView 類
MKMapView 這個詞我們是知道的。我們曾經在 IB 中使用了它。它是一個地圖視圖,位於 UI 的上半部份。初始化這個詞有點程序員的意思,它是說編譯器(Xcode 的一部份,用於將代碼轉換成 App 的二進制)無法創建 MKMapView 的副本。總之就是說:我無法創建地圖視圖。
不幸的是,99% 的錯誤信息不會告訴你怎麼解決問題。它只會告訴你發生了什麼,但問題的原因卻無法看到。
現在怎麼辦?你需要干兩件事情:
- 回家洗洗睡吧,再也不做 App 了
- 複製、粘貼錯誤信息,然後用 Google 進行搜索 (建議你這樣做)
好吧,拷貝這段錯誤信息,然後在 Google 上搜索。這下你可能會搜索出這樣的結果:
點擊最上面的超鏈接。它會帶你到 StackOverflow,這是一個關於編程的 Q&A 網站。上面會有這個星球上幾乎所有語言的問題,以及這些問題的答案。
這就是你要做的,在 StackOverflow 上瀏覽答案:
- 查看這個問題是否有一個以上的回答。如果一個都沒有,繼續檢查另一個問題(通過 Google)。如果你找到了一個答案,能夠回答還先前沒有答案的問題時,你可以將這個答案順便添加到進去。
- 掃一眼最上面的原始的問題。看看標題,瀏覽一下內容以及下面的評論。這些評論經常會包含一些額外的信息。
- 挑出已經認可的答案,這些答案會用綠色的勾子進行標記。它的評論還是要看的,有時候評論比答案還有用。很多時候,已經認可的答案並不是最好的答案。檢查左邊的上下箭頭之間的數字,這個數字表示投贊成票的數字(即投“這是一個好答案”票)。已認可的答案不一定是最有用的,因此繼續深挖網頁上的其它內容。
- 對於這些答案,建議不要盲從,理解它的原理。學習編碼是一件很費時間的事情,但它對你的未來會有無窮的好處。幾乎每個程序員都會有知識上的盲區或者技術上的缺陷。如果你學會如何避免在未來犯錯誤,以及為什麼犯錯誤,你就會和全世界最頂尖的 1% 的程序員站在一起。
好了,到底是什麼原因出現的問題?答案是 MapKit 框架沒有添加到項目中。顯然,MKMapView 的代碼是放在某個外部框架中了。這些代碼必須被加到項目中來,雖然我們沒有直接在代碼中使用過地圖視圖。
如果你看完了網頁,你會發現还有大量的反面例子,也會引發這個錯誤。
好了,該我們來解決這個問題了:
- 回到 Xcode,在项目导航窗口中点击項目屬性。項目屬性位於項目導航窗口的頂部。
- 點擊 Build Phases 標籤欄.
- 然後,點擊 Link Binary With Libraries 左邊的箭頭。這會顯示一個列表。
- 點擊列表底部的 + 號按鈕,會彈出一個窗口。
- 在文本框中輸入: mapkit,對列表進行篩選。
- 最後,雙擊 MapKit.framework。
這會將這個框架添加到 Link Binary With Libraries 列表和項目中。
使用用戶的地理座標
你接下來的任務是 Geolocation,即將用戶的位置顯示到地圖上。
首先,需要將故事板中的地圖視圖連接到代碼中。在我們新建項目時,會創建一個文件 ViewController.swift,這就是故事板中的 View Controller 放置代碼的地方。
接下來檢查一下故事板和代碼之間的這種連接是否存在:
- 打開 ViewController.swift 并查找這行代碼:class …,也就是類的定義。這行代碼指定了類的名字,它的父類以及它所實現的協議。在這裡,類名顯示為 ViewController。
- 然後打開 Main.storyboard 并點擊 Document Outline 窗口最上面的項目。這個項目就是“View Controller Scene”。
- 在右上角,點擊 Identity 檢查器。即從左到右第三個圖標。
- 最後,找到 Class 欄,查看它的內容
這表明故事板和 ViewController 的代碼是有聯繫的,幸虧我們有 class 關鍵字可用。如果你向故事板中加入另一個 View Controller,你可以為它指定另一個類名。
為地圖視圖創建一個出口
現在我們知道 ViewController 和代碼其實是連接在一起,我們需要創建一個出口連接到地圖視圖。在你用自己的代碼引用這個地圖視圖之前,需要為地圖視圖的創建一個連接。
打開 ViewController.swift 在第一行的 { 括號之後加入以下代碼:
@IBOutlet var mapView:MKMapView?
這是什麼意思?
- 在 Swift 中,變量在使用之前需要事先聲明。在聲明變量的同時,你可以初始化它。上面的這句代碼,變量并沒有初始化,因此它的值為空(nil)。
- 剛剛這行代碼也創建了一個實例屬性。這個屬性是和 ViewController 的每個實例綁定的,並且對每個實例來說,這個屬性都是單獨的。
- 這個屬性的名字叫做 mapView,類型是 MKMapView。這個類來自於 MapKit 庫。
- 關鍵字 @IBOutlet 用於告訴 Xcode,我們想把這個屬性當成一個出口。出口的概念其實是一個連接,用於表示代碼和故事板(或者 xib)中的UI對象之間的連接。
- var 關鍵字表明這是一個變量,它的值可以被修改。與之相反的是 let 關鍵字,表示一個常量,值無法改變。
- 類型名后面的符號 ? 表示這個變量是可空的。可空是 Swift 中特有的概念。它表示變量除了存放非空的值,也可以存儲空值。nil 表示空,什麼都沒有。可空在 Swift 中出現,目的是為了讓代碼更安全和更易於使用。 關於可空,更多內容見後。
- 為什麼要將代碼寫在這一行?這行代碼寫在了類的頂部。即類聲明的內部,這表明變量在整個類中都是可用的。如果放在方法的內部,則表示變量是一個局部變量,只能在聲明變量的方法內使用這個變量。如果放在類的外部聲明,則表明變量是全局的,在(幾乎)任何地方都能使用這個變量。
是否分不清變量和屬性的概念?一個變量是一個簡單的容器,用於存放數據。屬性也是一種變量,但它附屬於某個類。有兩種屬性:實例屬性和類屬性。
是否分不清類、實例和類型?可以把類看成是一個“死的”(就像是壓鑄出來的)模板,用於創建一堆複製品。這些複製品就是實例。而類型的概念有點模糊,但你可以簡單地把它看成和類的概念差不多。
是否分不清聲明、初始化和實例化?好吧,首先來說聲明:聲明僅僅是告訴編譯器,我要使用某個變量,它的名字是什麼,它的類型是什麼。初始化的意思則是我要給這個變量一個初始值。也就是在聲明一個變量的同時,將一個值賦給這個變量。如果你不初始化變量,則變量的值就是 nil。實例化的意思則是你將一個實例(類的一個複製品)賦給這個變量。專業點講,一個變量就是一個實例化對象的引用。
回到項目。在添加上面的代碼后,Xcode 會拋出另一個錯誤。這個錯誤說的是:
MKMapView 類型未聲明
這是因為你還沒有將 MapKit 引入到當前文件!因此,在類定義之上添加一個 import 語句。在 import UIKit 之後加入:
import MapKit
現在,我們再來創建 outlet 連接。
- 首先, 打開 Main.storyboard。
- 然後, 在 Document Outline 窗口中選中 View Controller Scene 。
- 打開 Connections 檢查器。
- 檢查在列表中是否包含了 mapView 屬性。
- 最後,將 mapView 右邊的小圓圈拖到故事板編輯器中的地圖視圖上。
編寫第一個方法
好了,讓我們來編寫使用地圖視圖代碼。首先,在 ViewController 類中加入:
override func viewWillAppear(animated: Bool) { super.viewWillAppear(animated) if let mapView = self.mapView { mapView.delegate = self } }
寫在什麼地方?任何地方!只要在類聲明的一對大括號 {} 之內。
所有方法都必須寫在類的範圍內。一個類的範圍從第一個左大括號 { 開始,到最後一個右大括號 } 結束。
這必須是平衡的,即每個左大括號 { 都必須配有一個對應的右大括號 }。而且,程序員需要使用縮進來表示範圍的級別。通常,每當一個左括號 { 之後就要使用一個 Tab 符或者四個空格表示一個縮進(在右括號之後則進行反縮進)。
我們來看看這個方法:
- 一個方法是一個代碼塊,它被類所擁有。它通常由多個單獨的代碼行構成,每個代碼行負責完成一個指定的動作。方法既可以在類的內部被調用,也可以在 App 的任何代碼中調用。
- 方法的名字叫做 viewWillAppear,它帶有一個參數。一個參數是一個變量,用於在調用方法時傳遞數據給這個方法。參數能夠在方法的範圍內即這個方法的任何地方使用。在上面的方法中,這個參數 animated 是一個 Bool 類型(布爾類型,yes 或 no),它會在調用父類的 viewWillAppear 方法時用到。
- 所有的方法用關鍵字 func 開頭,func 是 “function” 的縮寫。在這裡,方法應當被覆蓋,因此使用了 overriden 關鍵字修飾。overriden 表示用自己寫的方法替換父類的同名方法。父類和覆蓋的概念屬於面向對象編程中的範疇。這裡我們不展開討論,因為這實在是太枯燥乏味了。
- 在接下來的代碼中,我們首先將 self.mapView “可空綁定”到一個常量 mapView。“可空綁定”可以讓你檢查某個可空對象是否為 nil,如果不是,if 語句才會被執行。同時,mapView 變量只會在 if 語句的範圍內有效。
- 在 if 語句中,mapView 的 delegate 屬性被設置為 self。也就是說,如果 self.mapView 不為空,mapView 的 delegate 就會被設置為 self。簡而言之,如果 mapView 不為空,這個類將充當 mapView 的委託。關於委託,後面再論。
現在 Xcode 又向我們拋出了一個錯誤。這次它說的是“無法將 self 賦給 delegate 屬性,因為 ViewController 並不是一個 MKMapViewDelegate 類型”。我們來解決這個問題。
修改類的聲明如下:
class ViewController: UIViewController, MKMapViewDelegate
獲取用戶位置
現在地圖視圖已經創建,我們可以來獲取用戶的位置了。
為 ViewController 類加入下列屬性:
var locationManager:CLLocationManager? let distanceSpan:Double = 500
第一個變量是 locationManager,它是一個 CLLocationManager 類型。它是可空的,因此它可以保存 nil。第二個屬性是一個 Double 類型的常量,它的值是 500。Double 類型是一種雙精度浮點數(即長度是 Float 的兩倍)。
在類中加入下列方法。可以在 viewWillAppear 方法后添加這個方法:
override func viewDidAppear(animated: Bool) { if locationManager == nil { locationManager = CLLocationManager() locationManager!.delegate = self locationManager!.desiredAccuracy = kCLLocationAccuracyBestForNavigation locationManager!.requestAlwaysAuthorization() locationManager!.distanceFilter = 50 // Don‘t send location updates with a distance smaller than 50 meters between them locationManager!.startUpdatingLocation() } }
呃,這些代碼是什麼意思?
- 首先,我們用 if 語句判斷 locationManager 是否為空。
- 然後實例化一個 CLLocationManager 對象并賦給 locationManager。換句話說:locationManager 現在保存了一個新的 CLLocationManager 對象的引用。我們只是創建了一個 CLLocationManager 對象,這個對象可以用於獲取用戶的位置。
- 然後,我們設置了 locationManager 的幾個屬性。delegate 屬性設為當前類,然後設置了 GPS 精度并調用 requestAlwaysAuthorization() 方法。這個方法會顯示一個窗口,用於向用戶獲得訪問 GPS 位置信息的權限。
- 最後,調用 startUpdatingLocation 方法。這會導致 locationManager 去獲取 GPS 位置,并調用委託對象的方法來通知 GPS 位置所發生的變化。這樣,在委託方法中,我們就可以拿到用戶的位置數據了!
- 可空綁定. 也就是 if let definitiveValue = optionalValue { ….這樣的形式
- 強制解包. 也就是 optionalValue! 這樣的形式
class ViewController: UIViewController, MKMapViewDelegate, CLLocationManagerDelegate現在,在 ViewController 中增加如下方法。這個方法是一個委託方法,你可以將它放在前面的方法之後。
func locationManager(manager: CLLocationManager, didUpdateToLocation newLocation: CLLocation, fromLocation oldLocation: CLLocation) { if let mapView = self.mapView { let region = MKCoordinateRegionMakeWithDistance(newLocation.coordinate, distanceSpan, distanceSpan) mapView.setRegion(region, animated: true) } }這些代碼是什麼意思?
- 首先,這個方法的簽名是 locationManager:didUpdateToLocation:fromLocation。這個方法使用了命名參數,也就是說參數的名字(在方法內部的變量)與調用時的參數名字不同。長話短說,這個方法有三個參數:調用這個方法的 location manager 對象,新的 GPS 座標,以及老的 GPS 座標。
- 在這個方法中,首先將 self.mapView 用可空綁定進行解包。如果 self.mapView 不為空,則將解包后的值賦給 mapView,然後執行 if 語句。
- 在 if 語句中,根據新的 GPS 座標和前面指定的跨度劃定一個範圍。 具體的說,我們創建了一個以新座標為中心的 500*500 大小的矩形範圍。
- 最終,調用 mapView 的 setRegion 方法。animated 參數設置為 true,讓區域的改變呈現為動畫式的。也就是說,地圖會進行平移和縮放,并顯示用戶位置周邊 500*500 方塊內的地圖。
- 在項目導航窗口中,打開 Info.plist 文件。
- 在列表窗口中點擊右鍵,然後選擇 Add Row。
- key 輸入 NSLocationAlwaysUsageDescription。
- type 選擇 String。
- value 則輸入你在獲取權限時要顯示的文本!
運行 App
現在我們來運行一下 App。確認你的 target 中選擇了一個 iPhone 模擬器,然後按下 Command + R。App 將啟動,并彈出一個需要授權的窗口,點擊“允許”。
當你點擊“允許”后,地圖視圖並不會刷新。因為模擬器沒有 GPS,我們需要模擬一個。
當 App 在模擬器中運行時,請使用以下倆個方式之一來模擬 GPS 位置數據:
- 在 iPhone Simulator 窗口,點擊菜單: Debug -> Location -> Apple。
- 在 Xcode 窗口,點擊菜單: Debug -> Simulate Location,然後從列表中選擇一個位置。
當你選擇了一個位置后,地圖視圖將刷新并將指定的位置放大顯示。
看到了嗎?干得漂亮!
從 Foursquare 獲取地標數據
接下來 App 會變得更有趣!你將使用 Das Quadrat 庫從 Foursquare 獲取數據,然後用 Realm 將數據保存到本地。
在使用 Foursquare API 之前,你需要在它的開發者網站上註冊 App。這個步驟其實很簡單。
- 首先,你需要有一個 Foursquare賬號,你可以在 foursquare.com 註冊一個。
- 接著,跳到 developer.foursquare.com ,點擊上方的藍色菜單條中的 My Apps。
- 然後,點擊右邊綠色的 Create a new app 按鈕。
- 然後,填寫如下內容:
- App Name: Coffee
- Download / Welcome page URL: http://example.com
- 最後,點擊 Save Changes。
保存完成后,網頁將跳轉到 App 頁面。注意 Client ID 和 Client Secret,我們將在後面用到它們。
創建 Foursquare API Connector
現在,我們要編寫連接 Foursquare 的代碼了。你將用單例模式來實現。單例模式適合于我們現在的場景。
一個單例是一個類實例,它是類僅有的實例。使用單例時,我們不能為一個類創建兩個實例。為什麼我們要用單例模式?對於單例的使用,一直有很大的爭議,但它對於這種情況是非常適用的:避免對一個外部資源出現多個併發的連接。
你可以想一下。如果你向一個 web 服務器發送兩個請求,同時這倆個請求都是向一個文件進行寫操作?數據將變得混亂不堪,除非 web 服務器讓其中一個請求比另一個請求優先執行。
一個單例保證只從 App 的一個地方請求外部資源。在單例模式下,大量的實現是為了保證不出現資源衝突。請求隊列和序列就是其中的一種實現,但這卻不在本教程的討論範圍。
你需要這樣做:
- 在項目導航窗口中右鍵點擊 Coffee 文件夾。
- 選擇 New File …。
- 選擇 iOS -> Source 下面的 Swift File 模板,點擊 Next。
- 將文件命名為 CoffeeAPI.swift,選中 Target 列表中的 Coffee,點擊 Create,保存文件。
哇,創建了一個空文件!讓我們來編輯它。在文件開頭的第一個 import 語句后,加入:
import QuadratTouch import MapKit import RealmSwift
然後加入代碼:
struct API { struct notifications { static let venuesUpdated = "venues updated" } }
這段代碼很簡單,不是嗎?首先我們導入了所需的庫(Quadrat, MapKit, Realm),然後定義了一個“結構的結構”,叫做 venuesUpdated,它裡面有一個靜態常量。然後,我們就可以像這樣調用這個結構:
API.notifications.venuesUpdated
然後,繼續編寫代碼:
class CoffeeAPI { static let sharedInstance = CoffeeAPI() var session:Session? }
這段代碼負責完成這些事情:
- 告訴 Xcode 編譯器,我們定義了一個類 CoffeeAPI,它是一個純粹的 Swift 類,因此不需要子類化 NSObject。
- 聲明一個靜態的類常量,叫做 sharedInstance,類型指定為 CoffeeAPI。這個“共享的實例”只能通過 CoffeeAPI 類來訪問,當 App 一啟動這個實例就會被實例化(預先加載)。
- 聲明一個類屬性 session, 類型為 Session? (來自 Das Quadrat 庫).
然後,我們將通過 CoffeeAPI.sharedInstance 的方式來訪問 Coffee API。無論在任何地方,你都可以這樣調用,你都會引用到同一個對象,這就是單例的特點。
然後是構造函數。在上述屬性聲明后,在類的大括號之內輸入:
init() { // 初始化 Foursquare client let client = Client(clientID: "...", clientSecret: "...", redirectURL: "") let configuration = Configuration(client:client) Session.setupSharedSessionWithConfiguration(configuration) self.session = Session.sharedSession() }
構造函數是一個方法,當類實例被實例化之後這個方法就會被調用。這是在一個實例被創建之後會自動調用的第一個方法。
還記得你在 Foursquare 開發者網站上拷貝的 Client ID 和 Client Secret嗎?將它們粘貼到構造函數的 … 中,然後將 redirectURL 參數設為空白。變成這樣:
let client = Client(clientID: "X4I3CFADAN4MEB2TEVYUZSQ4SHSTXSZL34VNP4CJHSJGLKPV", clientSecret: "EDOLJK3AGCOQDRKVT2GK5E4GECU42UJUCGGWLTUFNEF1ZXHB", redirectURL: "")
好了,還要做一件事情。將下列代碼拷貝到 CoffeeAPI.swift,記得粘貼在 CoffeeAPI 類之外。也就是說放在文件最後的一個大括號 } 之後。
extension CLLocation { func parameters() -> Parameters { let ll = "\(self.coordinate.latitude),\(self.coordinate.longitude)" let llAcc = "\(self.horizontalAccuracy)" let alt = "\(self.altitude)" let altAcc = "\(self.verticalAccuracy)" let parameters = [ Parameter.ll:ll, Parameter.llAcc:llAcc, Parameter.alt:alt, Parameter.altAcc:altAcc ] return parameters } }
這段代碼是什麽意思?這是一個擴展,擴展會為某個基類增加一些額外的功能。它不用創建新的類,你可以擴展基類 CLLocation,讓它增加一個新的方法 parameters()。每當代碼中用到 CLLocation 對象的時候,就會加載你的擴展,你都可以調用這個對象的 parameters 方法。哪怕這個方法在原來的類中根本不存在。
注意:不要將 Swift 中的擴展和編程術語“擴展”(即繼承)相混淆。前者是用新的功能增強某個基類,而後者則表示在父類基礎上創建一個子類。
parameters 方法返回一個 Parameters 對象,Parameters 可以簡單地看成是一種鍵值類型的字典,它用於包含參數化的信息(GPS 座標和精度)。
向 Foursquare 發送請求并進行處理
好,讓我們來從 Foursquare 獲取數據吧。Foursquare 有一個 HTTP REST 風格的 API,返回的數據是 JSON 格式。幸好我們不用和它們打交道,它們都已經封裝到了 Das Quadrat 庫中。
向 Foursquare 請求數據只需要用到 session (就是我們剛剛創建的那個)的一個屬性,并調用該屬性的一個方法。這個方法返回一個 Task 對象,這個對象引用了一個異步的後臺任務。我們可以為該方法提供一個完成閉包;這樣當任務完成時就可以執行閉包中的代碼:
let searchTask = session.venues.search(parameters) { (result) -> Void in // 對 "result" 進行處理 }
session 的 venues 屬性包含了所有從 Foursquare API 返回的與“地標”有關的信息。你需要向 search 方法傳遞一個 parameters 參數,第二個參數則是一個閉包,這個閉包在任務完成時會被調用。這個方法會返回一個引用,這個引用是一個耗時的後臺任務。通過這個引用,你可以在任務完成之前停止該任務,或者在其它地方用它來了解任務進度。
接下來是下面的這段代碼。將它複製粘貼到你的代碼中,放到 init 構造方法下面,類的右大括號 } 前面。然後我們再細細講解這些代碼有些什麽作用。
func getCoffeeShopsWithLocation(location:CLLocation) { if let session = self.session { var parameters = location.parameters() parameters += [Parameter.categoryId: "4bf58dd8d48988d1e0931735"] parameters += [Parameter.radius: "2000"] parameters += [Parameter.limit: "50"] // 開始搜索,即異步調用 Foursquare,并返回地標數據 let searchTask = session.venues.search(parameters) { (result) -> Void in if let response = result.response { if let venues = response["venues"] as? [[String: AnyObject]] { autoreleasepool { let realm = try! Realm() realm.beginWrite() for venue:[String: AnyObject] in venues { let venueObject:Venue = Venue() if let id = venue["id"] as? String { venueObject.id = id } if let name = venue["name"] as? String { venueObject.name = name } if let location = venue["location"] as? [String: AnyObject] { if let longitude = location["lng"] as? Float { venueObject.longitude = longitude } if let latitude = location["lat"] as? Float { venueObject.latitude = latitude } if let formattedAddress = location["formattedAddress"] as? [String] { venueObject.address = formattedAddress.joinWithSeparator(" ") } } realm.add(venueObject, update: true) } do { try realm.commitWrite() print("Committing write...") } catch (let e) { print("Y U NO REALM ? \(e)") } } NSNotificationCenter.defaultCenter().postNotificationName(API.notifications.venuesUpdated, object: nil, userInfo: nil) } } } searchTask.start() } }
這段代碼好多!在這個方法中主要完成了五個任務:
- 首先,向 API 配置和發起了一個請求。
- 請求完成塊 (即閉包)。
- 解析請求返回的數據,并開始 Realm 事務。
- 用 for 循環遍歷所有“地標”數據。
- 在完成塊的最後,發送一個通知。
讓我們來逐行分析上述代碼:
構建請求
首先,用一個可空綁定判斷 self.session 是否為空。如果不為空,將 self.session 解包到 session 中。
然後,調用 location 的 parameters 方法。這個 location 是哪來的?在 getCoffeeShopsWithLocation 方法中有一個參數 location。每當調用這個方法時,都需要向 location 參數傳遞一個位置參數。另外,parameters 方法則來自於我們前面創建的擴展。
然後,向 parameters 字典中加入一個新對象,鍵名設為 Parameter.CategoryId,值設為字符串 “4bf58dd8d48988d1e0931735”。這個字符串是 Foursquare 中的類別 ID,表示“Coffeeshops”的意思。
設置請求
然後來創建請求。調用 session.venues.search() 方法。這個方法需要兩個參數(并不是一個參數):我們創建的 parameters 對象,以及尾隨其後的閉包。這種寫法是典型的尾隨閉包的寫法。如果閉包是方法的最後一個參數,則可以不把它寫在調用方法的圓括號內,而放到圓括號()之後并用一對大括號{}包裹住塊。search 方法返回一個引用,指向耗時的搜索線程。搜索線程創建后並不會自動開始,我們需要在後面啟動它(就在方法的最後一句)。
編寫完成閉包
然後,我們進入到閉包內部。需要強調一點,儘管這些代碼是順序書寫的,但它們並不會順序執行。閉包只會在搜索任務完成之後執行。App 的執行順序將從 let searchTask … 一句跳到 searchTask.start() 一句,當 HTTP API 向 App 返回數據時,又會跳到 if let response = … 一句開始執行。
這個閉包的簽名(又叫做閉包表達式語法)是:(result)->Void in。意思是這個閉包有一個參數 result,閉包返回值為空(Void)。這和我們常見的方法是一樣的。
解析返回結果
然後是兩個可空綁定 if let:
- 檢查 result.response 是否為空的,如果它不為空,將它解包并付給 response 常量(同時執行 if 語句)。
- 檢查 response[“venues”] 是否為空,同時它是否能夠轉換為 [[String: AnyObject]] 類型。
這種方式能夠確保數據類型是我們期望的。如果转换失败,或者可空绑定失败,if 语句就不會被執行。這就像是一塊石頭上站了兩隻鳥:判斷值不為空,同時嘗試將值轉換為預期的類型。
你現在知道 venues 是什麼類型麼?它是一個字典的數組,字典的類型則是 String:AnyObject 鍵值對。
自動釋放內存
然後,是一件很有趣的事情:我們創建了一個自動釋放池。當然,這是一個很大題目。你了解 iPhone 的內存管理機制嗎?
基本上,當內存中的對象不再被任何對象引用時,它會被刪除。類似垃圾回收機制,但又不完全相同。當自動釋放池中的對象被釋放時,它被交給自動釋放池處理。當自動釋放池被釋放時,池里的所有內存才被釋放。它就像是批量的內存釋放。
為什麼要這樣做?自己創建自動釋放池,有助於提高 iPhone 系統的內存管理效率。因為我們需要在自動釋放池中處理數百個 venue 對象,如果不清理內存的話,這會導致內存緊張。對於一般的自動釋放池來說,釋放內存的最早時機是方法結束的時候。因此,這就有可能導致內存耗盡,因為自動回收機制無法及時、迅速地回收內存。通過創建自己的自動釋放池,我們可以干預內存的回收,避免內存空間不足。
使用 Realm
然後是“let realm = try! Realm()”一句,這實例化了一個 Realm 對象。在使用 Realm 的數據之前我們需要一個 Realm 對象。 try! 關鍵字是 Swift 的異常處理機制。通過它,我們表明:我們不處理來自於 Realm 的錯誤。在真實項目中,我們不建議這麼做,但在這裡我們這樣做是為了讓代碼更簡潔。
開始事務
接下來,調用 realm 對象的 beginWrite 方法。這句代碼開始了一個事務。我們簡單討論一下什麼是效率。看一下下面的例子,你覺得哪個方法更有效率?
- 創建一個文件指針,打開文件,寫 1 個字節到文件,關閉文件,然後重複這個動作 50 遍。
- 創建一個文件指針,打開文件,寫 50 個字節到文件,關閉文件。
答案是第二個方法。Realm 將數據(就像其他數據庫系統一樣)保存到普通的文本文件。要使用文本文件就意味著 OS 需要打開這個文件,為 App 分配讀寫權限,然後將數據一字節一字節地從 App 寫到文件中。
與一次寫入一個 Realm 對象相反,我們打開文件后一次性寫入了 50 個對象。因為這些對象的數據都是類似的,它們可以一個接一個地成功寫入,這種方法──打開一次文件,寫 50 次,然後關閉文件 ── 是比較快的方法。這就是事務的概念。
最後一點:如果在事務中有一次寫入失敗,則所有的寫入都會失敗。這就類似于銀行和賬戶:如果你在賬本中記入了 50 筆交易,其中一筆出錯了(賬戶餘額不足),你想取消那筆交易。最終你不得不銷燬整個賬本!事務確保“要麼全部成功,要麼全部失敗”,以此來降低了數據損壞的可能。
遍歷地標數據
現在來看看 for-in 循環。在上面的可空綁定語句中,你已經確保 venues 是有效的。用一個 for-in 循環遍歷 venues 數組,在循環中將數組中的元素依次取出放到 venue 變量。
首先是創建一個 Venue 對象 venueObject。這句語句將拋出一個錯誤,因為到目前為止我們還沒有一個叫做 Venue 的類。我們將這個任務留到稍後解決,現在先不管這個錯誤。
然後是幾個可空綁定語句。每個可空綁定都用於訪問 venue 變量的一個鍵值對,并將它們轉換為預期的類型。例如,如果 venue 中有一個鍵名為 id 的鍵值對,則將它的值轉換為 String,如果成功,將它賦給 venueObject 的 id 屬性。
location 的可空綁定看起來要麻煩一些,但其實不然。注意,lat、lng 和 formattedAddress 組成了 location (而不是 venue)。從數據結構來說,它們之間相差了一個層級。
接下來是 for-in 循環的最後一句:realm.add(venueObject,update:true)。這將 venueObject 對象加入到 Realm中,并寫到數據庫(在事務中)。update 參數表明當同一對象存在的情況下,Realm 會用新數據覆蓋舊對象。後面,我們會為每個 Venue 對象指定一個唯一的 ID,以便 Realm 能夠識別哪個對象是已經存在的。
錯誤處理
現在 Realm 將所有的寫入操作放到了事務中,并準備將它們寫到數據庫中去。這個過程中,會出現錯誤。幸運的是,Swift 已經增加了一個可擴展的錯誤處理機制。大致流程如下:
- 進行某個危險的操作。
- 如果錯誤發生,拋出錯誤。
- 由調用這個危險操作的調用者俘獲這個錯誤。
- 調用者處理錯誤。
在大部份語言中這被稱作 try-catch 機制,但 swift 的創造者們把它稱作 do-catch 機制(是的,他們還將 do-while 循環改成了 repeat-while 循環…)。在你的代碼中,它看起來是這樣:
do { try realm.commitWrite() print("Committing write...") } catch (let e) { print("Y U NO REALM ? \(e)") }
危險操作 realm.commitWrite() 方法放在了 do 後面的一對大括號 {} 中。同時在語句前增加了一個 try 關鍵字。往前滾動代碼,找到 try!(有一個感嘆號),這里感嘆號的使用會導致錯誤直接被忽略。
如果 do{} 語句塊中有錯誤拋出,catch 塊將被執行。catch 塊有一個參數,即 let e,這個 e 中就包含了具體的錯誤。在這個代碼塊中,我們引入了 e 并打印了錯誤信息。當 App 運行并有錯誤拋出時,打印出來的信息會讓我們知道是什麼導致了錯誤。
你在上面的代碼塊中看到的錯誤處理是非常簡單的。設想類似這樣的固定的錯誤處理系統,你不僅能抓取錯誤,還能使用它們。例如,你向一個文件中寫入數據時,如果磁盤已滿,你可以彈出一個窗口告訴用戶磁盤已滿。如果是老的 Swift 版本,錯誤的處理非常麻煩,稍微搞不好就會讓 App 崩潰。
Swift 的錯誤處理有一定的強制性。錯誤要麼必須被處理,要麼被忽略,總之不能無緣無故地讓它溜走。處理錯誤使你的代碼更健壯,將使用 do-catch 進行錯誤處理形成一種習慣,而不要使用 try! 來忽略錯誤。
好,進入這個方法的最後兩句代碼。首先是第一句:
NSNotificationCenter.defaultCenter().postNotificationName(API.notifications.venuesUpdated, object: nil, userInfo: nil)
這句代碼會發送一個通知,給所有 App 中監聽了該通知的對象。這是 de facto 的通知機制,如果 App 有多個地方需要接收這個通知,這種方法非常有效。設想你剛剛從 Foursquare 收到新的數據。你可能會刷新表格視圖,以顯示新數據,也可能會觸發其它代碼。這時,只消一個通知就可解決所有問題。
注意發送通知的那個線程,即上面代碼所在的線程。如果你在主線程之外即發送通知的那個線程中進行更新 UI 操作,則 App 會崩潰并拋出一個致命的錯誤。
注意到 API.notificatoins.venuesUPdated 這個字符串嗎?這是一個硬編碼的字符串,我們也可以用 “venuesUpdated”替代。但使用硬編碼的編譯時常量可以使你的代碼更安全。如果你代碼寫錯了,編譯器會警告你。如果你把字符串“venuesUpdated”寫錯了,則編譯無論如何都不會告訴你!
在閉包之後,是最後一句代碼:
searchTask.start()
注意這句代碼在 let searchTask … 之後執行,無論它前面的閉包執行與否。這句代碼什麼意思?我們已經創建了一個請求,設置了它所需的參數,這句代碼的作用就是啟動搜索任務。
Das Quadrat 庫向 Foursquare 發送了一條消息,并等待返回,然後調用你編寫的閉包對返回的數據進行處理。非常簡單,不是嗎?
暫時離開這段代碼,因為我們還有一個 Venue 類沒有編寫。
編寫 Venue 類
你知道 Realm 最厲害的是什麼嗎?整個代碼結構都非常精幹。要使用 Realm,你只需要一個類文件。你可以用這個類創建一堆的對象,將他們寫到 Realm 文件,然後嘣的一下,你的本地數據庫就實現了。
此外,Realm 還包含了大量有用的特性,諸如排序、篩選,以及使用 Swift 原生數據類型。它非常快,你不需要用 NSFetchedResultsController(Core Data 中的)加載成千上萬的對象到表格視圖。Realm 有它自己的基本的數據瀏覽器。
好了,來看看 Venue 類。你需要:
- 在項目導航窗口中,右鍵點擊 Coffee 文件夾。
- 選擇 New File … 然後從iOS -> Source 下選擇 Swift File,然後點擊 Next。
- 文件命名為 Venue.swift ,在 target 列表中選中 Coffee。
- 點擊 Create。
這會創建一個空的 Swift 文件。這個文件中將包含 Realm 對象的代碼,即 Venue 類的代碼。
導入正確的庫。在 import Foundation 一句下加入:
import RealmSwift import MapKit
繼續在下邊加入:
class Venue: Object { }
這是 Venue 類的簽名。冒號用於表示你將繼承 Object 類。 在面向對象編程中,你可以為類之間創建“父﹣子”關係,即繼承的概念。在上面的代碼中,你繼承了 Object 類,這個類在 Realm 庫中定義。
也就是說,你將父類的所有的屬性和方法複製到了子類中。注意,繼承和創建擴展不同,後者僅僅是用新的功能修飾已有的類(不用創建任何新的類)。
接著,將下列代碼拷貝到這個類。將它放到类的一对大括號之間。
dynamic var id:String = "" dynamic var name:String = "" dynamic var latitude:Float = 0 dynamic var longitude:Float = 0 dynamic var address:String = ""
這是什麼意思?很簡單:為這個類定義了五個屬性。你可以利用這些屬性,將數據賦給這個類的實例,就像我們使用 CoffeeAPI 代碼時所作的一樣。
dynamic 屬性確保 O-C 運行時能夠訪問這些屬性。這又是另外一個話題了,但我們可以想像成 Swift 代碼和 O-C 代碼分別運行在各自的“沙盒”中。在 Swift 2.0 以前,所有的 Swift 代碼都運行在 O-C 運行時中,但現在,Swift 擁有自己的運行時。將一個屬性標明為 dynamic 之後,O-C 運行時就可以訪問這個屬性了,這是必須的,因為 Realm 底層依賴於 O-C 運行時。
每個屬性都有一個類型:String 或者 Float。Realm 支持幾種 Swift 原生類型,比如 NSData,NSDate(精度為秒),Int,Float,String 等等。
然後,在 address 屬性下加入:
var coordinate:CLLocation { return CLLocation(latitude: Double(latitude), longitude: Double(longitude)); }
這是一個計算屬性。它不會保存到 Realm 中,因為計算屬性是不會被保存的。所謂的計算屬性,名副其實,是說這個屬性其實是来自于某個表達式計算的結果。它就像一個方法,但是以屬性的形式來調用。上面的這個計算屬性中,我們將緯度和精度轉換成一個 CLLocation 對象。
經過這樣的轉換后會方便許多,因為我們可以通過 venueObject.coordinate 來訪問正確類型的對象,而不需要再臨時創建一個。
然後在上面的代碼後面加入:
override static func primaryKey() -> String? { return "id"; }
這是個新方法,我們覆蓋了來自於父類 Object 的同名方法。通過這個方法你可以告訴 Realm 用什麼來做主鍵。主鍵的概念類似于唯一標識。在 Realm 數據庫中,每個對象都必須擁有一個唯一的主鍵,就像鎮子里的每棟房屋都必須有一個唯一的門牌號。
Realm 通過主鍵來區分不同的對象,並以此來判斷一個對象是否和另一個對象相同。
這個方法的返回值是 String,因此我們可以返回一個屬性名,并以該屬性來作為主鍵。如果不想使用主鍵,則可以返回一個 nil。
你可以將 Realm 對象的屬性(比如 id、name)想像成表格中的列。primaryKey 的返回值就是這些列中的某一列,這裡就是 id。
最後,按下 Command + B,編譯 App,查看是否一切正常。這裡我們不運行 App,因為我們還沒有修改 UI 代碼。我們編譯只是為了測試我們的代碼是否有錯誤。如果你檢查一下 CoffeeAPI.swift 中的代碼,你會發現 venueObject 旁邊的錯誤提示消失了。
在地圖中顯示地標數據
現在,讓我們用下載的數據做一些事情。我們將數據以大頭釘的形式顯示到地圖上。
首先,回到 ViewController.swift 文件。看一下將用戶位置顯示到地圖上的代碼。
然後,在文件頭部,加入 import 語句:
import RealmSwift
在類中聲明幾個屬性(在 distanceSpan 下面):
var lastLocation:CLLocation? var venues:Results?
要讓 RealmSwift 庫能夠使用 Realm,我們需要用這兩個屬性存放座標和地標數據。
接著,找到 locationManager:didUpdateToLocation:fromLocation 方法。然後找到這個方法的右大括號 }。在這下面加入下列代碼。
func refreshVenues(location: CLLocation?, getDataFromFoursquare:Bool = false) { if location != nil { lastLocation = location } if let location = lastLocation { if getDataFromFoursquare == true { CoffeeAPI.sharedInstance.getCoffeeShopsWithLocation(location) } let realm = try! Realm() venues = realm.objects(Venue) for venue in venues! { let annotation = CoffeeAnnotation(title: venue.name, subtitle: venue.address, coordinate: CLLocationCoordinate2D(latitude: Double(venue.latitude), longitude: Double(venue.longitude))) mapView?.addAnnotation(annotation) } } }
哇,這個方法有好多代碼!它們是什麼意思?
先來看檢查兩個座標的 if 語句。第一個 if 語句檢查 location 是否為空,第二個 if 語句檢查 lastLocation 屬性是否為空(用一個可空綁定)。
這兩行代碼非常類似,雖然它們干的是不同的事情。先讓我們暫停一下。思考一下下列描述是否正確:
- App 中的所有座標必須都來自于 locationManager:didUpdateToLocation:fromLocation 方法。只有這個方法才會向 App 傳入 CLLocation 對象,而這個對象的數據來自於 GPS 硬件。
- refreshVenues 方法使用一個 location 參數,這個參數是可空的。
- refreshVenues 方法可以在 location 為空的時候調用,也就是說,會在 locationManager:didUpdateToLocation:fromLocation 方法之外的代碼中調用。
最後一點非常重要。很顯然,因為我們想讓 refreshVenues 方法在 locationManager:didUpdateToLocation:fromLocation 方法之外也能被調用,因此我們要將座標數據保存到某個地方。
每當 refreshVenues 方法被調用,我們都在 location 參數不為空時將它保存到 lastLocation 參數。然後,我們用可空綁定檢查 lastLocation 參數是否為空。只有不為空 if 語句才會被執行,因此我們能夠保證 if 語句中的代碼 100% 的有一個有效的 GPS 座標可用。
這讓 refreshVenues 方法真正能夠讀取到真正的座標數據。這是毫無疑問的。如果你還不明白,請再次閱讀上一段內容。代碼非常簡單的,這樣的寫法也讓你的 App 在保證數據安全的同時保持解耦。
然後是 refreshVenues 方法的下一行。它又是什麼意思?它通過 CoffeeAPI 的共享實例從 Foursquare 請求數據。
if getDataFromFoursquare == true { CoffeeAPI.sharedInstance.getCoffeeShopsWithLocation(location) }
它只會在 getDataFromFoursquare 參數為 true 時進行請求。讓 CoffeeAPI 請求數據是件簡單的事情。記住,如果我們想在數據抓取完畢的時候獲得消息,我們需要監聽 CoffeeAPI 的通知。這個步驟我們稍後進行。
然後是下面的代碼:
let realm = try! Realm() venues = realm.objects(Venue)
這個代碼我們已經熟悉了,但這就是重要的地方。首先,獲取了一個 Realm 的引用。然後 Realm 讀取所有的 Venue 對象并保存到 venues 屬性。這個屬性的類型為 Result?,類似于一個 Venue 對象數組(會有輕微的不同)。
最後,是一個 for-in 循環,遍歷了 venues 中的所有 Venue 對象,然後以大頭釘形式添加到地圖上。這裡很可能會拋出一個錯誤,我們會解決它。
創建 Annotation 類
要創建一個 Annotation 類,你需要:
- 在 Coffee 文件夾上點擊右鍵,選擇 New File ….
- 在 iOS -> Source 下面選擇 Swift File,點擊 Next。
- 文件命名為 CoffeeAnnotation.swift 然後點擊 Create。
編輯文件內容為:
import MapKit class CoffeeAnnotation: NSObject, MKAnnotation { let title:String? let subtitle:String? let coordinate: CLLocationCoordinate2D init(title: String?, subtitle:String?, coordinate: CLLocationCoordinate2D) { self.title = title self.subtitle = subtitle self.coordinate = coordinate super.init() } }
代碼很簡單:
- 我們創建了一個名為 CoffeeAnnotation 的類,繼承自 NSObject 并實現了 MKAnnotation 協議。後者很主要:如果你需要讓一個類作為大頭釘顯示,你必須讓它遵循 MKAnnotation 協議。
- 然後,聲明了幾個屬性。這些屬性都是必須的,這是協議中規定的。
- 最後是一個構造函數,用方法參數對屬性進行了賦值。
回到 ViewController.swift,在看一下 CoffeeAnnotation 旁邊的錯誤提示是否消失了。
下一步,在 ViewController 類中添加如下方法。這個方法的代碼很常見,它確保你加到地圖的大頭釘能夠得到顯示。
func mapView(mapView: MKMapView, viewForAnnotation annotation: MKAnnotation) -> MKAnnotationView? { if annotation.isKindOfClass(MKUserLocation) { return nil } var view = mapView.dequeueReusableAnnotationViewWithIdentifier("annotationIdentifier") if view == nil { view = MKPinAnnotationView(annotation: annotation, reuseIdentifier: "annotationIdentifier") } view?.canShowCallout = true return view }
就像表格視圖一樣,地圖視圖會重用對象以使大頭釘能夠順暢地顯示到地圖上。在上面的代碼中,發生了這些事情:
- 首先,檢查大頭釘不是用戶的標誌。
- 從緩存中取出一個現成的大頭釘。
- 如果取出的是一個空對象,則創建一個新的對象。
- 設置大頭釘的是否顯示標註屬性(一個帶小框的信息)。
- 最後,返回 view,以便它能顯示。
注意這個方法是協議中定義的方法。前面我們已經將地圖視圖的 delegate 設置為 self。如果地圖視圖設置了 delegate 屬性,則當地圖準備顯示大頭釘的時候,它會調用 mapView:viewForAnnotation: 方法,這個方法就是上面的這段代碼。
委託是一種很好的自定義代碼的方法,它避免了重寫整個類。
處理地標數據通知
讓我們將所有珠子串起來。在 ViewController.swift 的 viewDidLoad 方法中,添加下列語句,就在 super… 的下方:
NSNotificationCenter.defaultCenter().addObserver(self, selector: Selector("onVenuesUpdated:"), name: API.notifications.venuesUpdated, object: nil)
這一句將告訴通知中心當前類(self)將監聽 API.notification.venuesUpdated 通知。當出現這個通知時,請調用 ViewController 的 onVenuesUpdated: 方法。簡單吧?
在 ViewController 類中新加一個方法:
func onVenuesUpdated(notification:NSNotification) { refreshVenues(nil) }
這又是幹什麼意思?
- 當從 Foursquare 收到位置數據后,調用 refreshVenues 方法。
- 調用時沒
以上是关于用 SwiftFoursquare API 和 Realm 創建一個咖啡屋 App的主要内容,如果未能解决你的问题,请参考以下文章
获取 r_liteprofile 和 r_emailaddress - api.linkedin.com/v2