其它异常封装

简介

在开发过程中，异常处理是不可避免的。在 Hutool 工具库中，为了应对常见的异常场景，封装了一些自定义异常类，这些异常类帮助开发者更明确地表达错误语义，并且方便捕获和处理特定类型的异常。

1. 异常类介绍

1.1 DependencyException - 依赖异常

DependencyException 表示在系统运行时依赖的某些组件、服务或模块未满足要求时抛出的异常，常见于模块加载或初始化失败等场景。

示例：抛出依赖异常

import cn.hutool.core.exceptions.DependencyException;

public class DependencyExceptionExample {
    public static void main(String[] args) {
        try {
            // 模拟依赖未满足的场景
            throw new DependencyException("依赖模块未加载");
        } catch (DependencyException e) {
            System.out.println("捕获依赖异常: " + e.getMessage());
        }
    }
}

• 使用场景：在模块化开发中，当某个模块未加载或依赖的组件不可用时，可以抛出该异常来提示调用方进行处理。

1.2 StatefulException - 带有状态码的异常

StatefulException 是一种包含状态码的异常，适用于需要携带错误状态或错误代码的场景，例如接口调用失败时返回错误码。

示例：抛出带状态码的异常

import cn.hutool.core.exceptions.StatefulException;

public class StatefulExceptionExample {
    public static void main(String[] args) {
        try {
            // 模拟状态码错误
            throw new StatefulException(404, "资源未找到");
        } catch (StatefulException e) {
            System.out.println("错误状态码: " + e.getStatus());
            System.out.println("错误信息: " + e.getMessage());
        }
    }
}

• 方法签名：
  • public StatefulException(int status, String message)：构造包含状态码和错误信息的异常。
• 参数说明：
  • status: 错误状态码。
  • message: 错误描述信息。
• 使用场景：适用于需要抛出携带状态码的异常，例如 REST 接口的异常处理。

1.3 UtilException - 工具类异常

UtilException 是 Hutool 中常见的工具类异常，通常在工具类方法操作失败时抛出，例如文件操作失败、转换失败等场景。

示例：抛出工具类异常

import cn.hutool.core.exceptions.UtilException;

public class UtilExceptionExample {
    public static void main(String[] args) {
        try {
            // 模拟工具类操作失败
            throw new UtilException("工具类操作失败");
        } catch (UtilException e) {
            System.out.println("捕获工具类异常: " + e.getMessage());
        }
    }
}

• 使用场景：在开发自定义工具类时，遇到操作失败的情况，可以抛出 UtilException，以标识该操作属于工具类异常。

1.4 NotInitedException - 未初始化异常

NotInitedException 表示某些资源或模块在调用前未正确初始化时抛出的异常。例如，单例模式下未初始化的实例在调用前被使用时，可以抛出该异常。

示例：抛出未初始化异常

import cn.hutool.core.exceptions.NotInitedException;

public class NotInitedExceptionExample {
    public static void main(String[] args) {
        try {
            // 模拟未初始化错误
            throw new NotInitedException("模块未初始化");
        } catch (NotInitedException e) {
            System.out.println("捕获未初始化异常: " + e.getMessage());
        }
    }
}

• 使用场景：在模块或资源未初始化前被错误调用时，可以抛出该异常提示开发者进行初始化操作。

1.5 ValidateException - 验证异常

ValidateException 表示数据验证失败时抛出的异常，通常用于参数校验或数据一致性检查。

示例：抛出验证异常

import cn.hutool.core.exceptions.ValidateException;

public class ValidateExceptionExample {
    public static void main(String[] args) {
        try {
            // 模拟数据验证失败
            throw new ValidateException("数据验证不通过");
        } catch (ValidateException e) {
            System.out.println("捕获验证异常: " + e.getMessage());
        }
    }
}

• 使用场景：在数据验证失败时，可以抛出 ValidateException，例如表单校验、用户输入校验等场景。

2. 实际应用场景

• 模块依赖管理：在系统中有多个模块或组件相互依赖时，使用 DependencyException 可以帮助提示未满足的依赖条件。
• 接口状态管理：在接口调用中，使用 StatefulException 可以携带状态码，帮助调用方快速定位问题。
• 工具类开发：在自定义工具类开发中，UtilException 是一种通用的异常封装，便于统一异常处理。
• 初始化检查：在需要确保资源或模块初始化的场景下，使用 NotInitedException 可以防止未初始化的错误操作。
• 数据验证：在表单校验或数据一致性检查中，使用 ValidateException 可以更加明确地标识验证失败的原因。

3. 注意事项

• 使用这些自定义异常时，确保异常信息足够清晰，帮助开发者或调用方快速定位问题。
• 在大型项目中，可以基于这些基础异常类进行扩展，满足更复杂的业务需求。