Question

我将Jersey API用于我的REST服务。我的问题是：是否有更优雅的方式以JSON形式返回异常？我是否更关心自己创建一个json对象并将其直接附加到响应中？

这是服务中某个方法的简化示例。如您所见，我只使用HashMap，因为该方法可能会抛出异常，在这种情况下，我需要返回有关它的信息。

@Path("/admin")
public class AdminService {

    @Context
    HttpServletRequest request;

    @POST
    @Produces(MediaType.APPLICATION_JSON)
    public Map<Integer, String> createCompany(Company company){

        Map<Integer, String> map = new HashMap<>();
        try{
            AdminFacade adminFacade = (AdminFacade)Utility.getFacade(request);
            adminFacade.createCompany(company);
            map.put(1,"success");
        } catch (ExceptionREST e) {
            map.put(e.getErrorNumber(), e.getMessage());
        } finally {
            return map;
        }
    }
}

Answer 1

您可以创建类似下面的类来表示错误，

@JsonPropertyOrder({ "code", "field", "message" })
public class ErrorInfo {

    private String code;

    private String field;

    private String message;

    public String getCode() {
        return code;
    }

    public void setCode(String code) {
        this.code = code;
    }

    public String getField() {
        return field;
    }

    public void setField(String field) {
        this.field = field;
    }

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }

}

您可以创建一个扩展此类异常的类，

public class InvalidInputException extends RuntimeException {

    private static final long serialVersionUID = -5027121014723838738L;

    private List<ErrorInfo> errors;

    public List<ErrorInfo> getErrors() {
        return this.errors;
    }

    public InvalidInputException(List<ErrorInfo> errors) {
        super();
        this.errors = errors;
    }

    public InvalidInputException(String message, List<ErrorInfo> errors) {
        super(message);
        this.errors = errors;
    }

}

并有一个异常映射器，您可以在其中将List转换为json并返回到具有http状态代码400（错误请求）的用户。

@Provider
public class InvalidInputExceptionMapper implements ExceptionMapper<InvalidInputException> {

    @Override
    @Produces(MediaType.APPLICATION_JSON)
    public Response toResponse(InvalidInputException e) {

        ResponseBuilder rb = Response.status(Status.BAD_REQUEST);

        rb.entity(e.getErrors());
        return rb.build();   
    }
}

Http响应将是，

HTTP/1.1 400 BAD REQUEST
{
"errors": [{
    "error": {
        "code": "100",
        "field": null,
        "message": "Name is required"
    },
    "error": {
        "code": "100",
        "field": null,
        "message": "Age is required"
    }
}]

}

Answer 2

我相信人们使用http响应状态代码来处理错误非常受欢迎。例如。找不到404状态5xx是服务器内部错误e.t.c. 您可以使用Response对象轻松设置错误代码。而不是返回地图，返回一个Response对象。

@Path("/admin")public class AdminService {

@Context
HttpServletRequest request;

@POST
@Produces(MediaType.APPLICATION_JSON)
public Response createCompany(Company company){

    Map<Integer, String> map = new HashMap<>();
    try{
        AdminFacade adminFacade = (AdminFacade)Utility.getFacade(request);
        Company commpany=adminFacade.createCompany(company);//this entity annotated by XmlRootElement
        Response response=Response.ok().entity(company).build();
    } catch (ExceptionREST e) {
        response=Response.status(404).build();
    } return response;
}}

为了使Restful api更加健壮，有些人会返回OK响应，以防止＆＃34;智能重定向＆＃34;从服务器和输出一些奇怪的HTML。您可以参考here获取http状态代码列表及其含义。对于Java EE Response类，您可以参考official javadoc

Answer 3

你可以把你的错误包装成一个类，比如说我有一个有状态，消息和堆栈跟踪的ErrorData类。每次发生异常时，我都会使用errordata对象抛出一个GeneralAppException。

node_view_gui

我有另一个具有所有已知错误的类，例如

public class GeneralAppException  extends WebApplicationException {
 public GeneralAppException(ErrorData er) {

            super(Response.status(er.getStatusCode()).
            entity(er).type(MediaType.APPLICATION_JSON).build());
          }
}

你的捕获物看起来像

public static final ErrorData NODATAFOUND = new ErrorData(Response.Status.NOT_FOUND.getStatusCode(),"No data was found for given query");

public static final ErrorData CODEERROR = new ErrorData(502,"CodeError");

使用的参考：https://jersey.java.net/documentation/latest/representations.html#d0e6665

REST服务：返回异常的正确方法

3 个答案: