iOS網絡程式設計之七——本地使用者憑證Cookie的應用

一、何為Cookie

   Cookie是網站為了便是終端身份，儲存在終端本地的使用者憑證資訊。Cookie中的字段與意義由服務端進行定義。例如，當使用者在某個網站進行了登入操作後，服務端會将Cookie資訊傳回給終端，終端會将這些資訊進行儲存，在下一次再次通路這個網站時，終端會将儲存的Cookie資訊一并發送到服務端，服務端根據Cookie資訊是否有效來判斷此使用者是否可以自動登入。

二、iOS中進行Cookie管理的兩個類

   iOS中進行HTTP網絡請求Cookie管理主要由兩個類負責，一個類是NSHTTPCookieStorage類，一個是NSHTTPCookie類。

1.NSHTTPCookieStorage

   NSHTTPCookieStorage類采用單例的設計模式，其中管理着所有HTTP請求的Cookie資訊，常用方法如下：

//擷取單例對象

+ (NSHTTPCookieStorage *)sharedHTTPCookieStorage;

//所有Cookie資料數組 其中存放NSHTTPCookie對象

@property (nullable , readonly, copy) NSArray<NSHTTPCookie *> *cookies;

//手動設定一條Cookie資料

- (void)setCookie:(NSHTTPCookie *)cookie;

//删除某條Cookie資訊

- (void)deleteCookie:(NSHTTPCookie *)cookie;

//删除某個時間後的所有Cookie資訊 iOS8後可用

- (nullable NSArray<NSHTTPCookie *> *)cookiesForURL:(NSURL *)URL;

//擷取某個特定URL的所有Cookie資料

- (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,//接收所有Cookie資訊

   NSHTTPCookieAcceptPolicyNever,//不接收所有Cookie資訊

   NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain//隻接收主文檔域的Cookie資訊

};

*/

@property NSHTTPCookieAcceptPolicy cookieAcceptPolicy;

系統下面的兩個通知與Cookie管理有關：

//Cookie資料的接收協定改變時發送的通知

FOUNDATION_EXPORT NSString * const NSHTTPCookieManagerAcceptPolicyChangedNotification;

//管理的Cookie資料發生變化時發送的通知

FOUNDATION_EXPORT NSString * const NSHTTPCookieManagerCookiesChangedNotification;

2.NSHTTPCookie

   NSHTTPCookie是具體的HTTP請求Cookie資料對象，其中屬性方法如下：

//下面兩個方法用于對象的建立和初始化 都是通過字典進行鍵值設定

- (nullable instancetype)initWithProperties:(NSDictionary<NSString *, id> *)properties;

+ (nullable NSHTTPCookie *)cookieWithProperties:(NSDictionary<NSString *, id> *)properties;

//傳回Cookie資料中可用于添加HTTP頭字段的字典

+ (NSDictionary<NSString *, NSString *> *)requestHeaderFieldsWithCookies:(NSArray<NSHTTPCookie *> *)cookies;

//從指定的響應頭和URL位址中解析出Cookie資料

+ (NSArray<NSHTTPCookie *> *)cookiesWithResponseHeaderFields:(NSDictionary<NSString *, NSString *> *)headerFields forURL:(NSURL *)URL;

//Cookie資料中的屬性字典

@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;

//相應的文檔URL

@property (nullable, readonly, copy) NSURL *commentURL;

//服務端口清單

@property (nullable, readonly, copy) NSArray<NSNumber *> *portList;