iOS網絡程式設計之四——請求類NSURLRequest使用詳解

一、引言

       在前面幾篇部落格中，介紹了iOS開發中的網絡程式設計相關内容并且介紹了常用了兩個平行的網絡架構NSURLSession和NSURLConnection。無論是NSURLSession類還是NSURLConnection類，其網絡請求都是通過NSURLRequest類進行發起的，本篇部落格将介紹NSURLRequest類的用法和其中請求屬性的設定。

       前幾篇部落格位址如下：

1.iOS網絡架構介紹：

http://my.oschina.net/u/2340880/blog/618460

。

2.NSURLSesstion的使用：

http://my.oschina.net/u/2340880/blog/618888

3.NSURLConnection的使用：

http://my.oschina.net/u/2340880/blog/618920

二、NSURLRequest類中常用方法和屬性總結

//通過類方法建立預設的請求對象

/*

通過這種方式建立的請求對象 預設使用NSURLRequestUseProtocolCachePolicy緩存邏輯 預設請求逾時時限為60s

*/

+ (instancetype)requestWithURL:(NSURL *)URL;

//傳回一個BOOL值 用于判斷是否支援安全編碼

+ (BOOL)supportsSecureCoding;

//請求對象的初始化方法 建立時設定緩存邏輯和逾時時限

+ (instancetype)requestWithURL:(NSURL *)URL cachePolicy:(NSURLRequestCachePolicy)cachePolicy timeoutInterval:(NSTimeInterval)timeoutInterval;

//init方法進行對象的建立 預設使用NSURLRequestUseProtocolCachePolicy緩存邏輯 預設請求逾時時限為60s

- (instancetype)initWithURL:(NSURL *)URL;

//init方法進行對象的建立

- (instancetype)initWithURL:(NSURL *)URL cachePolicy:(NSURLRequestCachePolicy)cachePolicy timeoutInterval:(NSTimeInterval)timeoutInterval;

//隻讀屬性 擷取請求對象的URL

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

//隻讀屬性 緩存政策枚舉

NSURLRequestCachePolicy枚舉如下：

typedef NS_ENUM(NSUInteger, NSURLRequestCachePolicy)

{

   //預設的緩存協定

   NSURLRequestUseProtocolCachePolicy = 0,

   //無論有無本地緩存資料 都進行從新請求

   NSURLRequestReloadIgnoringLocalCacheData = 1,

   //忽略本地和遠端的緩存資料 未實作的政策

   NSURLRequestReloadIgnoringLocalAndRemoteCacheData = 4,

   //無論有無緩存資料 都進行從新請求

   NSURLRequestReloadIgnoringCacheData = NSURLRequestReloadIgnoringLocalCacheData,

   //先檢查緩存 如果沒有緩存再進行請求

   NSURLRequestReturnCacheDataElseLoad = 2,

   //類似離線模式，隻讀緩存 無論有無緩存都不進行請求

   NSURLRequestReturnCacheDataDontLoad = 3,

   //未實作的政策

   NSURLRequestReloadRevalidatingCacheData = 5, // Unimplemented

};

@property (readonly) NSURLRequestCachePolicy cachePolicy;

//隻讀屬性 擷取請求的逾時時限

@property (readonly) NSTimeInterval timeoutInterval;

//請求主文檔位址

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

//擷取網絡請求的服務類型 枚舉如下

typedef NS_ENUM(NSUInteger, NSURLRequestNetworkServiceType)

   NSURLNetworkServiceTypeDefault = 0, // Standard internet traffic

   NSURLNetworkServiceTypeVoIP = 1, // Voice over IP control traffic

   NSURLNetworkServiceTypeVideo = 2, // Video traffic

   NSURLNetworkServiceTypeBackground = 3, // Background traffic

   NSURLNetworkServiceTypeVoice = 4    // Voice data

@property (readonly) NSURLRequestNetworkServiceType networkServiceType;

//擷取是否允許使用服務商蜂窩網絡

@property (readonly) BOOL allowsCellularAccess;

NSURLRequest請求類除了在初始化時可以設定一些屬性，建立出來後則大部分屬性都為隻讀的，無法設定與修改。另一個類NSMutableURLRequest可以更加靈活的設定請求的相關屬性。

三、NSMutableURLRequest類中常用方法與屬性總結

//設定請求的URL

@property (nullable, copy) NSURL *URL;

//設定請求的緩存政策

@property NSURLRequestCachePolicy cachePolicy;

//設定逾時時間

@property NSTimeInterval timeoutInterval;

//請求主文檔位址

@property (nullable, copy) NSURL *mainDocumentURL;

//設定網絡服務類型

@property NSURLRequestNetworkServiceType networkServiceType NS_AVAILABLE(10_7, 4_0);

//設定是否允許使用服務商蜂窩網

@property BOOL allowsCellularAccess NS_AVAILABLE(10_8, 6_0);

四、NSURLRequest請求對象與HTTP/HTTPS協定相關請求的屬性設定

       一下屬性的設定必須使用NSMutableURLRequest類，如果是NSURLRequest，則隻可以讀，不可以修改。

//設定HPPT請求方式 預設為“GET”

@property (copy) NSString *HTTPMethod;

//通過字典設定HTTP請求頭的鍵值資料

@property (nullable, copy) NSDictionary<NSString *, NSString *> *allHTTPHeaderFields;

//設定http請求頭中的字段值

- (void)setValue:(nullable NSString *)value forHTTPHeaderField:(NSString *)field;

//向http請求頭中添加一個字段

- (void)addValue:(NSString *)value forHTTPHeaderField:(NSString *)field;

//設定http請求體 用于POST請求

@property (nullable, copy) NSData *HTTPBody;

//設定http請求體的輸入流

@property (nullable, retain) NSInputStream *HTTPBodyStream;

//設定發送請求時是否發送cookie資料

@property BOOL HTTPShouldHandleCookies;

//設定請求時是否按順序收發 預設禁用 在某些伺服器中設為YES可以提高網絡性能

@property BOOL HTTPShouldUsePipelining;