Jersey 2使用方法参数生成WADL模式

Question

我正在使用Jersey 2并希望生成WADL架构.当我访问时,<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的详细信息吗？

Answer 1

WADL本身AFAIK不提供比您获得的更多信息.好的,实际上确实如此,因为/application.wadl自Jersey 2.5.1以来,一些非用户定义的资源和方法隐藏在默认响应中.要多看一点(但仍然不是你想达到什么),你可以调用与WADL资源detail查询参数,即/application.wadl?detail=true,见第16章泽西文档的.

回到你的问题 - 如果我理解正确,你想要泽西做的是在WADL中自动公开你的bean的JSON-Schema,对吧？

目前在Jersey-2.x中这不容易实现.有一个扩展模块由杰拉德·戴维森书面新泽西州1.x中,但是支持还没有移植到新泽西州的2.x的(目前只XSD支持).

但是,泽西积压中存在一个问题,所以有一些耐心,你可能会有一天得到开箱即用的解决方案.

与此同时,您可以尝试在Gerard的博文中描述一个快速且有点脏的解决方案.

我知道答案有点晚了,但仍然希望它有所帮助.

祝好运.