웹 서비스 마법사가 웹 서비스를 작성하고 배치할 수 있도록 구성하며 웹 서비스를 서버에 배치할 수 있도록
도와 드립니다. 웹 서비스를 배치하면, 마법사가 클라이언트 프록시 및 샘플 애플리케이션을 생성하여
웹 서비스를 테스트할 수 있도록 도와 드립니다. 테스트를 완료하면, 내보내기 마법사를 사용하여
웹 서비스 UDDI 비즈니스 레지스트리에 공개할 수 있습니다.
시작하기 전에
전제조건:
- 선택사항: 웹 프로젝트를
작성하십시오(참고: Creating a WebSphere® Server 및
웹 프로젝트.
- 컴퓨터 속도에 따라 시작하는 시간이 달라질 수 있으므로, 웹 서비스 마법사를 실행하기 전에
WebSphere Application Server를 시작하는 것이
좋습니다. 서버를 시작하려면 서버 보기에서 서버를 선택하고(창
> 보기 표시 > 서버) 마우스 오른쪽 단추를 클릭한 다음 시작을 클릭하십시오.
- 웹 프로젝트 또는 Java™ 프로젝트의
Java 소스 폴더에 Bean을 작성하거나 가져오십시오.
Bean을 가져오려면 Java 자원:
src 폴더를 선택하고 파일 메뉴에서
을 선택한 다음 패키지 위치를 찾으십시오.
이 태스크 정보
IBM® WebSphere JAX-RPC 런타임 환경을 사용하여
Bean에서 웹 서비스를 작성하려면 다음을 수행하십시오.
프로시저
- Java EE
퍼스펙티브(창 > 퍼스펙티브 열기 > Java EE)로 전환하십시오.
- 엔터프라이즈 탐색기 보기에서 작성했거나 웹 프로젝트의 소스 폴더로 가져온
Bean을 선택하십시오.
- 파일 > 새로 작성 > 기타를 클릭하십시오. 다양한 웹 서비스 마법사를 표시하려면
웹 서비스를 선택하십시오. 웹 서비스 마법사를 선택하십시오.
다음을 클릭하십시오.
- 웹 서비스 페이지: 상향식 Java Bean 웹 서비스를
웹 서비스 유형으로 선택하십시오. 다음을 수행하도록 선택할 수도 있습니다.
- 슬라이더를 사용하여 완료할 웹 서비스 개발 단계를 선택하십시오. 이를 수행하면 나머지 마법사 패널에
다음과 같은 여러 기본값이 설정됩니다.
- 개발: 이 단계에서는 웹 서비스의 WSDL 정의 및 구현을 개발합니다. 여기에는 생성된 코드, WSDL 파일, 배치 디스크립터 및
Java 파일이 있는 경우 이를 포함하는
모듈 작성과 같은 태스크가 포함됩니다.
- 어셈블: 이 단계에서는 웹 서비스 또는 클라이언트를 호스팅하는 프로젝트가 대상 애플리케이션 서버에서 필요할 때
EAR에 연관시킵니다.
- 배치: 이 단계에서는 서비스 배치 코드를 작성합니다.
- 설치: 이 단계에서는 대상 서버에 웹 모듈 및 EAR을 설치하고 구성합니다. WSDL 파일의 엔드포인트를 변경해야 하는 경우 이 단계에서 변경합니다.
- 시작: 이 단계에서는 서비스를 서버에 설치하면 서버를 시작합니다.
- 테스트: 이 단계에서는 일반 서비스 클라이언트, 웹 서비스 탐색기
또는 샘플 JSP 등 서비스 테스트에 사용할 수 있는 다양한 옵션을
제공합니다.
- 서버 선택: 기본 서버가 표시됩니다. 다른 서버에 서비스를 배치하려면 링크를 클릭하여
다른 서버를 지정하십시오.
- 런타임 선택: 기본 런타임이 표시됩니다. 다른 런타임에 서비스를 배치하려면 링크를 클릭하여 다른 런타임을 지정하십시오.
- 서비스 프로젝트 선택: 작업공간에서 선택한 프로젝트가 표시됩니다. 다른 프로젝트 및 EAR을 선택하려면 프로젝트 링크를 클릭하십시오. 클라이언트 웹 프로젝트로 선택한 프로젝트가 서비스 웹 프로젝트와 다른지 또는 클라이언트에서 생성된 아티팩트가
서비스를 겹쳐쓰는지 확인하십시오.
- 클라이언트를 작성하려면 생성하려는 프록시 유형을 선택하고 클라이언트에 대해 위 단계를 반복하여 수행하십시오.
- 웹 서비스 공개: 웹 서비스를 UDDI 레지스트리에 공개할 수 있도록 웹 서비스 탐색기가 실행됩니다.
- 웹 서비스 모니터: 이 단계에서는 웹 서비스에서 생성된 SOAP 트래픽을 관찰하고 WS-I 준수를 확인하기 위해 이 트래픽을
테스트할 수 있는 TCP/IP 모니터를 통해 웹 서비스 트래픽을 송신합니다. 또는
웹 서비스 테스트를 위한 TCP/IP 모니터 사용에
설명된 대로 TCP/IP 모니터를 수동으로 설정할 수 있습니다. TCP/IP 모니터를 통해 웹 서비스 트래픽을 라우팅하는 경우, 유니버셜 테스트 클라이언트를 사용하여
웹 서비스를 테스트할 수 없다는 점을 참고하십시오.
- 서비스 엔드포인트 인터페이스 선택 페이지:
- 마법사가 생성하도록 하는 대신 기존의 SEI(Service Endpoint Interface)를
사용하도록 선택할 수 있습니다.
- 서버 배치 범위를 설정하십시오. 이 범위는 서버 구현의
배치 방법을 지정합니다. 애플리케이션에서는 전체 요청에 대해 한 개의 구현 클래스 인스턴스를 사용합니다.
요청은 각 요청에 대해 새 구현 클래스 인스턴스를 작성합니다.
세션은 각 세션에 대해 새 구현 클래스 인스턴스를 작성합니다.
- SOAP 조치를 설정하십시오. 이 옵션은 생성된 WSDL의 soapAction 필드를
설정하는 데 사용됩니다. 배치 정보에 따라
soapAction 필드가 기본값으로 설정됩니다.
없음인 경우 soapAction 필드가 큰따옴표("")로 설정됩니다. 오퍼레이션은 soapAction 필드를
오퍼레이션 이름으로 설정합니다.
- WSDL 1.1 표준을 사용하여 MIME 유형을 독점적으로 맵핑하도록
선택할 수도 있습니다. MIME 유형을 WSDL 1.1 표준으로 맵핑할 수 없는 경우(예: 첨부 파일이
배열이나 Java Bean 특성인 경우), 명령이 실패합니다.
- 웹 서비스 Java Bean
식별 페이지:
- 필요한 경우 WSDL 포트 이름을 변경하십시오.
- 필요한 경우 WSDL 파일 이름을 또는 경로 변경하십시오. 이 필드에
경로 정보를 입력하면 WEB-INF/wsdl 폴더 안에 폴더가
작성됩니다. 이 옵션은 기본 폴더에 있는 기존의 WSDL 또는 XSD 파일을
겹쳐쓰지 않으려는 경우에 유용하게 사용할 수 있습니다.
- 내보낼 메소드를 선택하십시오.
- void 리턴 설정 - 이 필드는 웹 서비스에서 응답이 예상되는지
여부를 설명하는 void 유형을 리턴하는 웹 서비스 메소드에 대한
필드입니다. Oneway: 이 인수는 JMS 전송의
기본값입니다. Twoway: 이 인수는 HTTP 전송의 기본값입니다.
- 인코딩 유형을 선택하십시오. 이는 유형을 지정하며
WSDL 파일에 생성된 조합을 사용합니다. 조합은 RPC/인코딩,
RPC/리터럴 또는 문서/리터럴입니다. 문서/리터럴만
WS-I와 호환됩니다.
- 보안 옵션을 선택하십시오. 보안은 WS-I와 호환되지 않습니다.
- 네임스페이스 맵핑에 대해 사용자 정의 패키지를 정의하려면 선택하십시오.
- 추가 및 중지 클래스를 지정하십시오. 추가는 WSDL 파일에서 표시된
다른 클래스를 지정합니다. -stopClasses 인수를 사용하여
검색을 중지시키는 추가 클래스를 정의할 수 있습니다.
- 웹 서비스 패키지에서 네임스페이스로의 맵핑 페이지: 웹 서비스 마법사가
지정된 Java Bean에서 WSDL 파일을 생성합니다.
기본적으로 Java Bean의 패키지 이름을 토대로
네임스페이스를 작성합니다. 이 기본 동작을 대체하려면 고유 네임스페이스가
WSDL 파일에 생성되도록 지정하면 됩니다. 이전 페이지에서, 패키지에서
네임스페이스로의 맵핑을 사용자 정의를 선택한 경우, 이 페이지에서
추가를 클릭하여 사용자 정의 맵핑 쌍을 입력할 수 있습니다.
또는 가져오기를 클릭하여 .properties 파일에서
사용자 정의 맵핑 쌍을 가져올 수 있습니다. 특성 파일의 컨텐츠는
package=namespace 형식이어야 합니다. 특성 파일에서는 일부 특수 문자를 이스케이프 처리해야
합니다. 예를 들어 somePackage=http://someNamespace는
somePackage=http\://someNamespace와 같이 처리해야 합니다. 이렇게 하지 않으면
콜론(:)이 분리 문자로 처리되어 somepackage에서
http로 맵핑을 시도합니다.
Java에서의 특성 파일 형식에 대한 자세한 정보는
Java 플랫폼 API 문서: java.util.Properties 로드 메소드를 참조하십시오.
- 추가 및 중지 클래스 구성 페이지: 추가 및 중지 클래스 지정을
선택한 경우, 이 페이지에서 추가 및 중지 클래스를 가져올 수
있습니다. 추가는 WSDL 파일에서 표시된
다른 클래스를 지정합니다. -stopClasses 인수를 사용하여
검색을 중지시키는 추가 클래스를 정의할 수 있습니다.
- 웹 서비스 테스트 페이지: 웹 서비스를 테스트하도록 선택한 경우, 생성된 웹 서비스에 사용할
테스트 기능을 선택하십시오. 그러면 웹 서비스가 웹 서비스 탐색기 또는 일반 서비스 클라이언트에서
열립니다. 테스트하려는 오퍼레이션을 선택하고
필수 정보를 입력한 다음 이동을 클릭하십시오. 결과가 상태 분할창에 표시됩니다. 다음을 클릭하십시오.
- 웹 서비스 프록시 페이지: 프록시를 생성하도록 선택한 경우,
프록시 보안 옵션을 선택하고 네임스페이스 맵핑에 대한 사용자 정의 패키지를
정의할지 여부를 선택하십시오.
- 웹 서비스 클라이언트 네임스페이스에서 패키지로의 맵핑 페이지:
이전 페이지에서, 네임스페이스에서 패키지로의 맵핑을
사용자 정의를 선택한 경우, 이 페이지에서 추가를
클릭하여 사용자 정의 맵핑 쌍을 입력할 수 있습니다.
또는 가져오기를 클릭하여 .properties 파일에서
사용자 정의 맵핑 쌍을 가져올 수 있습니다. 특성 파일의 컨텐츠는
namespace=package 형식이어야 합니다. 특성 파일에서는 일부 특수 문자를 이스케이프 처리해야
합니다. 예를 들어, http://someNamespace=somePackage를
http\://someNamespace=somePackage와 같이 처리해야 합니다. 이렇게 하지 않으면
콜론(:)이 분리 문자로 처리되어 http에서
//someNamespace=somePackage로 맵핑을 시도합니다.
Java에서의 특성 파일 형식에 대한 자세한 정보는
Java 플랫폼 API 문서: java.util.Properties 로드 메소드를 참조하십시오.
- 웹 서비스 클라이언트 테스트 페이지:
- 테스트 기능을 선택하십시오. 생성된 프록시를 유니버셜 테스트 클라이언트 또는 웹 서비스 탐색기에서 테스트하거나,
샘플 웹 서비스 JSP를 생성할 수 있습니다. TCP/IP 모니터를 통해 웹 서비스 트래픽을 라우팅하는 경우, 유니버셜 테스트 클라이언트를 사용하여
웹 서비스를 테스트할 수 없다는 점을 참고하십시오.
- JSP를 통해 프록시를 테스트하도록 선택한 경우
JSP가 위치할 폴더를 선택할 수 있으며 JSP에 포함시킬 메소드를
선택할 수 있습니다.
- 서버에서 테스트 실행을 선택하면 서버가 자동으로
시작됩니다.
- 웹 서비스 공개 페이지: 이 웹 서비스를 UDDI 레지스트리에 공개할지 여부를 선택하십시오.
완료를 클릭하십시오.
결과
웹 서비스를 작성한 후에 선택한 옵션에 따라 다음이 발생할 수 있습니다.
- 웹 서비스 JSP를 사용하여 생성된 프록시를 테스트하도록 선택하면, 웹 브라우저에 프록시가
http://localhost:port/WebProjectClient/sampleBeanName/WebServiceName/TestClient.jsp와 같은
URL로 시작됩니다. 이 샘플 애플리케이션에서 메소드를 선택하고 메소드 값을 입력한 다음 호출을 클릭하여
웹 서비스를 테스트할 수 있습니다.
메소드 결과가 결과 분할창에 표시됩니다.
- 유니버셜 테스트 클라이언트를 사용하여 생성된 프록시를
테스트하도록 선택한 경우, 브라우저 창의
http://localhost:9080/UTC/preload?object=BeanPackage.BeanServiceProxy URL에서 유니버셜 테스트 클라이언트가 실행됩니다.
참조 분할창의 오브젝트 참조에서 프록시 스텁을 펼쳐
웹 서비스 메소드를 표시하십시오. 테스트하려는 메소드를 클릭하고 매개변수 분할창에 값을 입력한
다음 호출을 클릭하십시오. 결과가 아래 생성됩니다.
- 웹 서비스 탐색기를 사용하여 웹 서비스를 테스트하도록 선택한 경우 탐색기가 열립니다. 테스트하려는 오퍼레이션을 선택하고
필수 정보를 입력한 다음 이동을 클릭하십시오. 결과가 상태 분할창에 표시됩니다.
- 웹 서비스를 공개하도록 선택한 경우 웹 서비스 탐색기가 실행되고 웹 서비스를
IBM UDDI Test Registry에 공개하는 데 필요한 페이지가
표시됩니다. 이 태스크를 완료하려면 웹 서비스 공개의 지시사항에
따라 수행하십시오.