29.3. Cryostat-WS 카탈로그 사용
29.3.1. 개요
Cryostat-WS 사양은 모든 구현이 다음을 지원해야 합니다.
웹 서비스 설명, 특히 WSDL 및 XML 스키마 문서에 포함된 웹 서비스 문서를 확인할 때 사용할 표준 카탈로그 기능입니다.
이 카탈로그 기능은 OA Cryostat에서 지정한 XML 카탈로그 기능을 사용합니다. WSDL URI를 사용하는 모든 Cryostat-WS API 및 주석은 카탈로그를 사용하여 WSDL 문서의 위치를 확인합니다.
즉, WSDL 문서의 위치를 특정 배포 환경으로 다시 작성하는 XML 카탈로그 파일을 제공할 수 있습니다.
29.3.2. 카탈로그 작성
Cryostat-WS 카탈로그는 OA Cryostat XML Catalogs 1.1 사양에 정의된 표준 XML 카탈로그 입니다. 매핑을 지정할 수 있습니다.
- URI에 대한 문서의 공용 식별자 및/또는 시스템 식별자입니다.
- 다른 URI에 대한 리소스의 URI입니다.
표 29.1. “Common Cryostat-WS Catalog Cryostat” WSDL 위치 확인에 사용되는 몇 가지 공통 요소를 나열합니다.
| element | 설명 |
|---|---|
|
| URI를 대체 URI에 매핑합니다. |
|
| URI의 시작을 다시 작성합니다. 예를 들어 이 요소를 사용하면 http://cxf.apache.org 로 시작하는 모든 URI를 classpath: 로 시작하는 URI에 매핑할 수 있습니다. |
|
| 원래 URI의 접미사를 기반으로 대체 URI에 URI를 매핑합니다. 예를 들어 foo.xsd로 끝나는 모든 URI를 classpath: foo.xsd 에 매핑할 수 있습니다. |
29.3.3. 카탈로그 패키지
Cryostat-WS 사양은 WSDL 및 XML 스키마 문서를 해결하는 데 사용되는 카탈로그가 META-INF/jax-ws-catalog.xml 이라는 사용 가능한 모든 리소스를 사용하여 어셈블되도록 합니다. 애플리케이션이 단일 JAR 또는 WAR에 패키지된 경우 카탈로그를 단일 파일에 배치할 수 있습니다.
애플리케이션이 여러 JAR로 패키지된 경우 카탈로그를 여러 파일로 분할할 수 있습니다. 각 카탈로그 파일은 특정 JAR의 코드에서 액세스하는 WSDL만 처리하도록 모듈화할 수 있습니다.
