java - REST 服务的异常层次结构

Question

我正在为我的 REST 服务设计异常类层次结构并面临以下问题。 请注意，该解决方案必须与 Java 7 兼容。

假设我正在构建一个系统来管理考试。假设我有以下资源:

• 学生(学号、名字、姓氏……)
• 类(class)(类(class) ID、名称、...)
• 考试(examId，成绩，...)

以及以下操作(以及其他操作):

• 获取/students/{studentId}
• 获取/courses/{courseId}
• POST/students/{studentId}/exams(正文包含成绩和 courseId)

请注意，对于某些操作，courseId 作为 URL 的一部分提供，而对于其他操作，则作为请求正文的一部分提供。

我想设计一个异常类层次结构，以一致的方式向客户端报告错误。我想在每个异常类上具有以下属性:

• statusCode - 响应的 HTTP 状态代码，
• errorCode - 错误的唯一标识符，
• errorMessage - 人类可读的错误描述。

现在让我们关注类似“无效 ID”的错误。我有以下要求:

• 如果无效 ID 作为 URL 的一部分提供，statusCode 应为 404(未找到)。如果它是作为请求正文的一部分提供的，那么它应该是 400(错误请求)。

• errorCode/errorMessage 应该从业务角度识别错误。 errorCode 应该是一个唯一标识错误原因的数字(假设 1 表示无效的学生 ID，2 表示无效的类(class) ID，等等)，而 errorMessage 应该以人类可识别的格式描述原因(例如“学生 ID [135] 不存在。”)

问题是，如何将这两个正交层次结构组合成一个异常类层次结构？

理想情况下我会有以下异常类:

public abstract class ApiException extends Exception {

    public abstract int getStatusCode();
    public abstract int getErrorCode();
    public abstract String getErrorMessage();
}

public abstract class NotFoundException extends ApiException {

    public int getStatusCode() {
        return 404;
    }
}

public abstract class BadRequestException extends ApiException {

    public int getStatusCode() {
        return 400;
    }
}

public abstract class InvalidCourseIdException extends ApiException {

    private final String courseId;

    public InvalidCourseIdException(final String courseId) {
        this.courseId = courseId;
    }

    public int getErrorCode() {
        return 2;
    }

    public String getErrorMessage() {
        return "Course with ID [" + courseId + "] does not exist.";
    }
}

public class CourseNotFoundException extends NotFoundException, InvalidCourseException {
    public CourseNotFoundException(String courseId) {
        super(courseId);
    }
}

public class BadCourseException extends BadRequestException, InvalidCourseException {

    public BadCourseException(String courseId) {
        super(courseId);
    }
}

...

当然，Java中没有多重继承。我如何设计一个 Java 7 兼容的类层次结构，遵守 DRY 原则(我想将每个常量值只定义在一个地方)？

Answer 1

检查异常的关键方面是您可以捕获它们并从状态中恢复。

异常不应按名称传输原因。如果是 400 或 404，则无法恢复，因此应用程序应记录状态并中断。

ApiException 类就足够了。

如果您害怕生成太多代码克隆。您可以创建一个实用程序类来收集所有案例。

final class ApiThrowables {

       static final int BAD_REQUEST = 400; 
       static final int NOT_FOUND   = 404;

       public static ApiException newCourseIdNotFound(String courseId) {
          return new ApiException(2, NOT_FOUND,"Course with ID [" + courseId + "] does not exist.");
       }

       public static ApiException newBadCourseId(String courseId) {
          return new ApiException(2, BAD_REQUEST,"Course ID [" + courseId + "] is not valid.");
       }

    }

稍后当您开发应用程序时，您可能会更改异常的设计，此组合将允许您这样做。当您使用继承而不是组合时，您的代码变成了中继物对，这抑制了更改和重用的潜力。