为swagger UI wildfly swarm

时间:2017-01-01 11:54:57

标签: java documentation swagger swagger-ui wildfly-swarm

我使用Wildfly Swarm进行REST应用程序并使用默认设置我在url / swagger或/swagger.json上使用swagger.json,在url / swagger-ui上使用ui进行swagger。但默认情况下,UI从示例中解析petstore。如何为我的json文件配置UI的默认路径?我有下一个swagger的依赖:

<dependency>
    <groupId>org.wildfly.swarm</groupId>
    <artifactId>swagger</artifactId>
</dependency>
<dependency>
    <groupId>org.wildfly.swarm</groupId>
    <artifactId>swagger-webapp</artifactId>
</dependency>

3 个答案:

答案 0 :(得分:0)

你可以给swagger-ui一个链接到你的swagger.json的url参数。例如:

http://localhost:8080/swagger-ui/index.html?url=/swagger.json

答案 1 :(得分:0)

您可以创建自己的Swagger-ui Web应用程序。只需从示例项目中获取静态文件(html,js,css,img)。现在,您可以编辑index.html并定义自己的特定swagger.json位置。

答案 2 :(得分:0)

swagger-webapp中有一个servlet,它可以满足您的需求。根本没有记录。 https://github.com/thorntail/thorntail/blob/master/fractions/swagger-webapp/src/main/java/org/wildfly/swarm/swagger/webapp/runtime/SwaggerDefaultUrlChangerServlet.java

我将此系统属性添加到了project-defaults.yml中,现在启动了swagger-ui,指向我的swagger.json

swarm:
  swagger:
    web-app:
      json:
        path: /rest/swagger.json