我正在使用Jersey 2并希望生成WADL架构.
当我访问< context_root> /application.wadl时,我可以看到我的所有REST服务,但是如果服务使用 JSON(并且几乎所有服务都使用 JSON),我会得到以下结果:
当我访问< context_root> /application.wadl时,我可以看到我的所有REST服务,但是如果服务使用 JSON(并且几乎所有服务都使用 JSON),我会得到以下结果:
<resource path="/addItem"> <method id="addItem" name="POST"> <request> <representation mediaType="application/json"/> </request> <response> <representation mediaType="application/json"/> </response> </method> </resource>
而我的服务看起来像:
@POST @Path("/addItem") @Consumes(MediaType.APPLICATION_JSON) @Produces(MediaType.APPLICATION_JSON) public Response addItem(ItemDto item) { cartService.addItem(item); return Response.ok().build(); }
我可以在我的wadl计划中获得有关ItemDto的详细信息吗?
解决方法
WADL本身AFAIK不提供比您获得的更多信息.好的,实际上确实如此,因为自Jersey 2.5.1以来,一些非用户定义的资源和方法隐藏在默认的/application.wadl响应中.要查看更多内容(但仍然不是您想要实现的内容),您可以使用详细查询参数调用wadl资源,即/application.wadl?detail=true,请参阅Jersey文档的
Chapter 16.
回到你的问题 – 如果我理解正确,你想让泽西岛做的是在WADL中自动公开你的豆子JSON-Schemas,对吧?
目前在Jersey-2.x中这不容易实现. Gerard Davison在Jersey-1.x中有一个extension module,但支持尚未移植到Jersey-2.x(目前仅支持XSD).
但是,泽西积压中有一个issue,所以有一些耐心,你可能有一天会得到开箱即用的解决方案.
在此期间,您可以尝试执行杰拉德博客文章中描述的Quick and a bit dirty solution.
我知道答案有点晚了,但仍然希望它有所帮助.
祝好运.