IBM® WebSphere JAX-WS 런타임 환경을 사용하여 WSDL 문서에서 웹 서비스 클라이언트 생성

웹 서비스 클라이언트 마법사가 Java™ Bean 프록시 및 샘플 애플리케이션 생성을 돕습니다. 샘플 웹 애플리케이션에서는 프록시 파일 코딩 방법을 보여줍니다.

시작하기 전에

전제조건:
제한사항: J2EE(Java Platform, Enterprise Edition) 컨테이너 밖에서 단순 Java 웹 서비스 클라이언트를 실행하려면, 단순 Java 프로젝트로 웹 서비스 클라이언트를 생성해야 합니다. 웹 서비스 마법사는 단순 Java 프로젝트를 작성할 수 없습니다. 가장 비슷한 양식은 유틸리티 프로젝트이지만, 유틸리티 프로젝트에서 단순 Java 웹 서비스 클라이언트(컨테이너가 없음) 실행은 지원하지 않습니다. 웹 서비스 클라이언트 마법사를 실행하기 전에 단순 Java 프로젝트를 작성해야 합니다.

이 태스크 정보

찾은 WSDL 문서에서 Java 클라이언트 프록시 및 샘플 애플리케이션을 생성하려면 다음을 수행하십시오.

프로시저

  1. Java EE 퍼스펙티브(창 > 퍼스펙티브 열기 > Java EE)로 전환하십시오.
  2. 파일 > 새로 작성 > 기타를 클릭하십시오. 다양한 웹 서비스 마법사를 표시하려면 웹 서비스를 선택하십시오. 웹 서비스 클라이언트 마법사를 선택하십시오. 다음을 클릭하십시오.
  3. 웹 서비스 페이지: 클라이언트 생성에 사용할 WSDL 파일을 선택하십시오. 다음을 수행하도록 선택할 수도 있습니다.
    1. 슬라이더를 사용하여 완료할 웹 서비스 클라이언트 개발 단계를 선택하십시오. 이를 수행하면 나머지 마법사 패널에 다음과 같은 여러 기본값이 설정됩니다.
      • 개발: 웹 서비스 클라이언트의 WSDL 정의 및 구현을 개발합니다. 여기에는 생성된 코드, WSDL 파일, 배치 디스크립터, Java 파일이 있는 경우 이를 포함하는 모듈 작성과 같은 태스크가 포함됩니다.
      • 어셈블: 웹 서비스 클라이언트를 호스팅하는 프로젝트가 대상 애플리케이션 서버에서 필요할 때 EAR에 연관시킵니다.
      • 배치: 클라이언트 배치 코드를 작성합니다.
      • 설치: 대상 서버에 웹 모듈 및 EAR을 설치하고 구성합니다. WSDL 파일의 엔드포인트를 변경해야 하는 경우 이 단계에서 변경합니다.
      • 시작: 클라이언트가 서버에 설치되면 서버를 시작합니다.
      • 테스트: 웹 서비스 탐색기 또는 샘플 JSP 사용과 같이 서비스 테스트를 위한 다양한 옵션을 제공합니다.
    2. 서버 선택: 기본 서버가 표시됩니다. 다른 서버에 서비스를 배치하려면 링크를 클릭하여 다른 서버를 지정하십시오.
      이 태스크는 다음 서버 런타임 환경을 지원합니다.
      • WebSphere Application Server V7.0 이상
      • WebSphere Application Server Liberty Profile V8.5.5
    3. 런타임 선택: 기본 런타임이 표시됩니다. 다른 런타임에 서비스를 배치하려면 링크를 클릭하여 다른 런타임을 지정하십시오.
    4. 클라이언트 프로젝트 선택: 작업공간에서 선택한 프로젝트가 표시됩니다. 다른 프로젝트 및 EAR을 선택하려면 프로젝트 링크를 클릭하십시오. 클라이언트 코드의 위치로 웹 프로젝트, EJB 프로젝트, Java 프로젝트 또는 Java EE 애플리케이션 클라이언트 프로젝트를 선택할 수 있습니다. 클라이언트 웹 프로젝트로 선택한 프로젝트가 서비스 웹 프로젝트와 달라야 합니다. 그렇지 않으면, 서비스는 클라이언트가 생성한 진단 지원 파일로 겹쳐쓰여집니다. JAX-WS 웹 서비스의 경우, 서버와 클라이언트 프로젝트가 동일한 EAR을 공유할 수 있습니다.
    5. 웹 서비스 모니터: 웹 서비스에서 생성된 SOAP 트래픽을 관찰하고 WS-I 준수를 확인하기 위해 이 트래픽을 테스트할 수 있는 TCP/IP 모니터를 통해 웹 서비스 트래픽을 송신합니다. 또는 웹 서비스 테스트를 위한 TCP/IP 모니터 사용에 설명된 대로 TCP/IP 모니터를 수동으로 설정할 수 있습니다.
  4. WebSphere JAX-WS 웹 서비스 클라이언트 구성 페이지:
    • 출력 폴더: 클라이언트 Java 클래스를 생성하려는 폴더를 선택하거나 기본값을 허용하십시오.
    • 대상 패키지: 웹 서비스 클라이언트 마법사는 지정된 WSDL에서 여러 개의 Java 파일을 생성합니다. 기본적으로 WSDL 파일에 지정된 네임스페이스를 기반으로 패키지 이름을 작성합니다. 이 기본 동작을 대체하기 위해 WSDL 파일의 네임스페이스에 자체 패키지 이름을 지정할 수 있습니다.
    • 이식 가능 클라이언트 생성: 이 선택란을 선택하면 한 시스템에서 다른 시스템으로 또는 WebSphere Application Server의 한 인스턴스에서 다른 인스턴스로 웹 서비스 클라이언트 코드를 이동할 수 있습니다. 이 옵션이 선택되면 WSDL 문서와 이 문서가 종속된 모든 XML 스키마 및 기타 WSDL 문서가 WEB-INF/wsdl 아래의 클라이언트 프로젝트에 복사되며 이 사본을 가리키는 file:relativeURL이 JAX-WS 서비스 클래스의 정적 초기화 블록에 삽입됩니다.
    • 생성된 클라이언트에 대해 비동기 호출 사용: 비동기 클라이언트를 사용 가능하게 선택한 경우, 웹 서비스의 각 메소드에 대해 두 개의 추가 메소드가 작성됩니다. 이 메소드는 폴링 및 콜백 메소드로, 이러한 메소드에서 클라이언트가 비동기적으로 작동할 수 있습니다.
    • JAX-WS 또는 JAXB 바인딩 파일 지정: JAX-WS 또는 JAXB 사용자 정의 바인딩 파일을 작성하는 경우에 이 웹 서비스를 작성하도록 사용하려면 이 선택란을 선택하십시오.
    • 클라이언트 프록시 클래스 이름 사용자 정의: 기본 프록시 이름을 승인할 수도 있고 직접 입력할 수도 있습니다.
    • 웹 서비스 배치 디스크립터 생성: JAX-WS의 경우, 웹 서비스 배치 정보는 런타임에 의해 동적으로 생성되므로 정적 배치 디스크립터는 더 이상 필요하지 않습니다. 이 선택란을 선택하면 배치 디스크립터가 생성됩니다.
    • 벤더 확장기능 허용: 이 선택란을 선택하는 경우 -extension 옵션이 wsgen 또는 wsimport 명령에 추가됩니다. -extension 옵션은 JAX-WS 사양에서 지정하지 않은 기능을 사용자 정의 확장기능으로 사용 또는 허용하는지 여부를 지정합니다. 확장기능의 사용으로 응용프로그램이 이식 불가능하거나 다른 구현과 상호 운영되지 않을 수 있습니다. 자세한 내용을 보려면 WebSphere Application Server의 Information Center에서 찾을 수 있는 JAX-WS 애플리케이션의 wsgen 명령JAX-WS 애플리케이션의 wsimport 명령 주제를 참조하십시오.
  5. 바인딩 선언 사용자 정의 페이지: 이전 페이지에서 JAX-WS 또는 JAXB 바인딩 파일을 제공하도록 선택한 경우 해당 위치를 찾을 수 있습니다.
  6. 프록시 생성 구성 페이지: 클라이언트 프록시 클래스 이름을 사용자 정의하도록 선택한 경우 이 페이지를 사용하여 각 포트에 대해 프록시 클래스 이름을 지정하십시오.
  7. 웹 서비스 클라이언트 테스트 페이지:
    • 생성된 프록시 테스트: 선택한 경우 샘플 클라이언트가 웹 브라우저에서 실행되어 기능을 테스트할 수 있습니다.
    • 테스트 기능을 선택하십시오. 일반 서비스 클라이언트 또는 웹 서비스 탐색기에서 생성된 프록시를 테스트할 수 있거나 샘플 JAX-WS 2.0 JSP를 생성하고 사용할 수 있습니다.
    • 폴더: JSP를 통해 프록시를 테스트하도록 선택한 경우 JSP가 배치되는 폴더를 선택할 수 있고 JSP에 포함되는 메소드를 선택할 수 있습니다.
    • 메소드: 표시할 메소드를 선택하십시오. 비동기 호출을 사용 가능하도록 선택하면 비동기 메소드도 나열되어야 합니다.
    • 서버에서 테스트 실행: 자동으로 서버를 시작합니다.
  8. 완료를 클릭하십시오. 프록시를 테스트하도록 선택한 경우 브라우저 창에 클라이언트 테스트가 열립니다.

결과

생성된 Java Bean 프록시에서는 웹 서비스로의 원격 프로시저 호출 인터페이스를 제공합니다. 샘플 웹 애플리케이션은 프록시 파일 코딩 방법을 보여줍니다.

Java 클라이언트 프록시를 생성한 경우, 웹 서비스 샘플 JPS 또는 웹 서비스 탐색기를 사용하는 프록시를 통해 웹 서비스의 메소드를 테스트할 수 있습니다.

주제 유형을 표시하는 아이콘 태스크 주제
Information Center의 이용 약관 | 피드백

시간소인 아이콘 마지막 업데이트 날짜: 2014-05-22

파일 이름: tsampappjaxws.html