一、NSError是系统错误信息类
两种初始化方法：其中，domain 不能为空 dict可以为空
- (instancetype)initWithDomain:(NSErrorDomain)domain code:(NSInteger)code userInfo:(nullable NSDictionary *)dict;
+ (instancetype)errorWithDomain:(NSErrorDomain)domain code:(NSInteger)code userInfo:(nullable NSDictionary *)dict;
@property (readonly, copy) NSErrorDomain domain;//错误域
错误域主要有四个，对于Carbon框架的Error，归于OSStatus domain（NSOSStatusErrorDomain），对于POSIX error，归于NSPOSIXErrorDomain，而对于我们的iOS开发，一般使用NSCocoaErrorDomain。NSError.h定义了四个domain
{
// Predefined domain for errors from most AppKit and Foundation APIs.
FOUNDATION_EXPORT NSErrorDomain const NSCocoaErrorDomain;
// Other predefined domains; value of "code" will correspond to preexisting values in these domains.
FOUNDATION_EXPORT NSErrorDomain const NSPOSIXErrorDomain;
FOUNDATION_EXPORT NSErrorDomain const NSOSStatusErrorDomain;
FOUNDATION_EXPORT NSErrorDomain const NSMachErrorDomain;
}
@property (readonly) NSInteger code;//错误代码
@property (readonly, copy) NSDictionary *userInfo;//错误信息
@property (readonly, copy) NSString *localizedDescription;//获取本地化描述
@property (nullable, readonly, copy) NSString *localizedFailureReason;//获取失败原因
@property (nullable, readonly, copy) NSString *localizedRecoverySuggestion;//获取恢复建议
@property (nullable, readonly, copy) NSArray<NSString *> *localizedRecoveryOptions;本地恢复建议
@property (nullable, readonly, strong) id recoveryAttempter;
@property (nullable, readonly, copy) NSString *helpAnchor;
预定义的userinfo键名
NSString *const NSUnderlyingErrorKey;//推荐的标准方式，通用键
NSString *const NSLocalizedDescriptionKey; // 详细描述键
NSString *const NSLocalizedFailureReasonErrorKey; // 失败原因键
NSString *const NSLocalizedRecoverySuggestionErrorKey; //恢复建议键
NSString *const NSLocalizedRecoveryOptionsErrorKey; // 恢复选项键
其他键
NSString *const NSRecoveryAttempterErrorKey;
NSString *const NSHelpAnchorErrorKey;
NSString *const NSStringEncodingErrorKey ;
NSString *const NSURLErrorKey;
NSString *const NSFilePathErrorKey;
用法示例：
NSDictionary *userInfo1 = [NSDictionary dictionaryWithObjectsAndKeys:@"由于文件不存在，无法打开", NSLocalizedDescriptionKey, @"失败原因：文件不存在", NSLocalizedFailureReasonErrorKey, @"恢复建议：请创建该文件",NSLocalizedRecoverySuggestionErrorKey,nil];
NSError *error = [[NSError alloc] initWithDomain:NSCocoaErrorDomain code:4 userInfo:userInfo1];//此处code是4，对照下面对照表4代表文件不存在。userinfo传userinfo1 查看自定义打印。userinfo传nil，查看本地化描述。
NSLog(@"========%@",[error localizedDescription]);
NSLog(@"========%@",[error localizedFailureReason]);
NSLog(@"========%@",[error localizedRecoverySuggestion]);
二、NSError错误code对照表
Foundation Constants Reference
NSError codes in the Cocoa error domain.
enum {
NSFileNoSuchFileError = 4,
NSFileLockingError = 255,
NSFileReadUnknownError = 256,
NSFileReadNoPermissionError = 257,
NSFileReadInvalidFileNameError = 258,
NSFileReadCorruptFileError = 259,
NSFileReadNoSuchFileError = 260,
NSFileReadInapplicableStringEncodingError = 261,
NSFileReadUnsupportedSchemeError = 262,
NSFileReadTooLargeError = 263,
NSFileReadUnknownStringEncodingError = 264,
NSFileWriteUnknownError = 512,
NSFileWriteNoPermissionError = 513,
NSFileWriteInvalidFileNameError = 514,
NSFileWriteInapplicableStringEncodingError = 517,
NSFileWriteUnsupportedSchemeError = 518,
NSFileWriteOutOfSpaceError = 640,
NSFileWriteVolumeReadOnlyError = 642m
NSKeyValueValidationError = 1024,
NSFormattingError = 2048,
NSUserCancelledError = 3072,
NSFileErrorMinimum = 0,
NSFileErrorMaximum = 1023,
NSValidationErrorMinimum = 1024,
NSValidationErrorMaximum = 2047,
NSFormattingErrorMinimum = 2048,
NSFormattingErrorMaximum = 2559,
NSPropertyListReadCorruptError = 3840,
NSPropertyListReadUnknownVersionError = 3841,
NSPropertyListReadStreamError = 3842,
NSPropertyListWriteStreamError = 3851,
NSPropertyListErrorMinimum = 3840,
NSPropertyListErrorMaximum = 4095
NSExecutableErrorMinimum = 3584,
NSExecutableNotLoadableError = 3584,
NSExecutableArchitectureMismatchError = 3585,
NSExecutableRuntimeMismatchError = 3586,
NSExecutableLoadError = 3587,
NSExecutableLinkError = 3588,
NSExecutableErrorMaximum = 3839,
}
URL Loading System Error Codes
These values are returned as the error code property of an NSError object with the domain “NSURLErrorDomain”.
typedef enum
{
NSURLErrorUnknown = -1,
NSURLErrorCancelled = -999,
NSURLErrorBadURL = -1000,
NSURLErrorTimedOut = -1001,
NSURLErrorUnsupportedURL = -1002,
NSURLErrorCannotFindHost = -1003,
NSURLErrorCannotConnectToHost = -1004,
NSURLErrorDataLengthExceedsMaximum = -1103,
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,
NSURLErrorFileDoesNotExist = -1100,
NSURLErrorFileIsDirectory = -1101,
NSURLErrorNoPermissionsToReadFile = -1102,
NSURLErrorSecureConnectionFailed = -1200,
NSURLErrorServerCertificateHasBadDate = -1201,
NSURLErrorServerCertificateUntrusted = -1202,
NSURLErrorServerCertificateHasUnknownRoot = -1203,
NSURLErrorServerCertificateNotYetValid = -1204,
NSURLErrorClientCertificateRejected = -1205,
NSURLErrorClientCertificateRequired = -1206,
NSURLErrorCannotLoadFromNetwork = -2000,
NSURLErrorCannotCreateFile = -3000,
NSURLErrorCannotOpenFile = -3001,
NSURLErrorCannotCloseFile = -3002,
NSURLErrorCannotWriteToFile = -3003,
NSURLErrorCannotRemoveFile = -3004,
NSURLErrorCannotMoveFile = -3005,
NSURLErrorDownloadDecodingFailedMidStream = -3006,
NSURLErrorDownloadDecodingFailedToComplete = -3007
}
-1（未知的错误）
-999（请求被取消）
-1000（请求的URL错误，无法启动请求）
-1001（请求超时）
-1002（不支持的URL Scheme）
-1003（URL的host名称无法解析，即DNS有问题）
-1004（连接host失败）
-1005（连接过程中被中断）
-1006（同- -1003）
-1007（重定向次数超过限制）
-1008（无法获取所请求的资源）
-1009（断网状态）
-1010（重定向到一个不存在的位置）
-1011（服务器返回数据有误）
-1012（身份验证请求被用户取消）
-1013（访问资源需要身份验证）
-1014（服务器报告URL数据不为空，却未返回任何数据）
-1015（响应数据无法解码为已知内容编码）
-1016（请求数据存在未知内容编码）
-1017（响应数据无法解析）
-1018（漫游时请求数据，但是漫游开关已关闭）
-1019（EDGE、GPRS等网络不支持电话和流量同时进行，当正在通话过程中，请求失败错误码）
-1020（手机网络不允许连接）
-1021（请求的body流被耗尽）
-1100（请求的文件路径上文件不存在）
-1101（请求的文件只是一个目录，而非文件）
-1102（缺少权限无法读取文件）
-1103（资源数据大小超过最大限制）
// SSL errors
-1200（安全连接失败）
-1201（服务器证书过期）
-1202（不受信任的根服务器签名证书）
-1203（服务器证书没有任何根服务器签名）
-1204（服务器证书还未生效）
-1205（服务器证书被拒绝）
-1206（需要客户端证书来验证SSL连接）
-2000（请求只能加载缓存中的数据，无法加载网络数据）
// Download and file I/O errors
-3000（下载操作无法创建文件）
-3001（下载操作无法打开文件）
-3002（下载操作无法关闭文件）
-3003（下载操作无法写文件）
-3004（下载操作无法删除文件）
-3005（下载操作无法移动文件）
-3006（下载操作在下载过程中，对编码文件进行解码时失败）
-3007（下载操作在下载完成后，对编码文件进行解码时失败）
网友评论