2015-07-20 100 views
0

我已经完成了针对jboss7.2的泽西REST服务的代码。下面是 是我的REST与swagger anotation。但我无法生成。可任何一个样品休息服务招摇DOC帮我用详细的步骤招摇推进的过程如何集成Swagger与Maven + Jersey + jboss EAP 6.2

@Api(value="Employee" ,description="manage Emnployee") 
@Path("/employee") 
public class TestServices { 
    @Path("/get/{id}") 
    @GET 
    @Produces(MediaType.APPLICATION_JSON) 
    @ApiOperation(value="List all people", notes="List all people using paging") 
    public Response getEmployee(@PathParam("id") String empId){ 
     System.out.println("Employee ID : "+empId); 
     Empolyee emp= new Empolyee(empId, "SAnjay"); 
     return Response.status(200).entity(emp).build(); 
    } 

回答

0

我有一些运气的招摇核心servlet来生成休息DOC 和将swagger-ui指向您映射此servlet的位置。

泽西岛2.X看到:https://github.com/swagger-api/swagger-core/wiki/Swagger-Core-Jersey-2.X-Project-Setup#hooking-up-swagger-core-in-your-application

或者看到:https://github.com/swagger-api/swagger-core/wiki/Java-JAXRS-Quickstart

要generage静态文档,你需要的Maven的插件 https://github.com/kongchen/swagger-maven-plugin

我从来没有与这一个运气好的话。 ..我知道需要静态文档生成

我生成静态Swagger-UI文件使用:https://github.com/teamcarma/swagger-jaxrs-doclet与Maven

而且,这个项目产生了基于JAX-RS注释和JavaDoc中的招摇的UI文件,因此无需扬鞭注释

+0

我一直在寻找,但我无法得到理解的过程中,如何用休息映射,将注意力放到静态文档上。 –

+0

您需要将您选择的插件添加到您的maven config:pom.xml中,并根据需要进行配置。当你启动Maven构建时,使用适当的“目标”,插件将执行并生成配置的文档。如果您从Eclipse启动您的Maven构建版,请确保刷新您的目标文件夹(如果您已将该插件配置为在目标文件夹中生成它们) – Filip