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

时间:2014-03-27 10:36:00

标签: java jersey-2.0 wadl

我正在使用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的详细信息吗?

1 个答案:

答案 0 :(得分:8)

WADL本身AFAIK不提供比您获得的更多信息。好的,实际上确实如此,因为自 Jersey 2.5.1 以来,一些非用户定义的资源和方法隐藏在默认的/application.wadl响应中。要查看更多(但仍然不是您想要实现的目标),您可以使用detail查询参数调用wadl资源,即/application.wadl?detail=true,请参阅Jersey文档的Chapter 16。< / p>

回到你的问题 - 如果我理解正确,你希望泽西岛做的是在WADL中自动公开你的bean的JSON-Schemas,对吗?

目前在Jersey-2.x中这不容易实现。 Gerard Davison在Jersey-1.x中有extension module,但支持尚未移植到Jersey-2.x(目前仅支持XSD)。

然而,泽西积压中有一个issue,所以有一些耐心,你可能有一天会得到开箱即用的解决方案。

与此同时,您可以尝试在Gerard的博文中描述Quick and a bit dirty solution

我知道答案有点晚,但仍希望有所帮助。

祝你好运。