iOS基础深入补完计划–NSURLRequest/NSURLResponse相关API

释放双眼,带上耳机,听听看~!
学习NSURLSession之前、先撸一遍NSURLRequest(请求)和NSURLResponse(响应)头文件里的属性和API

NSURLRequest

@interface NSURLRequest : NSObject <NSSecureCoding, NSCopying, NSMutableCopying>
{
@private
NSURLRequestInternal *_internal;
}
/*!
创建NSURLRequest对象
默认使用NSURLRequestUseProtocolCachePolicy缓存逻辑
默认请求超时时限为60s
*/
+ (instancetype)requestWithURL:(NSURL *)URL;
/*!
是否支持安全编码
*/
+ (BOOL)supportsSecureCoding;
/*!
创建时设置缓存策略和超时时限
@param URL 请求链接
@param cachePolicy 缓存策略
@param timeoutInterval 超时时间
*/
+ (instancetype)requestWithURL:(NSURL *)URL cachePolicy:(NSURLRequestCachePolicy)cachePolicy timeoutInterval:(NSTimeInterval)timeoutInterval;
//init方法进行对象的创建 默认使用NSURLRequestUseProtocolCachePolicy缓存逻辑 默认请求超时时限为60s
- (instancetype)initWithURL:(NSURL *)URL;
/*!
创建NSURLRequest对象
默认使用NSURLRequestUseProtocolCachePolicy缓存逻辑
默认请求超时时限为60s
*/
- (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, // 普通网络传输,默认使用这个
NSURLNetworkServiceTypeVoIP = 1,    // 网络语音通信传输,只能在VoIP使用
NSURLNetworkServiceTypeVideo = 2,   // 影像传输
NSURLNetworkServiceTypeBackground = 3, // 网络后台传输,优先级不高时可使用。对用户不需要的网络操作可使用
NSURLNetworkServiceTypeVoice = 4       // 语音传输
};
*/
@property (readonly) NSURLRequestNetworkServiceType networkServiceType;
/*!
只读属性、获取是否允许蜂窝请求
*/
@property (readonly) BOOL allowsCellularAccess;
@end

NSMutableURLRequest

NSURLRequest的子类、放开了许多只读权限

@interface NSMutableURLRequest : NSURLRequest
/*!
设置请求的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 (NSHTTPURLRequest)

NSURLRequest的扩展、可以针对HTTP进行许多设置

@interface NSURLRequest (NSHTTPURLRequest)
/*!
设置HTTP请求的方式、默认为Get
*/
@property (copy) NSString *HTTPMethod;
//通过字典设置HTTP请求头的键值数据
/*!
通过字典、设置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;
/*!
在Post方式下、设置请求体
*/
@property (nullable, copy) NSData *HTTPBody;
/*!
设置http请求体的输入流
*/
@property (nullable, retain) NSInputStream *HTTPBodyStream;
/*!
发送请求时是否发送cookie数据
*/
@property BOOL HTTPShouldHandleCookies;
/*!
请求时是否按顺序收发
*/
@property BOOL HTTPShouldUsePipelining;
@end

NSURLResponse

@interface NSURLResponse : NSObject <NSSecureCoding, NSCopying>
{
@package
NSURLResponseInternal *_internal;
}
/*!
你可以自己生成一个NSURLResponse对象
@param URL 链接
@param MIMEType 响应类型(`application/json`等等)
@param length 响应内容长度
@param name 编码的名称
@result The initialized NSURLResponse.
@discussion This is the designated initializer for NSURLResponse.
*/
- (instancetype)initWithURL:(NSURL *)URL MIMEType:(nullable NSString *)MIMEType expectedContentLength:(NSInteger)length textEncodingName:(nullable NSString *)name NS_DESIGNATED_INITIALIZER;
/*!
返回响应对象的URL
*/
@property (nullable, readonly, copy) NSURL *URL;
/*!
返回响应类型(`application/json`等等)
*/
@property (nullable, readonly, copy) NSString *MIMEType;
/*!
返回响应内容长度
*/
@property (readonly) long long expectedContentLength;
/*!
返回编码类型
*/
@property (nullable, readonly, copy) NSString *textEncodingName;
/*!
返回响应文件的文件名(比如:person_object.json)
*/
@property (nullable, readonly, copy) NSString *suggestedFilename;
@end

NSHTTPURLResponse : NSURLResponse

@class NSHTTPURLResponseInternal;
@interface NSHTTPURLResponse : NSURLResponse
{
@package
NSHTTPURLResponseInternal *_httpInternal;
}
/*!
@param    url 链接
@param    statusCode 状态码(404等等)
@param    HTTPVersion HTTP版本(HTTP1.1/HTTP 2.0等)
@param    headerFields 响应头(字典)
*/
- (nullable instancetype)initWithURL:(NSURL *)url statusCode:(NSInteger)statusCode HTTPVersion:(nullable NSString *)HTTPVersion headerFields:(nullable NSDictionary<NSString *, NSString *> *)headerFields API_AVAILABLE(macos(10.7), ios(5.0), watchos(2.0), tvos(9.0));
/*!
返回状态码
*/
@property (readonly) NSInteger statusCode;
/*!
返回请求头字典
*/
@property (readonly, copy) NSDictionary *allHeaderFields;
/*!
将HTTP状态码转换成字符串
对照表:http://www.zhimengzhe.com/IOSkaifa/264293.html
*/
+ (NSString *)localizedStringForStatusCode:(NSInteger)statusCode;
@end
```
###参考资料
[NSHTTPURLResponse的localizedStringForStatusCode](http://www.zhimengzhe.com/IOSkaifa/264293.html)

人已赞赏
iOS文章

iOS开发一、NSURLRequest的相关API

2020-3-6 2:08:26

iOS文章

IOS网络开发NSURLSession详解(一)概述

2020-3-6 3:26:17

个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
有新消息 消息中心
搜索