핸들러 클래스를 위해 webservices.xml 배치 디스크립터 구성
사용자 제공 핸들러 클래스를 위해 webservices.xml 배치 디스크립터를 구성하기 위해 어셈블리 도구를 사용할 수 있습니다.
시작하기 전에
애플리케이션 서버와 함께 제공되는 어셈블리 도구를 사용하여 배치 디스크립터를 구성할 수 있습니다.
핸들러 클래스는 원격 프로시저 호출(RPC) 요청 또는 응답을 나타내는 SOAP 메시지를 수정하기 위해 작성되는 클래스입니다. 핸들러는 웹 서비스 또는 웹 서비스 클라이언트와 연관될 수 있습니다.
JAX-RPC(Java™ API for XML-based RPC) 웹 서비스와 마찬가지로, 배치 디스크립터를 사용하여 JAX-WS( Java API for XML Web Services) 웹 서비스를 설명할 수 있습니다. JAX-WS 웹 서비스의 경우, 어노테이션을 사용하여 배치 디스크립터 파일에 포함된 모든 정보를 지정할 수 있기 때문에 webservices.xml 배치 디스크립터를 선택적으로 사용할 수 있습니다. 배치 디스크립터 파일을 사용하여 기존 JAX-WS 어노테이션을 기능 보강하거나 대체할 수 있습니다. webservices.xml 배치 디스크립터에 정의한 정보는 어노테이션으로 지정된 모든 해당 정보를 대체합니다.
이 태스크를 완료하려면 구성하려는 애플리케이션에 대한 엔터프라이즈 아카이브(EAR) 파일이 필요합니다. 로깅 또는 추적 등과 같은 몇몇 핸들러 용도의 경우 서버 또는 클라이언트 애플리케이션을 구성해야 합니다. SOAP 헤더에 정보 전송을 포함하여 다른 핸들러 용도의 경우, 클라이언트 및 서버 애플리케이션이 대칭적 핸들러로 구성되어야 합니다.
이 태스크 정보
EAR 파일의 모듈은 구성할 핸들러 클래스를 포함합니다. 이러한 클래스는 javax.xml.rpc.handler.Handler 인터페이스를 구현합니다. 핸들러 클래스 작성에 대한 자세한 정보는 Java EE용 웹 서비스 명세의 6장을 참조하십시오. 프로그래밍 모델을 위한 핸들러 프레임워크에서 추가 정보에 대해서는 JAX-WS 명세의 9장 또는 JAX-RPC 명세의 12장을 참조하십시오. 애플리케이션 모듈은 webservices.xml 배치 디스크립터를 포함해야 합니다. 지원되는 표준 및 명세의 전체 목록과 함께 JAX-RPC 명세를 검토하려면 웹 서비스 명세 및 API 정보를 참조하십시오.
프로시저
- 어셈블리 도구를 시작하십시오. Rational® Application Developer 정보에서 어셈블리 도구 시작에 대해 읽으십시오.
- 아직 수행하지 않은 경우 Java EE 모듈에서 작동할 수 있도록 어셈블리 도구를 구성하십시오. Java EE 및 웹 카테고리가 사용으로 설정되었는지 확인해야 합니다. Rational Application Developer 정보에서 어셈블리 도구 구성에 대해 읽으십시오.
- 어셈블리 툴킷, 애플리케이션 어셈블리 도구(AAT) 또는 다른 도구를 사용하여 작성된 웹 애플리케이션 아카이브(WAR) 파일을 Rational Application Developer 어셈블리 도구로 마이그레이션하십시오. 파일을 마이그레이션하려면 WAR 파일을 어셈블리 도구로 가져오십시오. Rational Application Developer 정보에서 코드 아티팩트를 어셈블리 도구로 가져오기에 대해 읽으십시오.
- 클라이언트 배치 디스크립터를 구성하십시오. Rational Application Developer 정보에서 클라이언트 배치 디스크립터 구성에 대해 읽으십시오.