2015-07-20 77 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

相關問題