26 错误处理之自定义错误类型

在上章中，我们讨论了 Swift 中的错误处理方法，以及如何有效地捕获和处理错误。当我们在编程中遇到问题时，使用系统提供的错误类型虽然方便，但是在许多情况下，创建自定义错误类型会让我们的代码更加清晰和易于维护。接下来，我们将详细介绍如何在 Swift 中定义和使用自定义错误类型。

自定义错误类型的定义

在 Swift 中，自定义错误类型通常通过遵循 Error 协议来实现。 Error 协议本身并不需要我们实现任何方法或属性，因此只需声明一个简单的枚举或类即可。

使用枚举定义错误

以下是一个简单的自定义错误类型的示例：

enum NetworkError: Error {
    case badURL
    case timeout
    case notConnected
}

在这个示例中，我们定义了一个名为 NetworkError 的枚举，用于表示网络请求中的不同错误情况。

使用类定义错误

如果需要更复杂的错误信息，可以使用类来定义错误：

class FileError: Error {
    var code: Int
    var description: String

    init(code: Int, description: String) {
        self.code = code
        self.description = description
    }
}

在这里，我们创建了一个 FileError 类，它包含了一个错误代码和错误描述，以提供更多的上下文信息。

使用自定义错误类型

自定义错误类型定义好之后，我们就可以在函数中抛出这些错误。在函数内部，可以使用 throw 关键字来抛出自定义的错误。例如：

func fetchData(from url: String) throws {
    guard let _ = URL(string: url) else {
        throw NetworkError.badURL
    }
    // 其他代码...
}

在这个 fetchData 函数中，如果给定的 url 不能转换为有效的 URL，我们将抛出 NetworkError.badURL 错误。

捕获自定义错误

当我们调用可能抛出错误的函数时，需要使用 do-catch 语句处理错误。以下是如何处理自定义错误的示例：

do {
    try fetchData(from: "invalid-url")
} catch NetworkError.badURL {
    print("发生错误：无效的 URL")
} catch NetworkError.timeout {
    print("发生错误：请求超时")
} catch NetworkError.notConnected {
    print("发生错误：未连接到网络")
} catch {
    print("发生未知错误")
}

在这个示例中，我们在调用 fetchData 函数时，使用了 do-catch 语句来捕获并处理可能出现的 NetworkError 错误。通过这样的方式，我们可以根据不同的错误类型提供相应的处理逻辑。

结合错误信息

如果采用类的方式来定义错误，我们可以在抛出错误时提供更多信息，例如：

func readFile(at path: String) throws {
    // 模拟文件读取错误
    throw FileError(code: 404, description: "File not found at \(path)")
}

do {
    try readFile(at: "/path/to/file.txt")
} catch let error as FileError {
    print("错误代码：\(error.code)，描述：\(error.description)")
}

在上面的示例中，我们创建了一个模拟的 readFile 函数，尝试读取一个文件并抛出 FileError。在 catch 块中，我们将捕获到的错误作为 FileError 进行处理，以便获取具体的错误代码和描述。

结论

通过自定义错误类型，我们能够为程序中的错误处理提供更多的灵活性和可读性。在本章中，我们探讨了如何定义自定义错误，如何使用 throw 抛出错误，以及如何使用 do-catch 语句捕获并处理这些错误。在下一章中，我们将深入研究协议和扩展，首先了解协议的定义与用法。