Java 如何优雅的抛出业务异常

Java 抛出业务异常是我们在日常开发中难免会遇到的问题，如何优雅的抛出业务异常已成为现代开发者必须掌握的技能之一。接下来，我将详细讲解 Java 如何优雅的抛出业务异常的完整攻略。

1. 异常的定义

在 Java 中，可以通过继承 Exception 或者 RuntimeException 来定义自己的业务异常。一般来说，Exception 异常适用于业务不可控的情况，如网络异常，数据库连接异常等；而 RuntimeException 异常适用于业务异常，如权限异常、参数异常、状态异常等。

通常，一个优秀的业务异常应该包括以下信息：

1. 错误码
2. 错误信息
3. 错误数据

2. 异常的抛出

在 Java 中，我们可以使用 throw 关键字来抛出异常。如果抛出的异常是继承了 Exception 类，则该异常必须被 catch 住，否则程序将无法编译通过；如果抛出的异常是继承了 RuntimeException 类，则该异常可以不被 catch 住，在程序运行时抛出异常。

一个简单的抛出业务异常的示例：

public class BusinessException extends RuntimeException {
    private String code;
    private String message;
    private Object data;

    public BusinessException(String code, String message, Object data) {
        this.code = code;
        this.message = message;
        this.data = data;
    }

    // 省略 getter、setter 方法

    public static void check(boolean condition, String code, String message, Object data) {
        if (!condition) {
            throw new BusinessException(code, message, data);
        }
    }
}

在上述代码中，我们定义了一个 BusinessException 类，它继承了 RuntimeException 类，并包含了错误码、错误信息、错误数据三个属性。可以看到，在 BusinessException 类中，我们提供了一个静态方法 check，如果判断条件不成立，则抛出 BusinessException 异常。

3. 异常的处理

为了达到优雅的抛出业务异常的目的，我们需要对异常进行统一的处理。一般来说，我们可以通过拦截器、过滤器或者切面的方式来对异常进行统一处理。

一个常用的异常处理切面：

@Component
@Aspect
public class ExceptionHandler {
    @Pointcut("@annotation(com.example.annotation.ExceptionHandler)")
    public void exceptionPointCut() {}

    @Around("exceptionPointCut()")
    public Object handleException(ProceedingJoinPoint joinPoint) throws Throwable {
        Object result = null;
        try {
            result = joinPoint.proceed();
        } catch (BusinessException ex) {
            return handleBusinessException(ex);
        } catch (Exception ex) {
            return handleSystemException(ex);
        }
        return result;
    }

    private Object handleBusinessException(BusinessException ex) {
        // 处理业务异常
    }

    private Object handleSystemException(Exception ex) {
        // 处理系统异常
    }
}

在上述代码中，我们使用了 Spring AOP 的方式来实现异常处理切面。其中，我们使用了一个自定义注解 @ExceptionHandler 来标识需要被处理的方法，通过切点拦截到被标记的方法，将异常统一处理。

4. 示例说明

下面是一个具体的使用示例，假设我们需要检查一个用户是否有权限访问某个资源，如果用户没有权限，则需要抛出业务异常。

@RestController
public class UserController {
    @GetMapping("/user/{id}")
    @ExceptionHandler
    public Object getUserById(@PathVariable("id") Long id) {
        User user = userService.getUserById(id);
        BusinessException.check(user != null, "USER_NOT_EXIST", "用户不存在", id);
        BusinessException.check(user.getStatus() == UserStatus.NORMAL, "USER_IS_DISABLED", "用户状态异常", user);
        BusinessException.check(userService.hasPermission(user, Permission.READ), "USER_HAS_NOT_READ_PERMISSION", "用户没有读取权限", user);
        return user;
    }
}

在上述代码中，我们使用了 BusinessException.check 方法来判断条件是否成立，如果条件不成立，则抛出业务异常。在 getUserById 方法前面，我们添加了一个 @ExceptionHandler 注解，表示这个方法需要被异常处理切面所拦截。

总结

优雅地抛出业务异常是我们在日常开发中必须掌握的技能之一。通过本文的介绍，我们可以了解到如何定义一个优秀的业务异常、如何抛出业务异常以及如何统一处理业务异常。在实际开发中，我们应该根据具体情况来选择合适的方式来处理异常，达到优雅地抛出业务异常的目的。