วิธีการให้คำอธิบายที่มีการแปลประเภทข้อผิดพลาดใน Swift?


202

ฉันกำลังกำหนดประเภทข้อผิดพลาดที่กำหนดเองด้วยไวยากรณ์ Swift 3 และฉันต้องการให้คำอธิบายที่เป็นมิตรกับผู้ใช้ของข้อผิดพลาดที่ส่งคืนโดยlocalizedDescriptionคุณสมบัติของErrorวัตถุ ฉันจะทำมันได้อย่างไร

public enum MyError: Error {
  case customError

  var localizedDescription: String {
    switch self {
    case .customError:
      return NSLocalizedString("A user-friendly description of the error.", comment: "My error")
    }
  }
}

let error: Error = MyError.customError
error.localizedDescription
// "The operation couldn’t be completed. (MyError error 0.)"

มีวิธีที่localizedDescriptionจะส่งคืนคำอธิบายข้อผิดพลาดที่กำหนดเองของฉันหรือไม่ ("คำอธิบายที่เป็นมิตรกับผู้ใช้ของข้อผิดพลาด")? โปรดทราบว่าวัตถุข้อผิดพลาดที่นี่เป็นประเภทและไม่ได้Error MyErrorแน่นอนฉันสามารถโยนวัตถุไปยัง MyError ได้

(error as? MyError)?.localizedDescription

แต่มีวิธีที่จะทำให้มันทำงานโดยไม่ชี้ไปที่ประเภทข้อผิดพลาดของฉันหรือไม่?

คำตอบ:


402

ตามที่อธิบายไว้ในบันทึกประจำรุ่นของ Xcode 8 beta 6

ประเภทข้อผิดพลาดที่กำหนดโดย Swift สามารถให้คำอธิบายข้อผิดพลาดที่แปลเป็นภาษาท้องถิ่นโดยใช้โปรโตคอล LocalizedError ใหม่

ในกรณีของคุณ:

public enum MyError: Error {
    case customError
}

extension MyError: LocalizedError {
    public var errorDescription: String? {
        switch self {
        case .customError:
            return NSLocalizedString("A user-friendly description of the error.", comment: "My error")
        }
    }
}

let error: Error = MyError.customError
print(error.localizedDescription) // A user-friendly description of the error.

คุณสามารถให้ข้อมูลเพิ่มเติมได้หากข้อผิดพลาดถูกแปลงเป็นNSError(ซึ่งเป็นไปได้เสมอ):

extension MyError : LocalizedError {
    public var errorDescription: String? {
        switch self {
        case .customError:
            return NSLocalizedString("I failed.", comment: "")
        }
    }
    public var failureReason: String? {
        switch self {
        case .customError:
            return NSLocalizedString("I don't know why.", comment: "")
        }
    }
    public var recoverySuggestion: String? {
        switch self {
        case .customError:
            return NSLocalizedString("Switch it off and on again.", comment: "")
        }
    }
}

let error = MyError.customError as NSError
print(error.localizedDescription)        // I failed.
print(error.localizedFailureReason)      // Optional("I don\'t know why.")
print(error.localizedRecoverySuggestion) // Optional("Switch it off and on again.")

โดยการใช้CustomNSErrorโปรโตคอลข้อผิดพลาดสามารถให้userInfoพจนานุกรม (และยังdomainและcode) ตัวอย่าง:

extension MyError: CustomNSError {

    public static var errorDomain: String {
        return "myDomain"
    }

    public var errorCode: Int {
        switch self {
        case .customError:
            return 999
        }
    }

    public var errorUserInfo: [String : Any] {
        switch self {
        case .customError:
            return [ "line": 13]
        }
    }
}

let error = MyError.customError as NSError

if let line = error.userInfo["line"] as? Int {
    print("Error in line", line) // Error in line 13
}

print(error.code) // 999
print(error.domain) // myDomain

7
มีเหตุผลว่าทำไมคุณทำให้แรกและขยายด้วย ในภายหลังหรือไม่ มีความแตกต่างถ้าคุณทำให้มันเป็นครั้งแรก? MyErrorErrorLocalizedErrorLocalizedError
Gee.E

9
@ Gee.E: มันไม่ได้สร้างความแตกต่าง มันเป็นเพียงวิธีการจัดระเบียบรหัส (หนึ่งส่วนขยายสำหรับแต่ละโปรโตคอล) เปรียบเทียบstackoverflow.com/questions/36263892/... , stackoverflow.com/questions/40502086/...หรือnatashatherobot.com/using-swift-extensions
Martin R

4
อ่าตรวจสอบ ฉันได้รับสิ่งที่คุณพูดตอนนี้ ส่วน "ความสอดคล้องของโปรโตคอล" ในnatashatherobot.com/using-swift-extensionsย่อมเป็นตัวอย่างที่ดีของความหมายของคุณ ขอบคุณ!
Gee.E

1
@MartinR หากข้อผิดพลาดของฉันจะถูกแปลงเป็น NSError ฉันจะส่งพจนานุกรมจากข้อผิดพลาดที่สามารถเข้าถึงได้เป็น userInfo ของ NSError อย่างไร
BangOperator

18
ระวังจะพิมพ์แทนvar errorDescription: String? Stringมีข้อบกพร่องในการใช้งาน LocalizedError ดูSR-5858
ethanhuang13

35

ฉันจะเพิ่มถ้าข้อผิดพลาดของคุณมีพารามิเตอร์เช่นนี้

enum NetworkError: LocalizedError {
  case responseStatusError(status: Int, message: String)
}

คุณสามารถเรียกพารามิเตอร์เหล่านี้ในคำอธิบายที่แปลเป็นภาษาท้องถิ่นของคุณเช่นนี้:

extension NetworkError {
  public var errorDescription: String? {
    switch self {
    case .responseStatusError(status: let status, message: let message):
      return "Error with status \(status) and message \(message) was thrown"
  }
}

คุณสามารถทำให้สั้นลงเช่นนี้:

extension NetworkError {
  public var errorDescription: String? {
    switch self {
    case let .responseStatusError(status, message):
      return "Error with status \(status) and message \(message) was thrown"
  }
}

4

ขณะนี้มีสองข้อผิดพลาดที่ใช้โปรโตคอลที่ประเภทข้อผิดพลาดของคุณสามารถนำมาใช้เพื่อให้ข้อมูลเพิ่มเติมกับ Objective-C - LocalizedError และ CustomNSError นี่คือตัวอย่างข้อผิดพลาดที่ใช้ทั้งคู่:

enum MyBetterError : CustomNSError, LocalizedError {
    case oops

    // domain
    static var errorDomain : String { return "MyDomain" }
    // code
    var errorCode : Int { return -666 }
    // userInfo
    var errorUserInfo: [String : Any] { return ["Hey":"Ho"] };

    // localizedDescription
    var errorDescription: String? { return "This sucks" }
    // localizedFailureReason
    var failureReason: String? { return "Because it sucks" }
    // localizedRecoverySuggestion
    var recoverySuggestion: String? { return "Give up" }

}

2
คุณสามารถแก้ไขได้หรือไม่? ตัวอย่างของคุณไม่ได้ช่วยอะไรมากนักในการทำความเข้าใจคุณค่าของแต่ละคน หรือเพียงแค่ลบมันเพราะคำตอบ MartinR ให้บริการตรงนี้ ...
น้ำผึ้ง

3

การใช้ struct สามารถเป็นทางเลือก ความสง่างามเล็กน้อยพร้อมการแปลแบบคงที่:

import Foundation

struct MyError: LocalizedError, Equatable {

   private var description: String!

   init(description: String) {
       self.description = description
   }

   var errorDescription: String? {
       return description
   }

   public static func ==(lhs: MyError, rhs: MyError) -> Bool {
       return lhs.description == rhs.description
   }
}

extension MyError {

   static let noConnection = MyError(description: NSLocalizedString("No internet connection",comment: ""))
   static let requestFailed = MyError(description: NSLocalizedString("Request failed",comment: ""))
}

func throwNoConnectionError() throws {
   throw MyError.noConnection
}

do {
   try throwNoConnectionError()
}
catch let myError as MyError {
   switch myError {
   case .noConnection:
       print("noConnection: \(myError.localizedDescription)")
   case .requestFailed:
       print("requestFailed: \(myError.localizedDescription)")
   default:
      print("default: \(myError.localizedDescription)")
   }
}

0

นี่คือทางออกที่หรูหรามากขึ้น:

  enum ApiError: String, LocalizedError {

    case invalidCredentials = "Invalid credentials"
    case noConnection = "No connection"

    var localizedDescription: String { return NSLocalizedString(self.rawValue, comment: "") }

  }

4
สิ่งนี้อาจดูสง่างามกว่าตอนรันไทม์ แต่ขั้นตอนการแปลแบบสแตติกจะไม่สามารถแยกสตริงเหล่านี้สำหรับนักแปล คุณจะเห็น"Bad entry in file – Argument is not a literal string"ข้อผิดพลาดเมื่อคุณเรียกใช้exportLocalizationsหรือgenstringsสร้างรายการข้อความที่แปลได้
savinola

@savinola เห็นด้วยการแปลคงที่จะไม่ทำงานในกรณีดังกล่าว บางทีการใช้switch + caseเป็นเพียงตัวเลือกเท่านั้น ...
Vitaliy Gozhenko

การใช้ค่า raw จะป้องกันการใช้ค่าที่เกี่ยวข้องสำหรับข้อผิดพลาดของคุณ
Brody Robertson
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.