웹 서비스 마법사 대신 Ant 태스크를 사용하여
IBM® WebSphere® JAX-WS 런타임 환경에 대한
Java™ 웹 서비스를 생성할 수 있습니다. Ant 태스크는 상향식 및 하향식 웹 서비스 개발을 모두 지원합니다.
시작하기 전에
웹 서비스를 작성하기 전에 다음 전제조건을 완료해야 합니다.
- 웹 서비스에 대한 웹 프로젝트 및 서버를 작성하십시오(JAX-WS 사용 WebSphere 서버 작성).
- 작업공간으로 Ant 태스크 및 특성 파일을 가져오십시오(JAX-WS 웹 서비스의 Ant 파일 가져오기).
- 웹 서비스에 대한 Ant 특성 파일을 사용자 정의하십시오.
- 작성할 웹 서비스 유형에 따라, 작성한 웹 프로젝트의 폴더에서 파일을 찾거나
웹 프로젝트 폴더에 파일을 작성하거나 가져오십시오.
- 상향식 서비스를 작성하려면 Java Bean을
src 폴더에 작성하거나 가져오십시오.
- 하향식 서비스를 작성하려면 WSDL 파일을 찾거나 작성 또는 작성한 프로젝트로 이를 가져오십시오.
이 태스크 정보
웹 서비스를 작성하려면 서비스의 Ant 특성 파일을 수정하십시오. Ant 특성 파일 이름은 작성할 웹 서비스 유형에 따라 다릅니다.
- 상향식 서비스를 작성하려는 경우 Ant 특성 파일 이름은 was_jaxws_bujava.properties입니다.
- 하향식 서비스를 작성하려는 경우 Ant 특성 파일 이름은 was_jaxws_tdjava.properties입니다.
- 클라이언트를 작성하려는 경우 Ant 특성 파일의 이름은 was_jaxws_client.properties입니다.
프로시저
다음 두 방법 중 하나로 Ant 태스크를 실행하십시오. - 제품 작업공간에서 태스크를 실행하려면 다음을 수행하십시오.
- 가져온 웹 서비스 생성 XML 파일을 마우스 오른쪽 단추로 클릭한 후
를 선택하십시오.
- 대화 상자에서 JRE 탭을 클릭하고 작업공간과 동일한 JRE에서 실행을 선택하십시오.
- 적용을 클릭하고 실행을 클릭하십시오.
- 명령행에서 태스크를 실행하려면 다음을 수행하십시오.
- 태스크를 실행하기 전에 작업공간을 닫으십시오.
- 명령행에 다음 사항을 입력하십시오.
- Windows: wsant.bat workspace_path wsgen_path
- Linux: wsant.sh workspace_path wsgen_path
여기서
workspace_path는 작업공간의 완전한 경로이고 wsgen_path는 웹 서비스 생성 파일을 가져온 위치의
완전한 경로입니다. 예를 들어, 명령은 다음과 같을 수 있습니다. wsant.bat D:\RationalAppDeveloper\workspace1 D:\RationalAppDeveloper\workspace1\TestProj\wsgenTemplates\was_jaxws_tdjava.xml
웹 서비스가 생성되면, 콘솔 또는 명령행에
빌드 완료 메시지가 표시됩니다.
결과
웹 서비스가 생성되면, 다음 파일이 선택한 옵션 및 생성된 웹 서비스 유형에 따라 작성됩니다.
- 하향식: SEI(Service Endpoint Interface). SEI는 어노테이션이 웹 서비스에 대한 WSDL 파일의 어노테이션이 있는
Java 표시입니다. 이 인터페이스는
JavaBeans 엔드포인트 구현이나
동적 프록시 클라이언트 인스턴스 작성에 사용됩니다. SEI내의 데이터 유형 참조.
- 상향식: 위임 클래스. 이 클래스는 Java Bean의 모든 메소드뿐만 아니라
런타임이 웹 서비스로 인식하는 JAX-WS 어노테이션도 포함하는 랩퍼입니다.
Ant 태스크를
실행하기 전에 @javax.jws.WebService 어노테이션이 포함된 Bean이 이미 있는 경우 이 Bean은 그 상태로 사용되며
새 어노테이션이 추가되지 않습니다.
- 요청/응답/예외 랩퍼 클래스
팁: wsant.bat
파일이 제품의 bin 디렉토리에 설치됩니다. 일부 시스템에서는 이 디렉토리가 읽기 전용일 수 있습니다.
이 경우, Ant 태스크가 출력을 작성할 수 없으므로 웹 서비스 작성에 실패합니다. 이를 정정하는 두 가지 방법이 있습니다.
- bin 폴더를 가리키도록 PATH를 설정한 후 쓰기 권한이 있고 그 위치에서 스크립트를 실행하는 디렉토리로 변경하십시오.
- wsant.bat 파일을 쓰기 가능한 디렉토리에 복사하십시오.