版本记录
| 版本号 | 时间 |
|---|---|
| V1.0 | 2018.05.26 |
前言
我们做APP发起网络请求，一般都是使用框架，这些框架的底层也都是苹果的API，接下来几篇就一起来看一下和网络有关的几个类。感兴趣的可以看上面几篇文章。
1. 详细解析几个和网络请求有关的类 （一） —— NSURLSession
2. 详细解析几个和网络请求有关的类（二） —— NSURLRequest和NSMutableURLRequest
3. 详细解析几个和网络请求有关的类（三） —— NSURLConnection
4. 详细解析几个和网络请求有关的类（四） —— NSURLSession和NSURLConnection的区别
5. 详细解析几个和网络请求有关的类（五） —— 关于NSURL加载系统（一）
6. 详细解析几个和网络请求有关的类（六） —— 使用NSURLSession（二）
7. 详细解析几个和网络请求有关的类（七） —— URL数据的编码和解码（三）
8. 详细解析几个和网络请求有关的类（八） —— 处理重定向和其他请求更改（四）
9. 详细解析几个和网络请求有关的类（九） —— 身份验证挑战和TLS链验证（五）
10. 详细解析几个和网络请求有关的类（十） —— 理解获取缓存（六）
11. 详细解析几个和网络请求有关的类（十一） —— Cookies和自定义协议（七）
12. 详细解析几个和网络请求有关的类（十二） —— URL Session的生命周期（八）
13. 详细解析几个和网络请求有关的类（十三） —— NSURLResponse（一）
14. 详细解析几个和网络请求有关的类（十四） —— NSHTTPCookie（一）
15. 详细解析几个和网络请求有关的类（十五） —— NSHTTPCookieStorage（一）
16. 详细解析几个和网络请求有关的类（十六） —— NSURLCache（一）
17. 详细解析几个和网络请求有关的类（十七） —— NSCachedURLResponse（一）
18. 详细解析几个和网络请求有关的类（十八） —— NSURLAuthenticationChallenge（一）
19. 详细解析几个和网络请求有关的类（十九） —— NSURLProtectionSpace（一）
20. 详细解析几个和网络请求有关的类（二十） —— NSURLCredential（一）
21. 详细解析几个和网络请求有关的类（二十一） —— NSURLCredentialStorage（一）
22. 详细解析几个和网络请求有关的类（二十二） —— NSStream（一）
23. 详细解析几个和网络请求有关的类（二十三） —— NSInputStream（一）
24. 详细解析几个和网络请求有关的类（二十四） —— NSOutputStream（一）
25. 详细解析几个和网络请求有关的类（二十五） —— NSHTTPCookie之设置删除和通信（二）
回顾
上一篇讲述了Cookie的设置删除以及利用Cookie进行通信，下面这篇我们继续深入一下看一下和URL Loading相关的错误码NSURLError。
NSURLError - API
下面首先看一下NSURLError - API
*/
#if TARGET_OS_IPHONE
#if __has_include(<CFNetwork/CFNetwork.h>)
#import <CFNetwork/CFNetwork.h>
#endif
#elif TARGET_OS_WIN32
#import <CFNetwork/CFNetwork.h>
#else
#import <CoreServices/CoreServices.h>
#endif
#import <Foundation/NSObjCRuntime.h>
#import <Foundation/NSError.h>
@class NSString;
NS_ASSUME_NONNULL_BEGIN
/*
@discussion Constants used by NSError to differentiate between "domains" of error codes, serving as a discriminator for error codes that originate from different subsystems or sources.
@constant NSURLErrorDomain Indicates an NSURL error.
*/
FOUNDATION_EXPORT NSErrorDomain const NSURLErrorDomain;
/*!
@const NSURLErrorFailingURLErrorKey
@abstract The NSError userInfo dictionary key used to store and retrieve the URL which caused a load to fail.
*/
FOUNDATION_EXPORT NSString * const NSURLErrorFailingURLErrorKey API_AVAILABLE(macos(10.6), ios(4.0), watchos(2.0), tvos(9.0));
/*!
@const NSURLErrorFailingURLStringErrorKey
@abstract The NSError userInfo dictionary key used to store and retrieve the NSString object for the URL which caused a load to fail.
@discussion This constant supersedes NSErrorFailingURLStringKey, which was deprecated in Mac OS X 10.6. Both constants refer to the same value for backward-compatibility, but this symbol name has a better prefix.
*/
FOUNDATION_EXPORT NSString * const NSURLErrorFailingURLStringErrorKey API_AVAILABLE(macos(10.6), ios(4.0), watchos(2.0), tvos(9.0));
/*!
@const NSErrorFailingURLStringKey
@abstract The NSError userInfo dictionary key used to store and retrieve the NSString object for the URL which caused a load to fail.
@discussion This constant is deprecated in Mac OS X 10.6, and is superseded by NSURLErrorFailingURLStringErrorKey. Both constants refer to the same value for backward-compatibility, but the new symbol name has a better prefix.
*/
FOUNDATION_EXPORT NSString * const NSErrorFailingURLStringKey API_DEPRECATED("Use NSURLErrorFailingURLStringErrorKey instead", macos(10.0,10.6), ios(2.0,4.0), watchos(2.0,2.0), tvos(9.0,9.0));
/*!
@const NSURLErrorFailingURLPeerTrustErrorKey
@abstract The NSError userInfo dictionary key used to store and retrieve the SecTrustRef object representing the state of a failed SSL handshake.
*/
FOUNDATION_EXPORT NSString * const NSURLErrorFailingURLPeerTrustErrorKey API_AVAILABLE(macos(10.6), ios(4.0), watchos(2.0), tvos(9.0));
/*!
@const NSURLErrorBackgroundTaskCancelledReasonKey
@abstract The NSError userInfo dictionary key used to store and retrieve the NSNumber corresponding to the reason why a background
NSURLSessionTask was cancelled
*/
FOUNDATION_EXPORT NSString * const NSURLErrorBackgroundTaskCancelledReasonKey API_AVAILABLE(macos(10.10), ios(8.0), watchos(2.0), tvos(9.0));
/*!
@enum Codes associated with NSURLErrorBackgroundTaskCancelledReasonKey
@abstract Constants used by NSError to indicate why a background NSURLSessionTask was cancelled.
*/
NS_ENUM(NSInteger)
{
NSURLErrorCancelledReasonUserForceQuitApplication = 0,
NSURLErrorCancelledReasonBackgroundUpdatesDisabled = 1,
NSURLErrorCancelledReasonInsufficientSystemResources API_AVAILABLE(macos(10.10), ios(8.0), watchos(2.0), tvos(9.0)) = 2,
} API_AVAILABLE(macos(10.10), ios(7.0), watchos(2.0), tvos(9.0));
/*!
@enum NSURL-related Error Codes
@abstract Constants used by NSError to indicate errors in the NSURL domain
*/
NS_ERROR_ENUM(NSURLErrorDomain)
{
NSURLErrorUnknown = -1,
NSURLErrorCancelled = -999,
NSURLErrorBadURL = -1000,
NSURLErrorTimedOut = -1001,
NSURLErrorUnsupportedURL = -1002,
NSURLErrorCannotFindHost = -1003,
NSURLErrorCannotConnectToHost = -1004,
NSURLErrorNetworkConnectionLost = -1005,
NSURLErrorDNSLookupFailed = -1006,
NSURLErrorHTTPTooManyRedirects = -1007,
NSURLErrorResourceUnavailable = -1008,
NSURLErrorNotConnectedToInternet = -1009,
NSURLErrorRedirectToNonExistentLocation = -1010,
NSURLErrorBadServerResponse = -1011,
NSURLErrorUserCancelledAuthentication = -1012,
NSURLErrorUserAuthenticationRequired = -1013,
NSURLErrorZeroByteResource = -1014,
NSURLErrorCannotDecodeRawData = -1015,
NSURLErrorCannotDecodeContentData = -1016,
NSURLErrorCannotParseResponse = -1017,
NSURLErrorAppTransportSecurityRequiresSecureConnection API_AVAILABLE(macos(10.11), ios(9.0), watchos(2.0), tvos(9.0)) = -1022,
NSURLErrorFileDoesNotExist = -1100,
NSURLErrorFileIsDirectory = -1101,
NSURLErrorNoPermissionsToReadFile = -1102,
NSURLErrorDataLengthExceedsMaximum API_AVAILABLE(macos(10.5), ios(2.0), watchos(2.0), tvos(9.0)) = -1103,
NSURLErrorFileOutsideSafeArea API_AVAILABLE(macos(10.12.4), ios(10.3), watchos(3.2), tvos(10.2)) = -1104,
// SSL errors
NSURLErrorSecureConnectionFailed = -1200,
NSURLErrorServerCertificateHasBadDate = -1201,
NSURLErrorServerCertificateUntrusted = -1202,
NSURLErrorServerCertificateHasUnknownRoot = -1203,
NSURLErrorServerCertificateNotYetValid = -1204,
NSURLErrorClientCertificateRejected = -1205,
NSURLErrorClientCertificateRequired = -1206,
NSURLErrorCannotLoadFromNetwork = -2000,
// Download and file I/O errors
NSURLErrorCannotCreateFile = -3000,
NSURLErrorCannotOpenFile = -3001,
NSURLErrorCannotCloseFile = -3002,
NSURLErrorCannotWriteToFile = -3003,
NSURLErrorCannotRemoveFile = -3004,
NSURLErrorCannotMoveFile = -3005,
NSURLErrorDownloadDecodingFailedMidStream = -3006,
NSURLErrorDownloadDecodingFailedToComplete =-3007,
NSURLErrorInternationalRoamingOff API_AVAILABLE(macos(10.7), ios(3.0), watchos(2.0), tvos(9.0)) = -1018,
NSURLErrorCallIsActive API_AVAILABLE(macos(10.7), ios(3.0), watchos(2.0), tvos(9.0)) = -1019,
NSURLErrorDataNotAllowed API_AVAILABLE(macos(10.7), ios(3.0), watchos(2.0), tvos(9.0)) = -1020,
NSURLErrorRequestBodyStreamExhausted API_AVAILABLE(macos(10.7), ios(3.0), watchos(2.0), tvos(9.0)) = -1021,
NSURLErrorBackgroundSessionRequiresSharedContainer API_AVAILABLE(macos(10.10), ios(8.0), watchos(2.0), tvos(9.0)) = -995,
NSURLErrorBackgroundSessionInUseByAnotherProcess API_AVAILABLE(macos(10.10), ios(8.0), watchos(2.0), tvos(9.0)) = -996,
NSURLErrorBackgroundSessionWasDisconnected API_AVAILABLE(macos(10.10), ios(8.0), watchos(2.0), tvos(9.0))= -997,
};
NS_ASSUME_NONNULL_END
这里有一个很重要的错误码枚举NSURLErrorDomain，里面定义了错误码的值。
NSURLErrorDomain详细解析
先看一下其基本情况
1. NSURLErrorUnknown
URL加载系统遇到无法解释的错误时返回。
当错误来自较低级别的框架或库时，可能会发生这种情况。 无论何时收到此错误代码，都是一个错误，应该向Apple报告。
适用于Mac OS X v10.2及更高版本。
2. NSURLErrorCancelled
当异步加载被取消时返回。
Web Kit框架代理在对加载资源执行取消操作时将收到此错误。 请注意，如果下载被取消，NSURLConnection或NSURLDownload代理将不会收到此错误。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
3. NSURLErrorBadURL
当URL格式错误，无法启动URL请求时返回
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
4. NSURLErrorTimedOut
当异步操作超时时返回。
如果NSURLRequest中的timeoutInterval在加载完成之前到期，NSURLConnection会将此错误发送给它的委托。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
5. NSURLErrorUnsupportedURL
当形成的URL不能被框架处理时返回。
最可能的原因是URL没有可用的协议处理程序。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
6. NSURLErrorCannotFindHost
当无法解析URL的主机名时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
7. NSURLErrorCannotConnectToHost
当尝试连接到主机失败时返回。
当主机名解析时，可能会发生这种情况，但主机已关闭或可能不接受某个端口上的连接。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
8. NSURLErrorDataLengthExceedsMaximum
当资源数据的长度超过允许的最大值时返回。
适用于Mac OS X v10.5及更高版本。
在NSURLError.h中声明。
9. NSURLErrorNetworkConnectionLost
当客户端或服务器连接在正在进行的加载过程中被切断时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
10. NSURLErrorDNSLookupFailed
请参阅NSURLErrorCannotFindHost
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
11. NSURLErrorHTTPTooManyRedirects
当检测到重定向循环或超过允许重定向次数阈值（当前为16）时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
12. NSURLErrorResourceUnavailable
无法检索请求的资源时返回。
例如“未找到文件”以及数据解码问题，这些问题会阻止数据正确处理。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
13. NSURLErrorNotConnectedToInternet
当请求网络资源时返回，但互联网连接未建立，并且无法自动建立，无论是通过缺少连接还是由用户选择不自动建立网络连接。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
14. NSURLErrorRedirectToNonExistentLocation
当通过服务器响应代码指定重定向时返回，但服务器不附带重定向URL。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
15. NSURLErrorBadServerResponse
URL加载系统收到来自服务器的错误数据时返回。
这相当于HTTP服务器发送的500 Server Error消息。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
16. NSURLErrorUserCancelledAuthentication
用户取消异步认证请求时返回。
这通常是通过点击用户名/密码对话框中的“取消”按钮而发生的，而不是用户尝试进行身份验证。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
17. NSURLErrorUserAuthenticationRequired
在需要认证来访问资源时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
18. NSURLErrorZeroByteResource
当服务器报告URL的内容长度不为零时返回，但会“优雅地”终止网络连接而不发送任何数据。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
19. NSURLErrorCannotDecodeRawData
在NSURLConnection请求期间收到的内容数据无法解码已知内容编码时返回。
适用于Mac OS X v10.5及更高版本。
在NSURLError.h中声明。
20. NSURLErrorCannotDecodeContentData
在NSURLConnection请求期间收到的内容数据具有未知内容编码时返回。
适用于Mac OS X v10.5及更高版本。
在NSURLError.h中声明。
21. NSURLErrorCannotParseResponse
当对NSURLConnection请求的响应无法解析时返回。
适用于Mac OS X v10.5及更高版本。
在NSURLError.h中声明。
22. NSURLErrorFileDoesNotExist
当文件不存在时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
23. NSURLErrorFileIsDirectory
当对FTP文件的请求导致服务器响应该文件不是普通文件而是文件夹目录时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
24. NSURLErrorNoPermissionsToReadFile
由于权限不足而无法读取资源时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
25. NSURLErrorSecureConnectionFailed
当尝试建立安全连接失败时，由于无法更具体地表达的原因而返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
26. NSURLErrorServerCertificateHasBadDate
当服务器证书的日期显示已过期或尚未生效时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
27. NSURLErrorServerCertificateUntrusted
当服务器证书由不受信任的根服务器签名时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
28. NSURLErrorServerCertificateHasUnknownRoot
服务器证书未由任何根服务器签名时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
29. NSURLErrorServerCertificateNotYetValid
当服务器证书尚未有效时返回。
适用于Mac OS X v10.4及更高版本。
在NSURLError.h中声明。
30. NSURLErrorClientCertificateRejected
当服务器证书被拒绝时返回。
适用于Mac OS X v10.4及更高版本。
在NSURLError.h中声明。
31. NSURLErrorClientCertificateRequired
在NSURLConnection请求期间需要客户端证书来验证SSL连接时返回。
适用于Mac OS X v10.6及更高版本。
在NSURLError.h中声明。
32. NSURLErrorCannotLoadFromNetwork
仅当从缓存中加载项目的特定请求无法满足时才会返回。
这个错误是在库去网络的时候发送的，因为load only from cache指令阻止了这个事实的发生。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
33. NSURLErrorCannotCreateFile
当NSURLDownload对象由于I / O故障而无法在磁盘上创建下载的文件时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
34. NSURLErrorCannotOpenFile
当NSURLDownload无法在磁盘上打开下载的文件时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
35. NSURLErrorCannotCloseFile
当NSURLDownload无法关闭磁盘上的下载文件时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
36. NSURLErrorCannotWriteToFile
当NSURLDownload无法写入磁盘上的下载文件时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
37. NSURLErrorCannotRemoveFile
当NSURLDownload无法从磁盘删除下载的文件时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
38. NSURLErrorCannotMoveFile
当NSURLDownload无法将下载的文件移动到磁盘上时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
39. NSURLErrorDownloadDecodingFailedMidStream
当在下载过程中NSURLDownload无法解码编码文件时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
40. NSURLErrorDownloadDecodingFailedToComplete
当下载后NSURLDownload无法解码编码文件时返回。
适用于Mac OS X v10.2及更高版本。
在NSURLError.h中声明。
41. NSURLErrorInternationalRoamingOff
当连接需要在漫游时激活数据上下文时返回，但国际漫游已禁用。
适用于iOS 3.0及更高版本。
在NSURLError.h中声明。
42. NSURLErrorCallIsActive
当在不支持同时进行电话和数据通信（EDGE或GPRS）的网络上打电话时尝试进行连接时返回。
适用于iOS 3.0及更高版本。
在NSURLError.h中声明。
43. NSURLErrorDataNotAllowed
当蜂窝网络不允许连接时返回。
适用于iOS 3.0及更高版本。
在NSURLError.h中声明。
44. NSURLErrorRequestBodyStreamExhausted
当需要正文流但客户端不提供正文流时返回。 这会影响使用正文流发送POST请求的iOS客户端，但不会实现NSURLConnection代理方法连接：needNewBodyStream。
适用于iOS 3.0及更高版本。
在NSURLError.h中声明。
45. NSURLErrorBackgroundSessionRequiresSharedContainer
46. NSURLErrorBackgroundSessionInUseByAnotherProcess
47. NSURLErrorBackgroundSessionWasDisconnected
关于NSURLErrorDomain的使用
NSURLErrorDomain的使用就是用来根据不同的错误码提示，找到对应问题的原因，最终还是落实到问题的解决上，所以本篇文章只是对错误码的了解，真正最后的作用是根据不同的错误码可以快速定位问题所在，解决问题。
大家可以看一个阿里关于错误码处理的文集 —— NSURLErrorDomain，里面是不同框架不同情况的错误码提示以及相关的解决方法。
参考文章
1. NSError code错误列表信息(NSFileManage、NSURL...)
2. iOS中的NSError code（错误码）
后记
本篇主要介绍URL加载系统的错误码及其相关作用，感兴趣的给点赞或者关注~~~~
