在 java 中包装 sqlexception 的核心做法是捕获原始异常，将其作为参数传入自定义异常的构造函数，从而保留完整的堆栈信息。这样做既能让调用者通过 getcause() 获取底层 sql 错误细节，又能让上层业务逻辑统一处理自定义的异常类型。具体实现时，通常定义一个继承自 runtimeexception 或 exception 的业务异常类，并在 dao 层的方法中执行数据库操作。
如何定义支持链式调用的自定义异常类
直接回答：需要创建一个继承自 Exception 的类，并确保其构造函数正确调用父类构造函数以传递消息和原因对象。这样定义的异常类才能在使用 throw new MyException("msg", e) 时建立异常链。
package com.example.exception;
import java.sql.SQLException;
public class DataAccessException extends Exception {
public DataAccessException(String message) {
super(message);
}
public DataAccessException(String message, Throwable cause) {
super(message, cause);
}
}
上述代码展示了 DataAccessException 的定义。它提供了两个构造函数：一个仅接受消息，另一个同时接受消息和 Throwable 类型的 cause。当我们在 DAO 层捕获 SQLException 并抛出此异常时，应使用第二个构造函数，将原始的 SQLException 实例作为 cause 传入。这确保了异常链的完整性，使得后续可以通过 getCause() 方法获取原始的 SQL 错误信息，如错误码、SQL 状态等。
DAO 层如何捕获并转换 SQLException
直接回答：在 DAO 实现类的方法中，使用 try-catch 块包裹 JDBC 操作代码，catch 住 SQLException 后，抛出自定义异常实例，并将原异常作为原因传入。这样可以将受检异常转换为非受检异常（如果自定义异常继承自 RuntimeException）或统一的业务异常。
package com.example.dao;
import com.example.exception.DataAccessException;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.SQLException;
public class UserDao {
public void saveUser(Connection conn, String name) throws DataAccessException {
String sql = "INSERT INTO users (name) VALUES (?)";
try (PreparedStatement pstmt = conn.prepareStatement(sql)) {
pstmt.setString(1, name);
pstmt.executeUpdate();
} catch (SQLException e) {
throw new DataAccessException("Failed to save user: " + name, e);
}
}
}
在 UserDao 的 saveUser 方法中，我们首先定义了 SQL 语句并使用 try-with-resources 确保资源释放。接着，在 catch 块中捕获可能发生的 SQLException。这里的关键是将捕获到的 e 作为第二个参数传递给 DataAccessException 的构造函数。这样，当上层业务代码捕获 DataAccessException 时，可以通过 exception.getCause() 获得原始的 SQLException，从而进行更细致的错误处理或日志记录。这种模式避免了在业务层直接依赖 JDBC 特定的异常类型，提高了代码的可测试性和解耦程度。
如何处理包装后的异常中的 SQL 错误码
直接回答：在业务层或全局异常处理器中，通过 getCause() 获取原始的 SQLException 实例，然后调用其 getErrorCode() 或 getSQLState() 方法来提取具体的数据库错误信息。这使得我们可以根据具体的 SQL 错误码（如主键冲突、外键约束失败等）返回不同的 HTTP 状态码或用户提示。
package com.example.handler;
import com.example.exception.DataAccessException;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.sql.SQLException;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(DataAccessException.class)
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
public String handleDataAccessError(DataAccessException ex) {
Throwable cause = ex.getCause();
if (cause instanceof SQLException) {
SQLException sqlEx = (SQLException) cause;
int errorCode = sqlEx.getErrorCode();
// 可以根据 errorCode 做更细粒度的处理
return "Database error code: " + errorCode;
}
return ex.getMessage();
}
}
这段代码展示了一个基于 Spring Boot 的全局异常处理器。它拦截所有 DataAccessException 异常，并尝试从其中提取原始的 SQLException。通过检查 cause 是否为 SQLException 实例，我们可以安全地向下转型并访问其特有的方法，如 getErrorCode()。这种方法允许开发者根据具体的数据库错误行为（例如 MySQL 的错误码 1062 表示重复键值）来定制响应内容，而不是简单地返回通用的“服务器内部错误”。这不仅提升了用户体验，也便于运维人员通过错误码快速定位问题根源。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
