为cxf服务加上wadl描述信息

为cxf服务加上wadl描述信息

我们在开发cxf rest服务的时候，往往需要为每个服务添加描述文档，以前我们可能是将描述文档用word或者excel记录，现在介绍一种通过cxf-rt-rs-service-description自动生成wadl描述文档的方法。

1. 首先我们在项目中引入cxf-rt-rs-service-description包，通过maven方式构建

< dependency >

   < groupId >org.apache.cxf</ groupId >

   < artifactId >cxf-rt-rs-service-description</ artifactId >

   < version >3.0.0-milestone1</ version >

</ dependency >

2. 在服务中添加描述信息

@GET
  @Path("/reses/{resId}/{userId}")
  @Produces(MediaType.APPLICATION_JSON)
  @Description(value = "展示资源详情", target = DocTarget.METHOD)
  public ReturnMsg<ResourceDTO> showRes(@PathParam("resId") String resId, @PathParam("userId") String userId);

3. 启动服务，访问http://192.9.8.8:9080/reslib/api/?_wadl出现下面内容表示成功配置。

参考文档：http://cxf.apache.org/docs/jaxrs-services-description.html#JAXRSServicesDescription-WADLAutoGenerationatRuntime