java - 使用异常处理 Java REST API 的应用程序和业务故障场景

Question

我正在开发一个 Java 应用程序，并且在我的资源类中定义了所有 JAX-RS API 方法。我还在我的资源类中使用依赖注入(inject)将每个任务委托(delegate)给它自己的服务类:

class Resource {

    // Services are injected.
    // Each service has a couple of failure scenarios.
    // Exp. Request Not valid, Id not valid, Database internal error, etc.
    DBService dbService;
    validationService validationService;
    searchService searchService;

    @GET(user/:id)
    public User getUser(int id) {
        try {
            validationService.validate(request);
            dbService.getUser(id);
            searchService.index(request);
            ...
        } catch (UserNotFoundException e) {
            // return proper http response code and message
        } catch (UserBannedException e) {
            ...
        } catch (DBInternalError e) {
            ...
        } ... 

    }
}

对于每个 Service 类中的每个故障场景，我都为该故障场景创建了一个特定的异常，并将其抛出到 Service 类中，并在 API Resource 类中处理所有这些异常。我使用异常作为我的资源关于失败场景的信号，并返回正确的 HTTP 状态代码和消息。

我得到的一个提示是我正在创建很多异常类，而我的 Resource 类有一长串用于不同故障场景的 catch block 。

一个建议的解决方案是，例如在我的 validationService 中，我返回一个 false boolean 值而不是异常，在我的资源中，我放置了一个 if/else 语句并返回正确的状态代码。但是我不喜欢这个解决方案，因为它使我的 api 充满了 if/else 语句并且线性度降低。

我的问题是，我的用例可以有很多异常类吗？有没有更好的架构供我使用？

Answer 1

我建议不要在您的资源层中捕获它们。

您的服务层应该了解业务逻辑，因此请进行检查和验证，并使用适当的错误消息抛出您的业务异常，并让异常映射器 - https://docs.oracle.com/javaee/7/api/javax/ws/rs/ext/ExceptionMapper.html捕捉它们并创建相关的响应。

这样你就没有很多 try catch block 或 if else 语句。

例子:

人资源.java

@RequestScoped
@Path("/person")
@Produces({ "application/json" })
@Consumes({ "application/json" })
public class PersonResource {

    public PersonResource() {}

    @Inject
    PersonService personService;

    @POST
    @Path("/add")
    public void addPerson(Person person) throws MyValidationException{
        personService.add(person);
    }
...

人事服务.java

@RequestScoped
public class PersonServiceImpl implements PersonService {

    @Inject
    PersonDAO personDAO;

    @Transactional
    @Override
    public Long add(Person person) throws MyValidationException {

    //checking for existing person
    List<Person> list = personDAO.find(person.getName(), person.getDob());

    //if not found, save new person
    if(list == null || list.isEmpty()){
        Long id = personDAO.save(person);
        return id;
    }

    //otherwise throw exception
    String message = "Person already exists: '" + person.getName + "'";
    throw new MyValidationException(message);
}
...

ValidationExceptionMapper.java

@Provider
public class ValidationExceptionMapper implements ExceptionMapper<MyValidationException>{

    @Override
    public Response toResponse(MyValidationException e) {
        e.printStackTrace();
        String errorMessage = e.getMessage();
        return Response.status(Response.Status.BAD_REQUEST)//or whatever other status is more appropriate
                .entity(errorMessage)
                .build();
    }
}

因此，通过这种方式，您可以拥有与创建业务异常一样多的异常映射器，这样您的业务或资源层就不会受到所有异常处理的污染。

异常映射器也知道如何处理异常层次结构。

并让客户端处理响应错误状态和正文(错误消息)。