Java 异常及解决方案系列（十二）：深入探讨自定义异常

在前面的文章中，我们探讨了Java异常处理的各种方面，包括基本概念、最佳实践、高级技巧、事务管理与安全性等。本篇文章将深入探讨自定义异常，帮助你在实际开发中更好地定义和使用自定义异常，提高代码的可读性和维护性。

一、为什么需要自定义异常？

自定义异常有助于更清晰地表达业务逻辑中的错误情况，提供更详细和有意义的错误信息。以下是一些使用自定义异常的场景：

特定业务逻辑：标准异常无法准确描述某些业务逻辑中的错误。
更好的错误信息：自定义异常可以提供更详细和上下文相关的错误信息。
分类处理：通过自定义异常，可以更方便地对不同类型的错误进行分类处理。

二、自定义异常的基本步骤

1. 创建基础异常类

基础异常类可以继承 Exception 或 RuntimeException，并提供基本的构造方法。

示例代码：

public class BaseException extends Exception {
    private int errorCode;

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

    public BaseException(String message, int errorCode, Throwable cause) {
        super(message, cause);
        this.errorCode = errorCode;
    }

    public int getErrorCode() {
        return errorCode;
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

2. 创建具体异常类

根据具体业务需求，创建继承自基础异常类的具体异常类。

示例代码：

public class UserNotFoundException extends BaseException {
    public UserNotFoundException(String message) {
        super(message, 404);
    }

    public UserNotFoundException(String message, Throwable cause) {
        super(message, 404, cause);
    }
}

public class InvalidInputException extends BaseException {
    public InvalidInputException(String message) {
        super(message, 400);
    }

    public InvalidInputException(String message, Throwable cause) {
        super(message, 400, cause);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

三、自定义异常的使用场景

1. 用户输入验证

在处理用户输入时，使用自定义异常可以更清晰地表达输入验证中的错误情况。

示例代码：

public class UserService {
    public void validateUserInput(String input) throws InvalidInputException {
        if (input == null || input.isEmpty()) {
            throw new InvalidInputException("用户输入无效：输入不能为空");
        }
        // 其他验证逻辑
    }
}
1
2
3
4
5
6
7
8

2. 数据库操作

在数据库操作中，使用自定义异常可以提供更详细的错误信息，便于调试和维护。

示例代码：

public class UserRepository {
    public User findUserById(int id) throws UserNotFoundException {
        // 模拟数据库操作
        if (id == 0) {
            throw new UserNotFoundException("用户未找到，ID：" + id);
        }
        return new User(id, "John Doe");
    }
}
1
2
3
4
5
6
7
8
9

3. 业务逻辑处理

在复杂的业务逻辑处理中，使用自定义异常可以更好地管理和处理不同类型的错误。

示例代码：

public class OrderService {
    public void processOrder(Order order) throws InvalidInputException, UserNotFoundException {
        if (order == null) {
            throw new InvalidInputException("订单不能为空");
        }
        User user = userRepository.findUserById(order.getUserId());
        if (user == null) {
            throw new UserNotFoundException("用户未找到，ID：" + order.getUserId());
        }
        // 处理订单的其他逻辑
    }

    private UserRepository userRepository = new UserRepository();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

四、自定义异常的最佳实践

1. 提供有意义的错误信息

自定义异常应提供详细、有意义的错误信息，便于问题的快速定位和解决。

2. 使用异常链

在抛出自定义异常时，使用异常链（Throwable cause）保留原始异常信息，便于调试和排查问题。

示例代码：

public class OrderService {
    public void processOrder(Order order) throws InvalidInputException, UserNotFoundException {
        try {
            if (order == null) {
                throw new InvalidInputException("订单不能为空");
            }
            User user = userRepository.findUserById(order.getUserId());
            if (user == null) {
                throw new UserNotFoundException("用户未找到，ID：" + order.getUserId());
            }
            // 处理订单的其他逻辑
        } catch (SQLException e) {
            throw new UserNotFoundException("用户查询失败，ID：" + order.getUserId(), e);
        }
    }

    private UserRepository userRepository = new UserRepository();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

3. 分类管理异常

根据业务逻辑将异常进行分类管理，使代码结构更清晰，异常处理更有条理。

示例代码：

public class ServiceException extends BaseException {
    public ServiceException(String message, int errorCode) {
        super(message, errorCode);
    }

    public ServiceException(String message, int errorCode, Throwable cause) {
        super(message, errorCode, cause);
    }
}

public class DatabaseException extends BaseException {
    public DatabaseException(String message, int errorCode) {
        super(message, errorCode);
    }

    public DatabaseException(String message, int errorCode, Throwable cause) {
        super(message, errorCode, cause);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

4. 全局异常处理

在Web应用中，使用全局异常处理器统一处理自定义异常，提高代码的可维护性。

示例代码（Spring Boot 全局异常处理器）：

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.*;

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(BaseException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public ErrorResponse handleBaseException(BaseException e) {
        return new ErrorResponse(e.getErrorCode(), e.getMessage());
    }

    @ExceptionHandler(Exception.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public ErrorResponse handleException(Exception e) {
        return new ErrorResponse(500, "服务器内部错误：" + e.getMessage());
    }
}

class ErrorResponse {
    private int code;
    private String message;

    public ErrorResponse(int code, String message) {
        this.code = code;
        this.message = message;
    }

    // getters and setters
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29