自定义异常类需要遵循哪些规则

自定义异常类在编程中是一种常见的做法，它可以帮助我们更好地处理特定于应用程序的错误情况。以下是自定义异常类通常需要遵循的一些规则：

1. 继承自标准异常类

• Python: 继承自 Exception 类或其子类。
• Java: 继承自 Exception 类或其子类。
• C#: 继承自 Exception 类或其子类。

2. 提供有意义的构造函数

• 至少提供一个接受错误消息的构造函数。
• 可以提供额外的构造函数来接受其他参数，如错误代码、原始异常等。

3. 包含错误消息

• 提供一个清晰的错误消息，描述异常发生的原因。

4. 可选：添加额外的属性

• 根据需要添加额外的属性来存储与异常相关的额外信息。

5. 重写 __str__ 或 toString 方法

• 在 Python 中，重写 __str__ 方法以返回友好的错误消息。
• 在 Java 和 C# 中，重写 toString 方法以返回友好的错误消息。

6. 文档化异常类

• 提供详细的文档，说明异常类的用途、何时抛出以及如何处理。

示例

Python

class CustomError(Exception):
    def __init__(self, message, error_code=None):
        super().__init__(message)
        self.error_code = error_code

    def __str__(self):
        return f"{self.args[0]} (Error Code: {self.error_code})"

# 使用示例
try:
    raise CustomError("Something went wrong", error_code=404)
except CustomError as e:
    print(e)  # 输出: Something went wrong (Error Code: 404)

Java

public class CustomException extends Exception {
    private int errorCode;

    public CustomException(String message, int errorCode) {
        super(message);
        this.errorCode = errorCode;
    }

    public int getErrorCode() {
        return errorCode;
    }

    @Override
    public String toString() {
        return super.getMessage() + " (Error Code: " + errorCode + ")";
    }
}

// 使用示例
try {
    throw new CustomException("Something went wrong", 404);
} catch (CustomException e) {
    System.out.println(e);  // 输出: Something went wrong (Error Code: 404)
}

C#

using System;

public class CustomException : Exception
{
    public int ErrorCode { get; }

    public CustomException(string message, int errorCode)
        : base(message)
    {
        ErrorCode = errorCode;
    }

    public override string ToString()
    {
        return $"{Message} (Error Code: {ErrorCode})";
    }
}

// 使用示例
try
{
    throw new CustomException("Something went wrong", 404);
}
catch (CustomException e)
{
    Console.WriteLine(e);  // 输出: Something went wrong (Error Code: 404)
}

通过遵循这些规则，你可以创建出清晰、易于理解和维护的自定义异常类。