JAX/泽西岛响应中的自定义错误代码

http java response jersey

2022-09-01 18:48:32

在泽西岛，我们如何“替换”与已知状态代码关联的状态字符串？

例如：

return Response.status(401).build();

生成一个 HTTP 响应，其中包含：

HTTP/1.1 401 Unauthorized

我（不是我，而是客户端应用程序）希望看到响应为：

HTTP/1.1 401 Authorization Required

我尝试了以下方法，但徒劳无功：

1）这只是在HTTP响应的正文中添加字符串

return Response.status(401).entity("Authorization Required").build();

2）结果也与此相同：

ResponseBuilder rb = Response.status(401);
rb = rb.tag("Authorization Required");
return rb.build();

感谢您的帮助！

-浪涌

答案 1

要在泽西岛执行此操作，您有WebApplicationException类的概念。一种方法是简单地扩展此类和所有一个方法来设置返回的错误文本。在你的情况下，这将是：

import javax.ws.rs.*;
import javax.ws.rs.core.*;
import javax.ws.rs.core.Response.*;


public class UnauthorizedException extends WebApplicationException {

    /**
      * Create a HTTP 401 (Unauthorized) exception.
     */
     public UnauthorizedException() {
         super(Response.status(Status.UNAUTHORIZED).build());
     }

     /**
      * Create a HTTP 404 (Not Found) exception.
      * @param message the String that is the entity of the 404 response.
      */
     public UnauthorizedException(String message) {
         super(Response.status(Status.UNAUTHORIZED).entity(message).type("text/plain").build());
     }

}

现在，在实现 rest 服务的代码中，您只需抛出此类型的新异常，在构造函数中传入文本值，例如

throw new UnauthorizedException("Authorization Required");

这可以为每个 Web 异常创建一个这样的类，并以类似的方式抛出。

泽西岛用户指南中也对此进行了解释 - 尽管代码实际上略有错误：

https://jersey.github.io/nonav/documentation/latest/user-guide.html/#d4e435

答案 2

我不确定JSR 339：JAX-RS 2.0：用于RESTful Web Services的Java API是否已经涵盖了这一点。

为此，您可能需要扩展 Response.StatusType。

public abstract class AbstractStatusType implements StatusType {

    public AbstractStatusType(final Family family, final int statusCode,
                              final String reasonPhrase) {
        super();

        this.family = family;
        this.statusCode = statusCode;
        this.reasonPhrase = reasonPhrase;
    }

    protected AbstractStatusType(final Status status,
                                 final String reasonPhrase) {
        this(status.getFamily(), status.getStatusCode(), reasonPhrase);
    }

    @Override
    public Family getFamily() { return family; }

    @Override
    public String getReasonPhrase() { return reasonPhrase; }

    @Override
    public int getStatusCode() { return statusCode; }

    public ResponseBuilder responseBuilder() { return Response.status(this); }

    public Response build() { return responseBuilder().build(); }

    public WebApplicationException except() {
        return new WebApplicationException(build());
    }

    private final Family family;
    private final int statusCode;
    private final String reasonPhrase;
}

以下是一些扩展的 statust 类型。

public class BadRequest400 extends AbstractStatusType {

    public BadRequest400(final String reasonPhrase) {
        super(Status.BAD_REQUEST, reasonPhrase);
    }
}

public class NotFound404 extends AbstractStatusType {

    public NotFound404(final String reasonPhrase) {
        super(Status.NOT_FOUND, reasonPhrase);
    }
}

我就是这样做的。

@POST
public Response create(final MyEntity entity) {

    throw new BadRequest400("bad ass").except();
}

@GET
public MyEntity read(@QueryParam("id") final long id) {

    throw new NotFound404("ass ignorant").except();
}

// Disclaimer
// I'm not a native English speaker.
// I don't know what 'bad ass' or 'ass ignorant' means.