2017-11-06 20 views
1

G'Evening,Javax에서 Swagger를 통해 API 문서 생성 (JEE 아래)?

우리는 Java EE와 함께 Wildlfly에서 실행되는 기존 REST 프로젝트에 Swagger를 구현하려고합니다. 목적은 런타임 중에 REST-API에 대한 문서를 생성하는 것입니다.

그러나, 필요한 의존성 추가 한 후 : 우리 Gradle을 설치에 (io.swagger 자신감-jaxrs)을, 우리는

<servlet-mapping> 
<servlet-name>SwaggerConfig</servlet-name> 
<url-pattern>/api/documentation</url-pattern> 
</servlet-mapping> 

<servlet> 
<servlet-name>SwaggerConfig</servlet-name> 
<servlet-class>io.swagger.jaxrs.config.DefaultJaxrsConfig</servlet-class> 
<init-param> 
<param-name>api.version</param-name> 
<param-value>1.0.0</param-value> 
</init-param> 
<init-param> 
<param-name>swagger.api.basepath</param-name> 
<param-value>http://localhost:8080/api/documentation</param-value> 
</init-param> 
<load-on-startup>2</load-on-startup> 
</servlet> 

우리는을 해결하기 위해 관리합니까은 web.xml을 통해 자신감 발생기를 설정하는 시도 서블릿을 SOAP를 통해 */api/documentation 아래에 배치했지만, 문서, JSON 파일 또는 다른 방식으로 생성 된 것 같지 않으며 생성을 설정하는 위치/방법을 파악할 수없는 것처럼 보입니다.

도움이 필요하다고 생각되는 가이드에 대한 도움, 조언 또는 링크를 제공해 주시면 대단히 감사하겠습니다.

답변

0

Swagger는 백 엔드 서버가 실행되는 동안 액세스 할 수있는 HTML 페이지를 생성합니다.

서버가 단지 404을 반환 유효한 사이트에 /api/index.html

+0

/api/index.html도 /api/documentation/index.html 어느 리드를 사용해보십시오. – Alblaka