Question

我已经为jboss7.2完成了针对泽西REST服务的代码。下面是我的REST与swagger anotation。但我不能为样本休息服务生成swagger doc。任何人都可以帮助我使用swagger详细一步一步生成休息文档

    @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();
    }

Answer 1

我对swagger-core servlet运气不错并将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

要生成静态文档，您需要maven-plugin https://github.com/kongchen/swagger-maven-plugin

我从来没有幸运过这个......我理解静态文档生成的必要性

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

此外，该项目基于JAX-RS注释和JavaDoc生成swagger-ui的文件，因此不需要Swagger注释

如何将Swagger与Maven + Jersey + jboss EAP 6.2集成

1 个答案: