iOS网络编程之四——请求类NSURLRequest使用详解

最新推荐文章于 2017-03-29 16:02:16 发布

free菠菜

最新推荐文章于 2017-03-29 16:02:16 发布

阅读量1.5k

点赞数

本文详细介绍了 iOS 开发中 NSURLRequest 的使用方法及属性设置，包括缓存策略、超时时间等，并对比了 NSMutableURLRequest 的灵活性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

转载：http://my.oschina.net/u/2340880/blog/620225?p=1

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;