07-Access Token

Access Token

課程目標(biāo)

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

接口定義

文檔地址

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

接口地址

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

HTTP 請求方式

  • POST

請求參數(shù)

參數(shù) 描述
client_id 申請應(yīng)用時分配的AppKey
client_secret 申請應(yīng)用時分配的AppSecret
grant_type 請求的類型，填寫 authorization_code
code 調(diào)用authorize獲得的code值
redirect_uri 回調(diào)地址，需需與注冊應(yīng)用里的回調(diào)地址一致

返回數(shù)據(jù)

返回值字段 字段說明
access_token 用于調(diào)用access_token，接口獲取授權(quán)后的access token
expires_in access_token的生命周期，單位是秒數(shù)
remind_in access_token的生命周期（該參數(shù)即將廢棄，開發(fā)者請使用expires_in）
uid 當(dāng)前授權(quán)用戶的UID

用戶賬戶模型

加載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("請求碼：\(code)")
    // 請求AccessToken
    loadAccessToken(code)
}else{
    // 用戶點擊了取消授權(quán)，直接關(guān)閉頁面
    self.close()
}

運(yùn)行測試

  • 返回錯誤信息
Error Domain=com.alamofire.error.serialization.response Code=-1016 "Request failed: unacceptable content-type: text/plain"
  • 在 HMNetworkTools 單例初始化時設(shè)置反序列化數(shù)據(jù)格式
static let shareTools: HMNetworkTools = {
    let tools = HMNetworkTools()
    tools.responseSerializer.acceptableContentTypes?.insert("text/plain")
    return tools
}()

定義 HMUserAcount 模型

  • 在 Model 目錄下添加 HMUserAccount 類
  • 定義模型屬性
/// 用戶帳號模型
/// - 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)建用戶帳號模型，在 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è)置過期日期

過期日期

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

  • 定義屬性

/// token過期日期
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)

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

接口定義

文檔地址

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

接口地址

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

HTTP 請求方式

  • GET

請求參數(shù)

參數(shù) 描述
access_token 采用OAuth授權(quán)方式為必填參數(shù)，其他授權(quán)方式不需要此參數(shù)，OAuth授權(quán)后獲得
uid 需要查詢的用戶ID

返回數(shù)據(jù)

返回值字段 字段說明
name 友好顯示名稱
avatar_large 用戶頭像地址（大圖），180×180像素

測試 URL

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

代碼實現(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("請求失敗:\(error)")
            return
        }
        print(result)
    }
}
  • 在 loadAccessToken 方法中請求accessToken成功后調(diào)用該方法
// 將返回字典轉(zhuǎn)成模型
let account = HMUserAccount(dict: result as! [String: AnyObject])
print(account)
// 請求用戶數(shù)據(jù)
self.loadUserInfo(account)

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

擴(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
}
  • 在用戶信息請求成功之后獲取昵稱與頭像
// 發(fā)送get請求
HMNetworkTools.shareTools.request(.GET, url: urlString, params: params) { (result, error) -> () in
    if error != nil {
        print("請求失敗:\(error)")
        return
    }
    guard let dict = result as? [String: AnyObject] else {
        return
    }
    // 設(shè)置請求回來的用戶昵稱和頭像
    userAccount.screen_name = dict["screen_name"] as? String
    userAccount.avatar_large = dict["avatar_large"] as? String
}

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

歸檔 & 解檔

課程目標(biāo)

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

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

  • 遵守協(xié)議

class HMUserAccount: NSObject, NSCoding
  • 實現(xiàn)協(xié)議方法
// MARK: - NSCoding
/// 歸檔 - 將對象以二進(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)換成對象時被調(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
}
  • 實現(xiàn)將當(dāng)前對象歸檔保存的函數(shù)
/// 歸檔保存當(dāng)前對象
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ò)請求代碼

  • 建立用戶賬戶的視圖模型
/// 用戶賬戶視圖模型
class HMUserAccountViewModel: NSObject {

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

    /// 用戶賬戶模型
    var userAccount: HMUserAccount?
}
  • 抽取網(wǎng)絡(luò)請求代碼到視圖模型中
/// 加載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
        // 請求用戶數(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ā)送請求
    HMNetworkTools.sharedTools.request(.GET, urlString: urlString, parameters: params) { (response, error) -> () in

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

        // 在 if let 或者 guard let 里面 使用 as 都使用 ?
        guard let responseDic = response as? [String: AnyObject] else {
            print("返回數(shù)據(jù)不是一個字典")
            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)用
// 請求  AccessToken以及用戶數(shù)據(jù)
HMUserAccountViewModel.sharedUserAccount.loadAccessToken(code, complete: { (isSuccessed) -> () in
    if isSuccessed {
        print("個人信息請求成功，跳轉(zhuǎn)界面")
    }else{
        print("個人信息請求失敗")
    }
})
  • 刪除控制器里面 loadAccessToken 與 loadUserInfo 兩個方法

控制器的代碼簡單了！

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

  • 抽取歸檔代碼到 ViewModel中，并且實現(xiàn)解檔方法
// MARK: - 保存 & 加載
/// 解檔歸檔路徑
    // 歸檔與解檔的路徑
    private var archivePath: String = (NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask, true).last! as NSString).stringByAppendingPathComponent("useraccount.archive")

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

// 解檔
func loadUserAccount() -> HMUserAccount? {
    // 解檔
    let result = NSKeyedUnarchiver.unarchiveObjectWithFile(archivePath) as? HMUserAccount
    return result
}
  • 在 AppDelegate 中添加以下代碼測試
printLog(HMUserAccountViewModel.sharedUserAccount.loadUserAccount())
  • 代碼優(yōu)化，在視圖模型初始化方法里面添加解檔的邏輯
private override init() {
    super.init()
    userAccount = loadUserAccount()
}

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

  • 在 view model 中添加 accessToken 計算型屬性
// 提供給外界accessToken的值
var accessToken: String? {
    return userAccount?.access_token
}
  • 添加 isExpires 判斷帳號是否過期
// 帳號是否過期
var isExpires: Bool {
    if userAccount?.expiresDate?.compare(NSDate()) == NSComparisonResult.OrderedDescending {
        return false
    }
    return true
}
  • 更改 accessToken 的 get 方法
// 訪問令牌
var accessToken: String? {
    // 其內(nèi)部判斷 accessToken 是否有
    if !isExpires {
        return userAccount?.access_token
    }
    return nil
}
  • 修改 HMVisitorViewController 中的用戶登錄標(biāo)記
var userLogon = HMUserAccountViewModel.sharedUserAccount.accessToken != nil
  • 在視圖模型中增加 userLogon 計算型屬性
/// 用戶登錄標(biāo)記
var userLogon: Bool {
    return userAccount?.access_token != nil
}
  • 再次修改 HMVisitorViewController 中的用戶登錄標(biāo)記
var userLogon = HMUserAccountViewModel.sharedUserAccount.userLogon
最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具（例如配置管理，服務(wù)發(fā)現(xiàn)，斷路器，智...
    卡卡羅2017閱讀 136,659評論 19贊 139
  • 發(fā)現(xiàn) 關(guān)注 消息 iOS 第三方庫、插件、知名博客總結(jié) 作者大灰狼的小綿羊哥哥關(guān)注 2017.06.26 09:4...
    肇東周閱讀 15,434評論 4贊 61
  • 5 分享內(nèi)容到你的網(wǎng)站 上一章中，你在網(wǎng)站中構(gòu)建了用戶注冊和認(rèn)證。你學(xué)會了如何為用戶創(chuàng)建自定義的個人資料模型，并添...
    lakerszhy閱讀 1,730評論 5贊 16
  • 自學(xué)寫下第一篇產(chǎn)品體驗報告，誠邀互聯(lián)網(wǎng)前輩們給出意見~ 產(chǎn)品體驗報告框架產(chǎn)品體驗報告框架圖 1.市場分析（戰(zhàn)略層）...
    叮咚醬閱讀 2,933評論 4贊 10
  • 一眨眼來澳洲四年多了，輾轉(zhuǎn)了兩個城市，換了四個工作，突然想分享一下自己的一些經(jīng)驗和感受，或許能對新來的或者準(zhǔn)備來的...
    aussieweever閱讀 4,206評論 2贊 4

友情鏈接更多精彩內(nèi)容