URL Session(Cookie)

URL Session(NSURLSession)

URL Session(NSURLSessionDataTask))

URL Session(NSURLSessionUploadTask)

URL Session(NSURLSessionDownloadTask)

URL Session(Cache).md

URL Session(Cookie)

当你访问一个网站时，NSURLRequest都会帮你主动记录下来你访问的站点设置的cookie，如果Cookie存在的话，会把这些信息放在NSHTTPCookieStorage容器中共享，当你下次再访问这个站点时，NSURLRequest会拿着上次保存下来了的cookie继续去请求。

cookie和缓存一样有两个类控制。

1. NSHTTPCookieStorage：Cookie管理器。
2. NSHTTPCookie：Cookie实际对象。

1 NSHTTPCookieStorage

NSHTTPCookieStorage实际是一个共享的单例对象，它存储整个应用的所有Cookie，并在所有线程中是同步的。

1.1 获取NSHTTPCookieStorage

// 获取共享的NSHTTPCookieStorage
public class func sharedHTTPCookieStorage() -> NSHTTPCookieStorage
// 获取应用程序组的NSHTTPCookieStorage
public class func sharedCookieStorageForGroupContainerIdentifier(identifier: String) -> NSHTTPCookieStorage

1.2 获取和设置Cookie访问策略

public var cookieAcceptPolicy: NSHTTPCookieAcceptPolicy

public enum NSHTTPCookieAcceptPolicy : UInt {
    case Always // 全部允许
    case Never // 全部不允许
    case OnlyFromMainDocumentDomain // 只允许顶级地址的cookie通过
}

1.3 增加和删除Cookie

// 增加cookie
public func setCookie(cookie: NSHTTPCookie)
// 增加cookie的同时绑定地址
public func setCookies(cookies: [NSHTTPCookie], forURL URL: NSURL?, mainDocumentURL: NSURL?)
// 删除指定cookie
public func deleteCookie(cookie: NSHTTPCookie)
// 根据日期删除cookie
public func removeCookiesSinceDate(date: NSDate)

1.4 获取Cookie

// 获取所有cookie
public var cookies: [NSHTTPCookie]? { get }
// 根据路径放回cookie
public func cookiesForURL(URL: NSURL) -> [NSHTTPCookie]?
// 获取所有cookie并排序
public func sortedCookiesUsingDescriptors(sortOrder: [NSSortDescriptor]) -> [NSHTTPCookie]

1.5 通知

// cookieAcceptPolicy变动通知
public let NSHTTPCookieManagerAcceptPolicyChangedNotification: String
// cookie 变化
public let NSHTTPCookieManagerCookiesChangedNotification: String

2 NSHTTPCookie

NSHTTPCookie是cookie的实际对象。这里不再详细描述，有兴趣的朋友查阅API《NSHTTPCookie Class Reference》

3 实战演练

//
// YJHTTPCookieVC.swift
// NSURLSession
//
// Created by yangjun on 15/12/5.
// Copyright © 2015年 阳君. All rights reserved.
//

import UIKit

/// NSHTTPCookie
class YJHTTPCookieVC: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()

        // 共享cookie
        let sharedHTTPCookie = NSHTTPCookieStorage.sharedHTTPCookieStorage()

        // 手动创建一个cookie
        var dict = [String : AnyObject]()
        dict[NSHTTPCookieName] = "阳君"
        dict[NSHTTPCookieValue] = "937447974"
        dict[NSHTTPCookieVersion] = 1
        dict[NSHTTPCookieDomain] = "blog.csdn.net"
        dict[NSHTTPCookiePath] = "/"
        if let cookie = NSHTTPCookie(properties: dict) {
            print("手动创建\(cookie.properties)")
            sharedHTTPCookie.setCookie(cookie)
        }

        // 删除所有
        if let list = sharedHTTPCookie.cookies {
            // 获取cookie的header
            print(NSHTTPCookie.requestHeaderFieldsWithCookies(list))
            for cookie in list {
                // 读取cookie
                print(cookie.properties)
                // 删除cookie
                sharedHTTPCookie.deleteCookie(cookie)
            }
        }
    }

}

 

其他

参考资料

URL Session Programming Guide

NSHTTPCookie Class Reference

[NSHTTPCookie Class Reference]

文档修改记录

时间	描述
2015-12-05	博文完成
2015-12-12	更改链接

版权所有

CSDN：http://blog.csdn.net/y550918116j

GitHub：https://github.com/937447974/Blog