JAX-WS 애플리케이션에 대한 webservices.xml 배치 디스크립터 개발
배치 디스크립터는 XML을 사용하여 형식화되는 표준 텍스트 파일로 웹 서비스 애플리케이션에 패키지됩니다. JAX-WS(Java™ API for XML-Based Web Services) 웹 서비스 내 어노테이션에 지정된 애플리케이션 메타데이터를 대체하거나 기능을 보강하기 위해 webservices.xml 배치 디스크립터를 선택적으로 사용할 수 있습니다.
이 태스크 정보
JAX-RPC(Java API for XML-based RPC) 웹 서비스와 마찬가지로, 배치 디스크립터를 사용하여 JAX-WS 웹 서비스를 설명할 수 있습니다. JAX-WS 웹 서비스의 경우, 어노테이션을 사용하여 배치 디스크립터 파일에 포함된 모든 정보를 지정할 수 있기 때문에 webservices.xml 배치 디스크립터를 선택적으로 사용할 수 있습니다. 배치 디스크립터 파일을 사용하여 기존 JAX-WS 어노테이션을 기능 보강하거나 대체할 수 있습니다. webservices.xml 배치 디스크립터에 정의한 정보는 어노테이션으로 지정된 모든 해당 정보를 대체합니다.
JAX-WS 웹 서비스를 사용하려면 Java 클래스를 제공자 엔드포인트에 대한 javax.jws.WebService 어노테이션 또는 javax.jws.WebServiceProvider 어노테이션으로 어노테이션을 작성해야 합니다. 서버 측 배치 디스크립터를 사용하여 어노테이션의 대응하는 속성을 대체하거나 어노테이션에서 정보를 강화할 수 있습니다. 배치 디스크립터 요소와 @WebService 및 @WebServiceProvider 어노테이션 사이의 정의된 관계가 있습니다. 배치 디스크립터 요소와 @WebService 및 @WebServiceProvider 어노테이션 속성에 대한 맵핑과 관련된 자세한 정보는 Java EE(Java Platform, Enterprise Edition) 스펙, 버전 1.2용 웹 서비스에서 5.3절을 참조하십시오. 다른 어노테이션에 맵핑하는 webservice.xml 배치 디스크립터에도 요소가 있습니다. 예를 들어, 배치 디스크립터 요소 <protocol-binding>은 @BindingType 어노테이션에 맵핑되고 배치 디스크립터 요소 <enable-mtom>은 @MTOM 어노테이션에 맵핑됩니다. 웹 서비스 배치 디스크립터 요소에 대한 자세한 정보는 Java EE(Java Platform, Enterprise Edition) 스펙에 대한 웹 서비스에서 7.1절을 참조하십시오.
프로시저
결과
JAX-WS 어노테이션 속성을 대체하거나 어노테이션에서 정의되지 않은 속성을 지정하는 데 사용할 수 있는 배치 디스크립터 템플리트가 있습니다.
예
@WebService(wsdlLocation=”http://myhost.com/location/of/the/wsdl/ExampleService.wsdl”)
연관된 webservices.xml 배치 디스크립터는 다음과 같이 WSDL 문서에 대해
서로 다른 파일 이름을 지정합니다. <webservices>
<webservice-description>
<webservice-description-name>ExampleService</webservice-description-name>
<wsdl-file>META-INF/wsdl/ExampleService.wsdl</wsdl-file>
…
</webservice-description>
</webservices>
배치 디스크립터, META-INF/wsdl/ExampleService.wsdl에
지정된 값은 어노테이션 값을 대체합니다. 다음에 수행할 작업
webservice.xml 배치 디스크립터를 구성합니다. 배치 디스크립터를 구성한 후, 웹 서비스 애플리케이션을 배치용으로 어셈블해야 합니다.