Access Token

課程目標(biāo)

• 自定義對(duì)象
• 構(gòu)造函數(shù)
• 歸檔 & 接檔

接口定義

文檔地址

http://open.weibo.com/wiki/OAuth2/access_token

接口地址

https://api.weibo.com/oauth2/access_token

HTTP 請(qǐng)求方式

• POST

請(qǐng)求參數(shù)

返回?cái)?shù)據(jù)

用戶賬戶模型

加載AccessToken

• 在 HMOAuthViewController 中增加函數(shù)加載 AccessToken

/// 加載AccessToken的方法
///
/// - parameter code: 授權(quán)碼
private func loadAccessToken(code: String){
    let urlString = "https://api.weibo.com/oauth2/access_token"

    // 定義參數(shù)
    let params = [
        "client_id": WB_APPKEY,
        "client_secret": WB_APPSECRET,
        "grant_type": "authorization_code",
        "code": code,
        "redirect_uri": WB_REDIRECTURI]

    NetworkTools.shareTools.request(.POST, url: urlString, params: params) { (result, error) -> () in
        print(result)
    }
}

• 在獲取授權(quán)碼成功之后調(diào)用方法

// 判斷是否包含 'code=' 字樣
if let query = request.URL?.query where query.containsString("code=") {
    // 截取授權(quán)碼
    let code = query.substringFromIndex("code=".endIndex)
    print("請(qǐng)求碼：\(code)")
    // 請(qǐng)求AccessToken
    loadAccessToken(code)
}else{
    // 用戶點(diǎn)擊了取消授權(quán)，直接關(guān)閉頁(yè)面
    self.close()
}

運(yùn)行測(cè)試

• 返回錯(cuò)誤信息

Error Domain=com.alamofire.error.serialization.response Code=-1016 "Request failed: unacceptable content-type: text/plain"

• 在 HMNetworkTools 單例初始化時(shí)設(shè)置反序列化數(shù)據(jù)格式

static let shareTools: HMNetworkTools = {
    let tools = HMNetworkTools()
    tools.responseSerializer.acceptableContentTypes?.insert("text/plain")
    return tools
}()

定義 HMUserAcount 模型

• 在 Model 目錄下添加 HMUserAccount 類
• 定義模型屬性

/// 用戶帳號(hào)模型
/// - see: [http://open.weibo.com/wiki/OAuth2/access_token](http://open.weibo.com/wiki/OAuth2/access_token)
class HMUserAccount: NSObject {

    // 用于調(diào)用access_token，接口獲取授權(quán)后的access token
    var access_token: String?
    // access_token的生命周期，單位是秒數(shù)
    var expires_in: NSTimeInterval = 0
    // 當(dāng)前授權(quán)用戶的UID
    var uid: String?

    init(dict: [String: AnyObject]) {
        super.init()

        setValuesForKeysWithDictionary(dict)
    }

    override func setValue(value: AnyObject?, forUndefinedKey key: String) {}
}

• 創(chuàng)建用戶帳號(hào)模型辫愉，在 HMOAuthViewController 的網(wǎng)絡(luò)回調(diào)代碼中添加如下代碼

let account = HMUserAccount(dict: result as! [String: AnyObject])
print(account)

• 調(diào)試模型信息

• 與 OC 不同，如果要在 Swift 1.2 中調(diào)試模型信息将硝，需要遵守 Printable 協(xié)議恭朗，并且重寫 description 的 getter 方法，在 Swift 2.0 中依疼，description 屬性定義在 CustomStringConvertible 協(xié)議中

override var description: String {
    let keys = ["access_token", "expires_in", "uid"]
    return dictionaryWithValuesForKeys(keys).description
}

建議description此代碼抽取到Xcode的代碼塊中痰腮，方便使用

設(shè)置過(guò)期日期

過(guò)期日期

• 在新浪微博返回的數(shù)據(jù)中，過(guò)期日期是以當(dāng)前系統(tǒng)時(shí)間加上秒數(shù)計(jì)算的律罢，為了方便后續(xù)使用膀值，增加過(guò)期日期屬性

• 定義屬性

/// token過(guò)期日期
var expiresDate: NSDate?

• 在 expires_in 的 didSet 方法里面給 expiresDate 賦值

var expires_in: NSTimeInterval = 0 {
    didSet{
        expiresDate = NSDate(timeIntervalSinceNow: expires_in)
    }
}

• 修改 description

let keys = ["access_token", "expires_in", "expiresDate", "uid"]

加載用戶信息

課程目標(biāo)

• 通過(guò) AccessToken 獲取新浪微博網(wǎng)絡(luò)數(shù)據(jù)

接口定義

文檔地址

http://open.weibo.com/wiki/2/users/show

接口地址

https://api.weibo.com/2/users/show.json

HTTP 請(qǐng)求方式

• GET

請(qǐng)求參數(shù)

返回?cái)?shù)據(jù)

測(cè)試 URL

https://api.weibo.com/2/users/show.json?access_token=2.00ml8IrF0qLZ9W5bc20850c50w9hi9&uid=5365823342

代碼實(shí)現(xiàn)

• 在 HMOAuthViewController 中添加 loadUserInfo 方法

/// 加載用戶數(shù)據(jù)
///
/// - parameter userAccount: 用戶賬戶模型
private func loadUserInfo(userAccount: HMUserAccount) {

    let urlString = "https://api.weibo.com/2/users/show.json"
    // 定義參數(shù)
    let params = [
        "uid": userAccount.uid!,
        "access_token": userAccount.access_token!
    ]

    HMNetworkTools.shareTools.request(.GET, url: urlString, params: params) { (result, error) -> () in
        if error != nil {
            print("請(qǐng)求失敗:\(error)")
            return
        }
        print(result)
    }
}

• 在 loadAccessToken 方法中請(qǐng)求accessToken成功后調(diào)用該方法

// 將返回字典轉(zhuǎn)成模型
let account = HMUserAccount(dict: result as! [String: AnyObject])
print(account)
// 請(qǐng)求用戶數(shù)據(jù)
self.loadUserInfo(account)

注意：在 Swift 中歌逢，閉包中輸入代碼的智能提示非常不好，因此新建一個(gè)函數(shù)單獨(dú)處理加載用戶功能

擴(kuò)展用戶模型

• 在 HMUserAccount 中增加用戶名和頭像屬性

/// 友好顯示名稱
var screen_name: String?
/// 用戶頭像地址（大圖）悦冀，180×180像素
var avatar_large: String?

• 擴(kuò)展 description 中的屬性

override var description: String {
    let keys = ["access_token", "expires_in", "expiresDate", "uid", "screen_name", "avatar_large"]

    return dictionaryWithValuesForKeys(keys).description
}

• 在用戶信息請(qǐng)求成功之后獲取昵稱與頭像

// 發(fā)送get請(qǐng)求
HMNetworkTools.shareTools.request(.GET, url: urlString, params: params) { (result, error) -> () in
    if error != nil {
        print("請(qǐng)求失敗:\(error)")
        return
    }
    guard let dict = result as? [String: AnyObject] else {
        return
    }
    // 設(shè)置請(qǐng)求回來(lái)的用戶昵稱和頭像
    userAccount.screen_name = dict["screen_name"] as? String
    userAccount.avatar_large = dict["avatar_large"] as? String
}

每一個(gè)令牌授權(quán)一個(gè) 特定的網(wǎng)站 在 特定的時(shí)段內(nèi) 訪問(wèn) 特定的資源

歸檔 & 解檔

課程目標(biāo)

• 對(duì)比 OC 的歸檔 & 解檔實(shí)現(xiàn)

• 利用歸檔 & 解檔保存用戶信息

• 遵守協(xié)議

class HMUserAccount: NSObject, NSCoding

• 實(shí)現(xiàn)協(xié)議方法

// MARK: - NSCoding
/// 歸檔 - 將對(duì)象以二進(jìn)制形式保存至磁盤前被調(diào)用趋翻，與網(wǎng)絡(luò)的序列化類似
func encodeWithCoder(aCoder: NSCoder) {
    aCoder.encodeObject(access_token, forKey: "access_token")
    aCoder.encodeObject(expiresDate, forKey: "expiresDate")
    aCoder.encodeObject(uid, forKey: "uid")
    aCoder.encodeObject(name, forKey: "name")
    aCoder.encodeObject(avatar_large, forKey: "avatar_large")
}

/// 解檔 - 將二進(jìn)制數(shù)據(jù)從磁盤讀取并且轉(zhuǎn)換成對(duì)象時(shí)被調(diào)用睛琳，與網(wǎng)絡(luò)的反序列化類似
required init?(coder aDecoder: NSCoder) {
    access_token = aDecoder.decodeObjectForKey("access_token") as? String
    expiresDate = aDecoder.decodeObjectForKey("expiresDate") as? NSDate
    uid = aDecoder.decodeObjectForKey("uid") as? String
    name = aDecoder.decodeObjectForKey("name") as? String
    avatar_large = aDecoder.decodeObjectForKey("avatar_large") as? String
}

• 實(shí)現(xiàn)將當(dāng)前對(duì)象歸檔保存的函數(shù)

/// 歸檔保存當(dāng)前對(duì)象
func saveUserAccount(){
    let path = (NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask, true).last! as NSString).stringByAppendingPathExtension("userAccount.archive")!
    print("歸檔保存路徑：\(path)")
    // 歸檔
    NSKeyedArchiver.archiveRootObject(self, toFile: path)
}

視圖模型

目標(biāo)一：建立視圖模型盒蟆，抽取網(wǎng)絡(luò)請(qǐng)求代碼

• 建立用戶賬戶的視圖模型

/// 用戶賬戶視圖模型
class HMUserAccountViewModel: NSObject {

    /// 單例
    static let sharedUserAccount = HMUserAccountViewModel()

    /// 用戶賬戶模型
    var userAccount: HMUserAccount?
}

• 抽取網(wǎng)絡(luò)請(qǐng)求代碼到視圖模型中

/// 加載AccessToken并且加載用戶信息
///
/// - parameter code:     授權(quán)碼
/// - parameter complete: 完成回調(diào)
func loadAccessToken(code: String, complete:(isSuccessed: Bool)->()){

    let urlString = "https://api.weibo.com/oauth2/access_token"

    // 定義參數(shù)
    let params = [
        "client_id": WB_APPKEY,
        "client_secret": WB_APPSECRET,
        "grant_type": "authorization_code",
        "code": code,
        "redirect_uri": WB_REDIRECTURI]

    HMNetworkTools.sharedTools.request(.POST, urlString: urlString, parameters: params) { (response, error) -> () in

        if error != nil {
            print(error)
            return
        }

        let account = HMUserAccount(dict: response as! [String: AnyObject])
        print(account)
        self.userAccount = account
        // 請(qǐng)求用戶數(shù)據(jù)
        self.loadUserInfo(account.uid!, accessToken: account.access_token!, complete: complete)
    }
}

/// 加載用戶信息
///
/// - parameter uid:         用戶uid
/// - parameter accessToken: accessToken
/// - parameter complete:    完成回調(diào)
private func loadUserInfo(uid: String, accessToken: String, complete:(isSuccessed: Bool)->()){

    let urlString = "https://api.weibo.com/2/users/show.json"
    // 組織參數(shù)
    let params = [
        "access_token": accessToken,
        "uid": uid
    ]
    // 發(fā)送請(qǐng)求
    HMNetworkTools.sharedTools.request(.GET, urlString: urlString, parameters: params) { (response, error) -> () in

        if error != nil {
            print("請(qǐng)求失敗\(error)")
            complete(isSuccessed: false)
            return
        }
        print(response)

        // 在 if let 或者 guard let 里面 使用 as 都使用 ?
        guard let responseDic = response as? [String: AnyObject] else {
            print("返回?cái)?shù)據(jù)不是一個(gè)字典")
            complete(isSuccessed: false)
            return
        }
        // 賦值用戶的頭像與昵稱
        self.userAccount?.screen_name = responseDic["screen_name"] as? String
        self.userAccount?.avatar_large = responseDic["avatar_large"] as? String

        complete(isSuccessed: true)
    }
}

• 修改 HMOAuthViewController 中的代碼調(diào)用

// 請(qǐng)求  AccessToken以及用戶數(shù)據(jù)
HMUserAccountViewModel.sharedUserAccount.loadAccessToken(code, complete: { (isSuccessed) -> () in
    if isSuccessed {
        print("個(gè)人信息請(qǐng)求成功，跳轉(zhuǎn)界面")
    }else{
        print("個(gè)人信息請(qǐng)求失敗")
    }
})

• 刪除控制器里面 loadAccessToken 與 loadUserInfo 兩個(gè)方法

控制器的代碼簡(jiǎn)單了师骗！

目標(biāo)二：加載歸檔保存的 token历等，避免重復(fù)登錄

• 抽取歸檔代碼到 ViewModel中，并且實(shí)現(xiàn)解檔方法

// MARK: - 保存 & 加載
/// 解檔歸檔路徑
    // 歸檔與解檔的路徑
    private var archivePath: String = (NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask, true).last! as NSString).stringByAppendingPathComponent("useraccount.archive")

// 歸檔當(dāng)前對(duì)象
func saveAccount(account: HMUserAccount) {
    // 歸檔
    NSKeyedArchiver.archiveRootObject(account, toFile: archivePath)
}

// 解檔
func loadUserAccount() -> HMUserAccount? {
    // 解檔
    let result = NSKeyedUnarchiver.unarchiveObjectWithFile(archivePath) as? HMUserAccount
    return result
}

• 在 AppDelegate 中添加以下代碼測(cè)試

printLog(HMUserAccountViewModel.sharedUserAccount.loadUserAccount())

• 代碼優(yōu)化辟癌，在視圖模型初始化方法里面添加解檔的邏輯

private override init() {
    super.init()
    userAccount = loadUserAccount()
}

private init 可以避免外部調(diào)用構(gòu)造函數(shù)創(chuàng)建對(duì)象

• 在 view model 中添加 accessToken 計(jì)算型屬性

// 提供給外界accessToken的值
var accessToken: String? {
    return userAccount?.access_token
}

• 添加 isExpires 判斷帳號(hào)是否過(guò)期

// 帳號(hào)是否過(guò)期
var isExpires: Bool {
    if userAccount?.expiresDate?.compare(NSDate()) == NSComparisonResult.OrderedDescending {
        return false
    }
    return true
}

• 更改 accessToken 的 get 方法

// 訪問(wèn)令牌
var accessToken: String? {
    // 其內(nèi)部判斷 accessToken 是否有
    if !isExpires {
        return userAccount?.access_token
    }
    return nil
}

• 修改 HMVisitorViewController 中的用戶登錄標(biāo)記

var userLogon = HMUserAccountViewModel.sharedUserAccount.accessToken != nil

• 在視圖模型中增加 userLogon 計(jì)算型屬性

/// 用戶登錄標(biāo)記
var userLogon: Bool {
    return userAccount?.access_token != nil
}

• 再次修改 HMVisitorViewController 中的用戶登錄標(biāo)記

var userLogon = HMUserAccountViewModel.sharedUserAccount.userLogon