我需要一些帮助来理解Websphere Liberty(18.0.0.1)如何处理JAX-RS端点调用中抛出的异常。我正在使用Liberty功能jaxrs-2.0
,因此应该由WLP提供实现。
现在,我的应用程序有一个POST HTTP端点接受JSON有效负载,我想为所有可能的错误客户端输入提供自定义错误消息。
这是一个以我预期的方式工作的案例:
application/xml
而不是application/json
ClientErrorException
ExceptionMapper<WebApplicationException>
来处理这个异常(实际上是为了处理所有Web应用程序异常,我很好)以下是不适合我的情况:
application/json
,但空体java.io.EOFException: No content to map to Object due to end of input
- 是的,看起来很准确EOFException
包装成某种WebApplicationException
(我可以轻松处理),WLP将异常问题包装到JaxRsRuntimeException
这里有几点:
ExceptionMapper<JaxRsRuntimeException>
的映射器,因为该异常不是JAX-RS 2.0规范的一部分,我必须提供对JaxRsRuntimeException的导入,并将应用程序与一些Liberty特定的库连接起来。ExceptionMapper<RuntimeException>
和字符串检查,如果它找到classname'JaxRsRuntimeException'的异常,然后处理它。但这对我来说似乎并不合适。那么,WLP设计是不是在这种情况下不给我一个WebApplicationException?处理这种情况的优雅解决方案是什么?
谢谢
编辑:添加了部分源代码。
REST端点和资源方法:
@Path("/books")
public class BookEndpoint {
@POST
@Consumes(MediaType.APPLICATION_JSON)
public Response createBook(Book book, @Context UriInfo uriInfo) {
bookDao.create(book);
UriBuilder builder = uriInfo.getAbsolutePathBuilder();
builder.path(Integer.toString(book.getId()));
return Response.created(builder.build()).entity(book).build();
}
}
带有JAXB注释的实体:
@XmlRootElement
public class Book {
private int id;
private String title;
// getters, setters
}
异常堆栈跟踪:
com.ibm.ws.jaxrs20.JaxRsRuntimeException: java.io.EOFException: No content to map to Object duto end of input
at org.apache.cxf.jaxrs.utils.JAXRSUtils.toJaxRsRuntimeException(JAXRSUtils.java:1928)
at [internal classes]
at org.apache.logging.log4j.web.Log4jServletFilter.doFilter(Log4jServletFilter.java:71)
at com.ibm.ws.webcontainer.filter.FilterInstanceWrapper.doFilter(FilterInstanceWrapper.java:201)
at [internal classes]
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)
at java.lang.Thread.run(Thread.java:745)
Caused by: java.io.EOFException: No content to map to Object duto end of input
at org.codehaus.jackson.map.ObjectMapper._initForReading(ObjectMapper.java:2775)
at [internal classes]
at java.security.AccessController.doPrivileged(Native Method)
at org.apache.cxf.jaxrs.utils.JAXRSUtils.readFromMessageBodyReader(JAXRSUtils.java:1413)
at [internal classes]
... 48 more
这是基于JAX-RS 2.0 Spec的第3.3.4节(和4.5.1节)的预期行为。这些部分描述了如何处理来自JAX-RS资源和提供程序的异常 - 简而言之:
WebApplicationException
,那么它将自动映射到Response
。ExceptionMapper
可以处理抛出的异常,那么将用于生成响应。ServletException
传递给Web容器。JaxRsRuntimeException
用于满足第4步。
在这种情况下,内置的JSON提供程序(基于Jackson 1.X)正在抛出EOFException
。由于EOFException(或其任何超类)没有异常映射器,因此它最终通过ServletException
映射到JaxRsRuntimeException
。
为了使应用程序能够处理这种情况,有几种不同的选择:
ExceptionMapper
(EOFException
或其任何超类 - 即IOException
)。您不需要为JaxRsRuntimeException
注册映射器,因为该异常仅在Liberty内部使用 - 并且不应映射。如果您看到传递给ExceptionMapper
的JaxRsRuntimeException,那么您应该打开IBM的支持案例,因为这可能是一个错误。使用ExceptionMapper<EOFException>
,只要从提供者或资源中抛出EOFException
,您就可以返回特定的响应。
MessageBodyReader
,它将JSON转换为对象(使用Jackson或任何其他JSON序列化代码),但它将以您希望的方式处理空消息体 - 例如,将其转换为null
或使用某种默认对象实例。由于用户注册的提供商优先于内置提供商,因此将使用此MBR代替Liberty的基于Jackson的MBR。这种方法绝对可以让您更好地控制数据的反序列化以及异常处理。
ContainerRequestFilter
提供程序,该提供程序将在邮件正文为空时中止。这是一个例子:
@Provider
public class EmptyBodyCheckFilter implements ContainerRequestFilter {
@Override
public void filter(ContainerRequestContext crc) throws IOException {
if (crc.getEntityStream().available() < 1) {
crc.abortWith(Response.status(400).entity("Invalid request - empty message body").build());
}
}
}
我已经使用WebSphere Liberty May 2018 Beta成功测试了选项1和3。我没有为此方案亲自测试过选项2,但基于过去使用自定义MBR,这应该可行。
要记住的一件事是,当Liberty GAs是jaxrs-2.1
功能时,它将使用JSONB作为内置提供程序来序列化/反序列化JSON而不是Jackson。我使用JAX-RS 2.1(也在May Beta中)测试了你的场景,而不是EOFException
,JSONB代码抛出了NoSuchElementException
。如果您认为可以转移到JAX-RS 2.1,那么我建议选项2或3.选项1要求您为JAX-RS 2.1创建新的ExceptionMapper
。
希望这可以帮助,
安迪
不是直接回答“为什么WLP包装异常..etc”,但可能会像你一样添加一个异常拦截器,但是on"ExceptionMapper<Exception>"
and会在“原因”上反复思考,检查java.io.EOFException
是否是其中之一...