웹 서비스 마법사가 웹 서비스를 작성하고 배치할 수 있도록 구성하며 웹 서비스를 서버에 배치할 수 있도록
도와 드립니다. 웹 서비스를 배치하면, 마법사가 클라이언트 프록시 및 샘플 애플리케이션을 생성하여
웹 서비스를 테스트할 수 있도록 도와 드립니다. 테스트를 완료하면, 내보내기 마법사를 사용하여
웹 서비스 UDDI 비즈니스 레지스트리에 공개할 수 있습니다.
시작하기 전에
- WebSphere® Application Server를 사용하는 경우
컴퓨터 속도에 따라 시작하는 시간이 달라질 수 있으므로, 웹 서비스 마법사를 실행하기 전에
WebSphere Application Server를 시작하는 것이
좋습니다.
서버를 시작하려면
서버 보기에서 서버를 선택하고(창 > 보기 표시 > 서버) 마우스 오른쪽 단추를
클릭한 다음 시작을 선택하십시오.
- 웹 프로젝트 또는 Java™ 프로젝트의
Java 소스 폴더에 Bean을 작성하거나 가져오십시오.
Bean을 가져오려면 Java 자원: src 폴더를
선택하고 파일 메뉴에서 을 선택한 다음 패키지 위치를 찾으십시오.
이 태스크 정보
IBM® WebSphere JAX-WS 런타임 환경을 사용하여
Bean에서 웹 서비스를 작성하려면 다음을 수행하십시오.
프로시저
- Java EE
퍼스펙티브(창 > 퍼스펙티브 열기 > Java EE)로 전환하십시오.
- 엔터프라이즈 탐색기 보기에서 작성했거나 웹 프로젝트의 소스 폴더로 가져온
Bean을 선택하십시오.
- 파일 > 새로 작성 > 기타를 클릭하십시오. 다양한 웹 서비스 마법사를 표시하려면
웹 서비스를 선택하십시오. 웹 서비스 마법사를 선택하십시오.
다음을 클릭하십시오.
- 웹 서비스 페이지에서 상향식 Java Bean 웹 서비스를
웹 서비스 유형으로 선택하십시오. 다음을 수행하도록 선택할 수도 있습니다.
- 슬라이더를 사용하여 완료할 웹 서비스 개발 단계를 선택하십시오. 이를 수행하면 나머지 마법사 패널에
다음과 같은 여러 기본값이 설정됩니다.
- 개발: 이 단계에서는 웹 서비스의 WSDL 정의 및 구현을 개발합니다. 여기에는 생성된 코드, WSDL 파일, 배치 디스크립터 및
Java 파일이 있는 경우 이를 포함하는
모듈 작성과 같은 태스크가 포함됩니다.
- 어셈블: 이 단계에서는 웹 서비스 또는 클라이언트를 호스팅하는 프로젝트가 대상 애플리케이션 서버에서 필요할 때
EAR에 연관시킵니다.
- 배치: 이 단계에서는 서비스 배치 코드를 작성합니다.
- 설치: 이 단계에서는 대상 서버에 웹 모듈 및 EAR을 설치하고 구성합니다. WSDL 파일의 엔드포인트를 변경해야 하는 경우 이 단계에서 변경합니다.
- 시작: 이 단계에서는 서비스를 서버에 설치하면 서버를 시작합니다.
- 테스트: 이 단계에서는 일반 서비스 클라이언트, 웹 서비스 탐색기
또는 샘플 JSP 등 서비스 테스트에 사용할 수 있는 다양한 옵션을
제공합니다.
- 서버 런타임 선택: 기본 서버가 표시됩니다. 다른 서버에 서비스를 배치하려면 서버 링크를 클릭하여 다른 서버를
지정하십시오.
이 태스크는
다음 서버 런타임 환경을 지원합니다.
- WebSphere Application
Server V7.0 이상
- WebSphere Application
Server Liberty Profile V8.5.5
- 웹 서비스 런타임 선택: 기본 런타임이 표시됩니다. 서비스를 IBM WebSphere JAX-WS
런타임에 배치하려면 런타임 링크를 클릭하고 열린 창에서 이를 선택하십시오.
- 서비스 프로젝트 및 서비스 EAR 프로젝트 선택: 작업공간에서 선택한 프로젝트가 표시됩니다. Java
5.0, Java 6.0
또는 Java 7.0
패싯이 활성화된 웹 프로젝트만 지원됩니다. 다른 프로젝트 및
EAR을 선택하려면 프로젝트 링크를 클릭하거나 이름을 입력하여 마법사가
프로젝트를 작성할 수 있게 하십시오. 클라이언트 웹 프로젝트로 선택한 프로젝트가 서비스 웹 프로젝트와 다른지 또는 클라이언트에서 생성된 아티팩트가
서비스를 겹쳐쓰는지 확인하십시오. JAX-WS 웹 서비스의 경우, 서버와 클라이언트 프로젝트가 동일한 EAR을 공유할 수 있습니다.
- 클라이언트를 작성하려면 생성하려는 프록시 유형을 선택하고 클라이언트에 대해
1 - 4단계를 반복하십시오. 클라이언트는 IBM WebSphere JAX-WS 런타임 환경을 사용하여 WSDL 문서에서 웹 서비스 클라이언트 생성에서 설명된 단계에 따라 이후에 작성할 수 있습니다.
- 웹 서비스 모니터: 이 단계에서는 웹 서비스에서 생성된 SOAP 트래픽을 관찰하고 WS-I 준수를 확인하기 위해 이 트래픽을
테스트할 수 있는 TCP/IP 모니터를 통해 웹 서비스 트래픽을 송신합니다. 또는
웹 서비스 테스트를 위한 TCP/IP 모니터 사용에
설명된 대로 TCP/IP 모니터를 수동으로 설정할 수 있습니다.
- WebSphere JAX-WS
상향식 웹 서비스 구성:
참고: Bean에 이미 @javax.jws.WebService 어노테이션이 있는 경우 마법사가 위임 Bean을 생성하지
않아도 되기 때문에 이 페이지에 있는 대부분 필드는 사용 불가능합니다. WSDL 파일 생성만 선택할 수 있습니다. @javax.jws.WebService만
Java Bean에 추가하고 SOAP 1.2 바인딩이나 MTOM과 같은 기타 옵션을 사용하려는 경우,
마법사를 종료하고 어노테이션을 제거하거나 어노테이션 문서를 사용하여 계속 웹 서비스를
작성해야 합니다. 마법사는 부분적으로 어노테이션이 이미 있는 기존 Bean에 새 어노테이션을 추가할 수 없습니다.
- WebSphere JAX-WS
WSDL 인터페이스 구성 페이지: 이전 페이지에서 WSDL 파일을 생성하도록 선택한 경우 이 페이지가 표시되고 생성된 WSDL 파일을 구성할 수 있습니다. 다음을
구성할 수 있습니다.
- WSDL 대상 네임스페이스
- WSDL 서비스 이름
- WSDL 포트 이름
- 웹 서비스 테스트 페이지: 웹 서비스를 테스트하도록 선택한 경우, 생성된 웹 서비스를 위한 테스트 기능을 선택하고
실행을 클릭하십시오. 그러면 웹 서비스가 웹 서비스 탐색기 또는 일반 서비스 클라이언트에서
열립니다. 테스트하려는 오퍼레이션을 선택하고
필수 정보를 입력한 다음 이동을 클릭하십시오. 결과가 상태 분할창에 표시됩니다. 다음을 클릭하십시오.
- WebSphere JAX-WS 웹 서비스
클라이언트 구성 페이지: 클라이언트를 생성하도록 선택한 경우 이 페이지에서 다음 옵션을 지정할 수 있습니다.
- 출력 폴더: 클라이언트 코드가 생성되는 위치입니다.
- 대상 패키지: 웹 서비스 클라이언트 마법사는 여러 개의 Java 파일을
생성합니다. 기본적으로
WSDL 파일에서 지정된 네임스페이스에 따라 패키지 이름을
작성합니다. 이 기본 동작을
재정의하기 위해 자체 패키지 이름을 지정할 수 있습니다.
- 이식 가능 클라이언트 생성: 이 선택란을 선택하면 한 시스템에서 다른 시스템으로 또는
WebSphere Application Server의 한 인스턴스에서
다른 인스턴스로 웹 서비스 클라이언트 코드를 이동할 수 있습니다. 이 옵션이 선택되면 WSDL 문서와 이 문서가 종속된
모든 XML 스키마 및 기타 WSDL 문서가 WEB-INF/wsdl 아래의 클라이언트 프로젝트에
복사되며 이 사본을 가리키는 file:relativeURL이 JAX-WS 서비스
클래스의 정적 초기화 블록에 삽입됩니다.
- 생성된 클라이언트에 대해 비동기 호출 사용: 비동기 클라이언트를 사용 가능하게 선택한 경우,
웹 서비스의 각 메소드에 대해 두 개의 추가 메소드가 작성됩니다. 이 메소드는 클라이언트가 비동기로
기능할 수 있도록 하는 폴링 및 콜백 메소드입니다.
- JAX-WS 또는 JAXB 바인딩 파일 지정: JAX-WS 또는 JAXB 사용자 정의 바인딩 파일을 작성하는 경우에
웹 서비스 클라이언트를 작성하도록 사용하려면 이 선택란을 선택하십시오. 이를 선택하면 마법사의
다음 페이지에서 사용자 정의 바인딩 선언 파일을 찾을 수 있습니다.
- 클라이언트 프록시 클래스 이름 사용자 정의: 기본 포트 이름을 서비스 구현 클래스 이름 맵핑으로
변경하려면 이 선택란을 선택하십시오.
- 바인딩 선언 사용자 정의 페이지: JAX-WS 또는 JAXB 바인딩 파일을 지정하도록 선택한 경우 이 페이지에서 파일을 찾을 수 있습니다.
- 프록시 생성 구성 페이지: 정의된 각 포트에 대해 프록시 클래스 이름을 입력하거나 기본값을 허용할 수 있습니다.
- 웹 서비스 클라이언트 테스트 페이지:
- 생성된 프록시 테스트: 선택한 경우 샘플 클라이언트가 웹 브라우저에서 실행되어 기능을 테스트할 수 있습니다.
- 테스트 기능을 선택하십시오.일반 서비스 클라이언트 또는 웹 서비스 탐색기에서
생성된 프록시를 테스트할 수 있거나 샘플
JAX-WS 2.0 JSP를 생성하고 사용할 수 있습니다.
- 폴더: JSP를 통해 프록시를 테스트하도록 선택한 경우 JSP가 배치되는 폴더를 선택할 수 있고
JSP에 포함되는 메소드를 선택할 수 있습니다.
- 메소드: 표시할 메소드를 선택하십시오. 비동기 호출을 사용 가능하도록 선택하면 비동기 메소드도
나열되어야 합니다.
- 서버에서 테스트 실행: 자동으로 서버를 시작합니다.
결과
웹 서비스를 작성한 후에 선택한 옵션에 따라 다음이 발생할 수 있습니다.
- 웹 서비스 JSP를 사용하여 생성된 프록시를 테스트하도록 선택하면, 웹 브라우저에 프록시가
http://localhost:port/WebProjectClient/sampleBeanName/WebServiceName/TestClient.jsp와 같은
URL로 시작됩니다. 이 샘플 애플리케이션에서 메소드를 선택하고 메소드 값을 입력한 다음 호출을 클릭하여
웹 서비스를 테스트할 수 있습니다.
메소드 결과가 결과 분할창에 표시됩니다.
- 유니버셜 테스트 클라이언트를 사용하여 생성된 프록시를 테스트하도록 선택한 경우 브라우저 창에서
http://localhost:port/UTC/preload?object=BeanPackage.BeanServiceProxy와 같은 URL과 유사하게 실행됩니다. 오브젝트에서
프록시 스텁을 펼쳐서 웹 서비스 메소드를 표시하십시오. 테스트하려는 메소드를 클릭하고 매개변수 분할창에 값을 입력한
다음 호출을 클릭하십시오. 결과는 자동으로 생성됩니다.
- 웹 서비스 탐색기를 사용하여 웹 서비스를 테스트하도록 선택한 경우 탐색기가 열립니다. 테스트하려는 오퍼레이션을 선택하고
필수 정보를 입력한 다음 이동을 클릭하십시오. 결과가 상태 분할창에 표시됩니다.
제한사항: 별도의 JAR 파일에 있는 다른 클래스에 종속된 클래스 파일에서 JAX-WS 웹 서비스를 생성할 경우, 프로젝트가
Java EE 모듈 종속 항목 또는 사용자 라이브러리에서 해당 외부 jar 파일을
참조해야 합니다. jar이 EAR 프로젝트에 포함된 경우
Java EE 모듈 종속 항목을 사용할 수 있습니다.
jar이 WebSphere Application Server에 구성된
공유 라이브러리의 일부인 경우, 웹 서비스를 생성하기 전에 사용자 라이브러리를 사용하여
개발할 프로젝트를 구성해야 합니다. 프로젝트에 사용자 라이브러리를 추가하려면 다음을 수행하십시오.
- 프로젝트를 마우스 오른쪽 단추로 클릭하고
를 클릭하십시오.
- 를 클릭하십시오.
- 사용자 라이브러리를 작성하고 유틸리티 JAR 파일을 추가하십시오.