WSDL2Client 도구를 사용하여 웹 서비스 클라이언트 작성

WSDL2Client 도구는 하나 이상의 WSDL 문서에서 완전 배치가 가능한 웹 서비스 클라이언트를 생성하여 선택적으로 애플리케이션 서버에 배치합니다.

시작하기 전에

전제조건:

이 태스크 정보

이 도구는 다음과 같은 4단계로 사용됩니다.

프로시저

  1. -project 인수와 함께 도구를 실행하여 특정 WSDL 문서에서 기술된 웹 서비스에 사용할 스켈레톤 클라이언트 구현 템플리트를 작성하십시오.
  2. 템플리트에 구현 코드를 작성하고 1단계에서 생성된 빌드 스크립트를 사용하여 코드를 컴파일하십시오.
  3. -clientType J2SE 옵션을 지정한 상태에서 -genMain 옵션을 지정할 경우, 1단계에서 생성된 실행 스크립트를 사용하여 클라이언트를 실행하십시오.
  4. -clientType 옵션을 Application, EJB 또는 Servlet으로 지정한 경우, -createEar 인수와 함께 도구를 실행하여 이 구현에서 웹 서비스 클라이언트 사용 가능 아카이브를 빌드한 후 아카이브를 애플리케이션 서버에 배치하십시오.

명령행 설정

About this task

WSDL2Client 도구를 사용하기 전에 웹 서비스 명령행을 다음과 같이 설정해야 합니다.

Procedure

  1. 명령 프롬프트에서 install_directory/bin으로 변경하십시오.
  2. 아래의 일괄처리 스크립트를 실행하십시오.
    • Windows: setupenv.bat
    • Linux: . setupenv.sh
  3. 웹 서비스 클라이언트를 작성할 디렉토리로 변경하십시오. 이 디렉토리를 명령행 테스트 디렉토리라고 하겠습니다. Linux: 이 디렉토리에 대한 쓰기 액세스 권한이 있어야 합니다.

Results

이제 WSDL2Client 도구의 1단계를 실행할 수 있습니다.

스켈레톤 웹 서비스 클라이언트 구현 작성

Before you begin

참고: WSDL2Client 도구는 2가지 버전이 있습니다. WSDL2Client 명령을 실행하면 J2EE 1.4가 사용됩니다. 또는 J2EE 1.3을 사용하는 WSDL2Client 명령을 사용할 수도 있습니다. J2EE 1.3을 사용하는 웹 서비스 클라이언트를 작성하려는 경우, 아래 명령에서 WSDL2ClientWSDL2Client13으로 모두 대체하면 됩니다.

About this task

스켈레톤 웹 서비스 클라이언트 구현을 작성하려면 명령 프롬프트에 다음을 입력하십시오.

Procedure

Results

중요:
  • 마지막 인수는 <WSDL URI>여야 하며 대소문자를 구분합니다. 필수 및 선택 인수의 목록은 WSDL2Client 도구를 참조하십시오.
  • 아래 설명에 따라 웹 서비스 클라이언트 사용 가능 아카이브를 작성하려는 경우, 스켈레톤 웹 서비스 클라이언트 구현을 작성할 때 -clientType 인수를 지정해야 합니다.

힌트: 명령행 테스트 디렉토리 경로와 -project에 지정한 이름을 기록해두십시오. 이 정보는 추후에 웹 서비스를 배치하고 테스트할 때 필요합니다.

-project <ProjectDir> 인수를 사용하여 도구를 실행하면, 지정된 프로젝트 아래에 "client-side"라는 디렉토리가 작성됩니다. 이 디렉토리는 여러 개의 서브디렉토리를 포함합니다. 서브디렉토리에는 웹 서비스 구현을 빌드하는 데 필요한 복합 유형별 직렬화기 및 역직렬화기 클래스, 배치 디스크립터를 포함하여 모든 필수 Java 템플리트가 포함되어 있습니다. -clientType 및 -genMain 옵션을 지정한 경우에는 사용 중인 클라이언트 유형에 대한 기본 클래스 구현 템플리트가 생성된 것도 확인할 수 있습니다.

이러한 코드를 모두 컴파일할 수 있도록 buildclient_new라는 빌드 스크립트도 생성됩니다. -clientType J2SE 인수와 함께 도구를 실행한 경우 runclient라는 실행 스크립트도 생성됩니다.

클라이언트 구현 코드 컴파일

About this task

클라이언트 코드를 컴파일하려면 다음을 수행하십시오.

Procedure

  1. <ProjectDir> 디렉토리로 변경한 다음, 클라이언트측 디렉토리로 변경하십시오.
  2. 구현 코드가 .jar 파일이나 .class 파일 디렉토리 등에 종속되는 경우, 컴파일 스크립트를 편집하여 해당 종속 항목의 전체 경로 이름을 USER_CLASSPATH 변수에 추가하십시오. 예를 들면 다음과 같습니다.
    • Windows: set USER_CLASSPATH = c:\MyJars\webservice.jar;c:\MyClasses
    • Linux: USER_CLASSPATH = /home/MyJars/webservice.jar:/home/MyClasses
  3. buildclient_new 명령을 입력하십시오.

J2SE 웹 서비스 클라이언트 실행

About this task

J2SE 웹 서비스 클라이언트를 실행하려면 다음을 수행하십시오.

Procedure

  1. <ProjectDir> 디렉토리로 변경한 다음, 클라이언트측 디렉토리로 변경하십시오.
  2. 구현 코드가 .jar 파일이나 .class 파일 디렉토리 등에 종속되는 경우, 컴파일 스크립트를 편집하여 해당 종속 항목의 전체 경로 이름을 USER_CLASSPATH 변수에 추가하십시오. 예를 들면 다음과 같습니다.
    • Windows: set USER_CLASSPATH = c:\MyJars\webservice.jar;c:\MyClasses
    • Linux: USER_CLASSPATH = /home/MyJars/webservice.jar:/home/MyClasses
  3. runclient 명령을 입력하십시오.

웹 서비스 클라이언트 사용 가능 아카이브 작성

About this task

웹 서비스 클라이언트 사용 가능 아카이브를 작성하려면 다음을 수행하십시오.

Procedure

  1. install_directory/bin 디렉토리로 변경하십시오.
  2. 다음 명령을 입력하십시오. WSDL2Client [<선택 인수>] -createEar <File.ear> -clientType <Application | EJB | Servlet> <ProjectDir>

Results

중요:
  • 마지막 인수는 <ProjectDir>이어야 하며 "client-side" 디렉토리를 포함해야 합니다.
  • 위에 설명된 바와 같이 -createEar 인수를 성공적으로 실행하려면, 스켈레톤 웹 서비스 클라이언트 구현을 작성할 때 -clientType 인수를 지정해야 합니다.

구현 코드를 작성하여 컴파일한 후 -createEar <File.ear> 인수와 함께 도구를 다시 실행하면 새 EAR 파일이 작성되거나 EAR 파일이 업데이트됩니다. 또한 웹 서비스를 구현하는 클라이언트측 클래스가 정상적 위치인 META-INF\classes 디렉토리로 이동된 것을 확인할 수 있습니다. -clientType Servlet을 지정한 경우, 클라이언트측 클래스가 WEB-INF\classes 디렉토리로 이동된 것을 확인할 수 있습니다.

EAR 파일을 생성한 후에는 다른 사용자가 사용하도록 서버에 배치할 수 있습니다. 이를 수행하려면 명령행 도구를 사용하여 서버에 웹 서비스 배치를 참조하십시오.


피드백