54.4. OpenAPI 문서 액세스
OpenApiFeature에서 OpenAPI를 활성화하면 서비스 끝점 위치 다음에 /openapi.json
또는 /openapi.yaml
을 사용하여 구성된 위치 URL에서 OpenAPI 문서를 사용할 수 있습니다.
예를 들어 http://host:port/context/services/
에 게시된 JAX-RS 엔드포인트의 경우 context
가 웹 애플리케이션 컨텍스트이고 /services
는 서블릿 URL인 경우 OpenAPI 문서는 http://host:port/context/services/openapi.json
및 http://host:port/context/services/openapi.yaml
에서 사용할 수 있습니다.
OpenApiFeature가 활성화되어 있으면 CXF Services 페이지가 OpenAPI 문서에 연결됩니다.
위의 예에서는 http://host:port/context/services/services
로 이동한 다음 OpenAPI JSON 문서를 반환하는 링크를 따릅니다.
다른 호스트의 OpenAPI UI에서 정의에 액세스하는 데 CORS 지원이 필요한 경우 cxf-rt-rs-security-cors
에서 CrossOriginResourceSharingFilter
를 추가할 수 있습니다.