一、Cookie 是什麼
Cookie 是網站為了辨識終端身分,存放在本機的使用者憑證資料,其中有哪些欄位、各自代表什麼意義,都由伺服器端定義。
典型流程是這樣的:使用者登入某個網站後,伺服器會在回應中帶上 Cookie;App 收到之後把它保存下來,等到下次再拜訪同一個網站,就把這份 Cookie 一併送回去。伺服器只要檢查 Cookie 是否仍有效,就能判斷能不能讓這位使用者免密碼自動登入。
二、iOS 中負責 Cookie 的兩個類別
在 iOS 上,HTTP 請求的 Cookie 主要由 NSHTTPCookieStorage 與 NSHTTPCookie 這兩個類別負責:前者管理整份儲存空間,後者代表單一筆 Cookie。
1. NSHTTPCookieStorage
這個類別採單例設計,集中管理所有 HTTP 請求的 Cookie,常用方法如下:
// 取得單例
+ (NSHTTPCookieStorage *)sharedHTTPCookieStorage;
// 所有 Cookie,元素為 NSHTTPCookie
@property (nullable, readonly, copy) NSArray<NSHTTPCookie *> *cookies;
// 手動寫入一筆 Cookie
- (void)setCookie:(NSHTTPCookie *)cookie;
// 刪除指定 Cookie
- (void)deleteCookie:(NSHTTPCookie *)cookie;
// 取得指定 URL 的所有 Cookie
- (nullable NSArray<NSHTTPCookie *> *)cookiesForURL:(NSURL *)URL;
// 刪除某時間點之後的所有 Cookie,iOS 8 起可用
- (void)removeCookiesSinceDate:(NSDate *)date NS_AVAILABLE(10_10, 8_0);
// 為指定 URL 寫入多筆 Cookie
- (void)setCookies:(NSArray<NSHTTPCookie *> *)cookies forURL:(nullable NSURL *)URL mainDocumentURL:(nullable NSURL *)mainDocumentURL;
// Cookie 接收策略
/*
typedef NS_ENUM(NSUInteger, NSHTTPCookieAcceptPolicy) {
NSHTTPCookieAcceptPolicyAlways, // 全部接收
NSHTTPCookieAcceptPolicyNever, // 全部不接收
NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain // 只接收主文件網域
};
*/
@property NSHTTPCookieAcceptPolicy cookieAcceptPolicy;
系統另外提供兩個與 Cookie 相關的通知:
// 接收策略變動時送出
FOUNDATION_EXPORT NSString * const NSHTTPCookieManagerAcceptPolicyChangedNotification;
// 儲存的 Cookie 有變動時送出
FOUNDATION_EXPORT NSString * const NSHTTPCookieManagerCookiesChangedNotification;
2. NSHTTPCookie
這個類別代表單筆 Cookie 資料,屬性與方法如下:
// 以字典建立物件,兩種寫法擇一
- (nullable instancetype)initWithProperties:(NSDictionary<NSString *, id> *)properties;
+ (nullable NSHTTPCookie *)cookieWithProperties:(NSDictionary<NSString *, id> *)properties;
// 轉成可直接放進 HTTP 表頭的字典
+ (NSDictionary<NSString *, NSString *> *)requestHeaderFieldsWithCookies:(NSArray<NSHTTPCookie *> *)cookies;
// 從回應表頭與 URL 中解析出 Cookie
+ (NSArray<NSHTTPCookie *> *)cookiesWithResponseHeaderFields:(NSDictionary<NSString *, NSString *> *)headerFields forURL:(NSURL *)URL;
// 屬性字典
@property (nullable, readonly, copy) NSDictionary<NSString *, id> *properties;
// 協定版本
@property (readonly) NSUInteger version;
// 名稱
@property (readonly, copy) NSString *name;
// 值
@property (readonly, copy) NSString *value;
// 過期時間
@property (nullable, readonly, copy) NSDate *expiresDate;
// 網域
@property (readonly, copy) NSString *domain;
// 路徑
@property (readonly, copy) NSString *path;
// 是否要求安全傳輸
@property (readonly, getter=isSecure) BOOL secure;
// 是否僅限 HTTP 使用
@property (readonly, getter=isHTTPOnly) BOOL HTTPOnly;
// 說明文字
@property (nullable, readonly, copy) NSString *comment;
// 說明網址
@property (nullable, readonly, copy) NSURL *commentURL;
// 可用連接埠清單
@property (nullable, readonly, copy) NSArray<NSNumber *> *portList;
三、清除 Cookie 的幾種做法
清掉某個網域下的所有 Cookie:
NSURL *url = [NSURL URLWithString:@"https://www.baidu.com"];
if (url) {
NSArray *cookies = [[NSHTTPCookieStorage sharedHTTPCookieStorage] cookiesForURL:url];
for (int i = 0; i < [cookies count]; i++) {
NSHTTPCookie *cookie = (NSHTTPCookie *)[cookies objectAtIndex:i];
[[NSHTTPCookieStorage sharedHTTPCookieStorage] deleteCookie:cookie];
}
}
只刪除某一筆指定名稱的 Cookie:
NSArray *cookArray = [[NSHTTPCookieStorage sharedHTTPCookieStorage] cookiesForURL:[NSURL URLWithString:self.loadURL]];
NSString *successCode = @"";
for (NSHTTPCookie *cookie in cookArray) {
if ([cookie.name isEqualToString:@"cookiename"]) {
[[NSHTTPCookieStorage sharedHTTPCookieStorage] deleteCookie:cookie];
}
}
清除某個網址的請求快取:
[[NSURLCache sharedURLCache] removeCachedResponseForRequest:[NSURLRequest requestWithURL:url]];
清除全部快取:
[[NSURLCache sharedURLCache] removeAllCachedResponses];
實務上要注意的是,Cookie 與 URL 快取是兩套不同的東西:登出時若只清 Cookie,快取裡的頁面內容可能還是舊的;反之亦然。釐清需求後再決定要清哪一層,才能避免出現「明明已登出卻還看到個人資料」這類狀況。