웹 서비스 클라이언트 마법사가 Java™ Bean 프록시 및
샘플 애플리케이션 생성을 돕습니다. 샘플 웹 애플리케이션에서는 프록시 파일 코딩 방법을 보여줍니다.
시작하기 전에
전제조건:
- WebSphere® Application Server를 사용하는 경우
컴퓨터 속도에 따라 시작하는 시간이 달라질 수 있으므로, 웹 서비스 마법사를 실행하기 전에
WebSphere Application Server를 시작하는 것이
좋습니다.
서버를 시작하려면
서버 보기에서 서버를 선택하고(창 > 보기 표시 > 서버) 마우스 오른쪽 단추를
클릭한 다음 시작을 선택하십시오.
- WSDL 문서를 찾거나 작업공간을 가져오십시오. 서비스 요소를 포함하는
WSDL 파일을 사용할 수 있습니다. 작업공간에서 정적 WSDL 파일, URL에 있는 WSDL 파일을 사용할 수 있거나,
작업공간에서 JAX-WS 웹 서비스로 동작하는 어노테이션이 있는 Bean이 있는 경우,
웹 서비스용 WebSphere Application Server 기능팩 런타임이
동적으로 작성한 WSDL 파일을 사용할 수 있습니다. 이 WSDL은 http://localhost:port/service_project_name/service_nameService?wsdl과 같은 URL에서 찾을 수 있습니다. 예를 들어 웹 서비스용 기능팩에서
제공된 학습 및 샘플로 작성된 주소록 JAX-WS 웹 서비스에서 동적 WSDL 파일은
http://localhost:9082/jwsAddressBook/AddressBookService?wsdl과 같은 URL에서
찾을 수 있습니다.
제한사항: J2EE(Java Platform, Enterprise Edition)
컨테이너 밖에서
단순 Java 웹 서비스 클라이언트를 실행하려면,
단순 Java 프로젝트로 웹 서비스 클라이언트를
생성해야 합니다. 웹 서비스 마법사는 단순 Java 프로젝트를 작성할 수 없습니다.
가장 비슷한 양식은 유틸리티 프로젝트이지만, 유틸리티 프로젝트에서
단순 Java 웹 서비스 클라이언트(컨테이너가 없음) 실행은
지원하지 않습니다. 웹 서비스 클라이언트 마법사를 실행하기 전에 단순 Java 프로젝트를
작성해야 합니다.
이 태스크 정보
찾은 WSDL 문서에서 Java 클라이언트 프록시 및 샘플
애플리케이션을 생성하려면 다음을 수행하십시오.
프로시저
- Java EE
퍼스펙티브(창 > 퍼스펙티브 열기 > Java EE)로 전환하십시오.
- 파일 > 새로 작성 > 기타를 클릭하십시오. 다양한 웹 서비스 마법사를
표시하려면 웹 서비스를 선택하십시오.
웹 서비스 클라이언트 마법사를 선택하십시오. 다음을 클릭하십시오.
- 웹 서비스 페이지: 클라이언트 생성에 사용할 WSDL 파일을 선택하십시오. 다음을 수행하도록 선택할 수도 있습니다.
- 슬라이더를 사용하여 완료할 웹 서비스 클라이언트 개발 단계를 선택하십시오. 이를
수행하면 나머지 마법사 패널에 다음과 같은 여러 기본값이 설정됩니다.
- 개발: 웹 서비스 클라이언트의 WSDL 정의 및 구현을 개발합니다. 여기에는
생성된 코드, WSDL 파일, 배치 디스크립터,
Java 파일이 있는 경우 이를 포함하는
모듈 작성과 같은 태스크가 포함됩니다.
- 어셈블: 웹 서비스 클라이언트를 호스팅하는 프로젝트가 대상 애플리케이션 서버에서 필요할 때
EAR에 연관시킵니다.
- 배치: 클라이언트 배치 코드를 작성합니다.
- 설치: 대상 서버에 웹 모듈 및 EAR을 설치하고 구성합니다. WSDL
파일의 엔드포인트를 변경해야 하는 경우 이 단계에서 변경합니다.
- 시작: 클라이언트가 서버에 설치되면 서버를 시작합니다.
- 테스트: 웹 서비스 탐색기 또는 샘플 JSP 사용과 같이 서비스 테스트를 위한 다양한
옵션을 제공합니다.
- 서버 선택: 기본 서버가 표시됩니다. 다른 서버에 서비스를 배치하려면 링크를 클릭하여
다른 서버를 지정하십시오.
이 태스크는
다음 서버 런타임 환경을 지원합니다.
- WebSphere Application
Server V7.0 이상
- WebSphere Application
Server Liberty Profile V8.5.5
- 런타임 선택: 기본 런타임이 표시됩니다. 다른 런타임에 서비스를 배치하려면 링크를 클릭하여 다른 런타임을 지정하십시오.
- 클라이언트 프로젝트 선택: 작업공간에서 선택한 프로젝트가 표시됩니다. 다른
프로젝트 및 EAR을 선택하려면 프로젝트 링크를 클릭하십시오. 클라이언트 코드의 위치로 웹 프로젝트, EJB 프로젝트, Java 프로젝트 또는
Java EE 애플리케이션 클라이언트 프로젝트를
선택할 수 있습니다. 클라이언트 웹 프로젝트로 선택한 프로젝트가
서비스 웹 프로젝트와 달라야 합니다. 그렇지 않으면, 서비스는
클라이언트가 생성한 진단 지원 파일로 겹쳐쓰여집니다. JAX-WS 웹 서비스의 경우, 서버와 클라이언트 프로젝트가 동일한 EAR을 공유할 수 있습니다.
- 웹 서비스 모니터: 웹 서비스에서 생성된 SOAP 트래픽을 관찰하고 WS-I 준수를 확인하기 위해 이 트래픽을
테스트할 수 있는 TCP/IP 모니터를 통해 웹 서비스 트래픽을 송신합니다. 또는
웹 서비스 테스트를 위한 TCP/IP 모니터 사용에
설명된 대로 TCP/IP 모니터를 수동으로 설정할 수 있습니다.
- 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 명령 주제를 참조하십시오.
- 바인딩 선언 사용자 정의 페이지: 이전 페이지에서 JAX-WS 또는 JAXB 바인딩 파일을 제공하도록 선택한 경우 해당 위치를 찾을 수 있습니다.
- 프록시 생성 구성 페이지: 클라이언트 프록시 클래스 이름을 사용자 정의하도록 선택한 경우 이 페이지를 사용하여 각 포트에 대해
프록시 클래스 이름을 지정하십시오.
- 웹 서비스 클라이언트 테스트 페이지:
- 생성된 프록시 테스트: 선택한 경우 샘플 클라이언트가 웹 브라우저에서
실행되어 기능을 테스트할 수 있습니다.
- 테스트 기능을 선택하십시오. 일반 서비스 클라이언트 또는 웹 서비스 탐색기에서
생성된 프록시를 테스트할 수 있거나 샘플
JAX-WS 2.0 JSP를 생성하고 사용할 수 있습니다.
- 폴더: JSP를 통해 프록시를 테스트하도록 선택한 경우 JSP가 배치되는 폴더를 선택할 수 있고
JSP에 포함되는 메소드를 선택할 수 있습니다.
- 메소드: 표시할 메소드를 선택하십시오. 비동기 호출을 사용 가능하도록 선택하면 비동기 메소드도
나열되어야 합니다.
- 서버에서 테스트 실행: 자동으로 서버를 시작합니다.
- 완료를 클릭하십시오. 프록시를 테스트하도록 선택한 경우 브라우저 창에 클라이언트 테스트가
열립니다.
결과
생성된 Java Bean 프록시에서는 웹 서비스로의
원격 프로시저 호출 인터페이스를 제공합니다.
샘플 웹 애플리케이션은 프록시 파일 코딩 방법을
보여줍니다.
Java 클라이언트 프록시를 생성한 경우,
웹 서비스 샘플 JPS 또는 웹 서비스 탐색기를 사용하는 프록시를 통해 웹 서비스의 메소드를 테스트할 수 있습니다.
- 웹 서비스 탐색기를 사용하여 웹 서비스를 테스트하도록 선택한 경우 탐색기가
열립니다. 테스트하려는 오퍼레이션을 선택하고
필수 정보를 입력한 다음 이동을 클릭하십시오. 결과는 상태 분할창에 표시됩니다.
- Java
씬 클라이언트를 선택한 경우
Java
씬 클라이언트를 실행한 시스템 출력은 콘솔 보기에 표시됩니다.
실행 구성 대화 상자에서
실행을 클릭하여
Java
씬 클라이언트를 실행할 수 있습니다. 클라이언트는
일반 Java
애플리케이션으로 해당 WebSphere
Application Server 씬 클라이언트 런타임 컨테이너 JAR을 사용합니다.