// // CoreStoreError.swift // CoreStore // // Copyright © 2014 John Rommel Estropia // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in all // copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE // SOFTWARE. // import Foundation import CoreData // MARK: - CoreStoreError public enum CoreStoreError: ErrorType, CustomStringConvertible, CustomDebugStringConvertible, Hashable { /** A failure occured because of an unknown error. */ case Unknown /** The `NSPersistentStore` could note be initialized because another store existed at the specified `NSURL`. */ case DifferentStorageExistsAtURL(existingPersistentStoreURL: NSURL) /** An `NSMappingModel` could not be found for a specific source and destination model versions. */ case MappingModelNotFound(localStoreURL: NSURL, targetModel: NSManagedObjectModel, targetModelVersion: String) /** Progressive migrations are disabled for a store, but an `NSMappingModel` could not be found for a specific source and destination model versions. */ case ProgressiveMigrationRequired(localStoreURL: NSURL) /** An internal SDK call failed with the specified `NSError`. */ case InternalError(NSError: NSError) // MARK: ErrorType public var _domain: String { return CoreStoreErrorDomain } public var _code: Int { switch self { case .Unknown: return CoreStoreErrorCode.UnknownError.rawValue case .DifferentStorageExistsAtURL: return CoreStoreErrorCode.DifferentPersistentStoreExistsAtURL.rawValue case .MappingModelNotFound: return CoreStoreErrorCode.MappingModelNotFound.rawValue case .ProgressiveMigrationRequired: return CoreStoreErrorCode.ProgressiveMigrationRequired.rawValue case .InternalError: return CoreStoreErrorCode.InternalError.rawValue } } // MARK: CustomStringConvertible public var description: String { // TODO: return self.bridgeToObjectiveC.description } // MARK: CustomDebugStringConvertible public var debugDescription: String { return self.description } // MARK: Hashable public var hashValue: Int { let code = self._code switch self { case .Unknown: return code.hashValue case .DifferentStorageExistsAtURL(let existingPersistentStoreURL): return code.hashValue ^ existingPersistentStoreURL.hashValue case .MappingModelNotFound(let localStoreURL, let targetModel, let targetModelVersion): return code.hashValue ^ localStoreURL.hashValue ^ targetModel.hashValue ^ targetModelVersion.hashValue case .ProgressiveMigrationRequired(let localStoreURL): return code.hashValue ^ localStoreURL.hashValue case .InternalError(let NSError): return code.hashValue ^ NSError.hashValue } } // MARK: Internal internal init(_ error: ErrorType?) { self = error.flatMap { $0.bridgeToSwift } ?? .Unknown } } // MARK: - CoreStoreError: Equatable @warn_unused_result public func == (lhs: CoreStoreError, rhs: CoreStoreError) -> Bool { switch (lhs, rhs) { case (.Unknown, .Unknown): return true case (.DifferentStorageExistsAtURL(let url1), .DifferentStorageExistsAtURL(let url2)): return url1 == url2 case (.MappingModelNotFound(let url1, let model1, let version1), .MappingModelNotFound(let url2, let model2, let version2)): return url1 == url2 && model1 == model2 && version1 == version2 case (.ProgressiveMigrationRequired(let url1), .ProgressiveMigrationRequired(let url2)): return url1 == url2 case (.InternalError(let NSError1), .InternalError(let NSError2)): return NSError1 == NSError2 default: return false } } // MARK: - CoreStoreErrorDomain /** The `NSError` error domain for `CoreStore`. */ @nonobjc public let CoreStoreErrorDomain = "com.corestore.error" // MARK: - CoreStoreErrorCode /** The `NSError` error codes for `CoreStoreErrorDomain`. */ public enum CoreStoreErrorCode: Int { /** A failure occured because of an unknown error. */ case UnknownError /** The `NSPersistentStore` could note be initialized because another store existed at the specified `NSURL`. */ case DifferentPersistentStoreExistsAtURL /** An `NSMappingModel` could not be found for a specific source and destination model versions. */ case MappingModelNotFound /** Progressive migrations are disabled for a store, but an `NSMappingModel` could not be found for a specific source and destination model versions. */ case ProgressiveMigrationRequired /** An internal SDK call failed with the specified "NSError" userInfo key. */ case InternalError } // MARK: - NSError public extension NSError { // MARK: Internal internal var isCoreDataMigrationError: Bool { let code = self.code return (code == NSPersistentStoreIncompatibleVersionHashError || code == NSMigrationMissingSourceModelError || code == NSMigrationError) && self.domain == NSCocoaErrorDomain } // MARK: Deprecated /** If the error's domain is equal to `CoreStoreErrorDomain`, returns the associated `CoreStoreErrorCode`. For other domains, returns `nil`. */ @available(*, deprecated=2.0.0, message="Use CoreStoreError enum values instead.") public var coreStoreErrorCode: CoreStoreErrorCode? { return (self.domain == CoreStoreErrorDomain ? CoreStoreErrorCode(rawValue: self.code) : nil) } }