IBM WebSphere JAX-WS 런타임 환경을 사용하여 Java Bean에서 웹 서비스 작성

웹 서비스 마법사가 웹 서비스를 작성하고 배치할 수 있도록 구성하며 웹 서비스를 서버에 배치할 수 있도록 도와 드립니다. 웹 서비스를 배치하면, 마법사가 클라이언트 프록시 및 샘플 애플리케이션을 생성하여 웹 서비스를 테스트할 수 있도록 도와 드립니다. 테스트를 완료하면, 내보내기 마법사를 사용하여 웹 서비스 UDDI 비즈니스 레지스트리에 공개할 수 있습니다.

시작하기 전에

이 태스크 정보

IBM® WebSphere JAX-WS 런타임 환경을 사용하여 Bean에서 웹 서비스를 작성하려면 다음을 수행하십시오.

프로시저

  1. Java EE 퍼스펙티브(창 > 퍼스펙티브 열기 > Java EE)로 전환하십시오.
  2. 엔터프라이즈 탐색기 보기에서 작성했거나 웹 프로젝트의 소스 폴더로 가져온 Bean을 선택하십시오.
  3. 파일 > 새로 작성 > 기타를 클릭하십시오. 다양한 웹 서비스 마법사를 표시하려면 웹 서비스를 선택하십시오. 웹 서비스 마법사를 선택하십시오. 다음을 클릭하십시오.
  4. 웹 서비스 페이지에서 상향식 Java Bean 웹 서비스를 웹 서비스 유형으로 선택하십시오. 다음을 수행하도록 선택할 수도 있습니다.
    1. 슬라이더를 사용하여 완료할 웹 서비스 개발 단계를 선택하십시오. 이를 수행하면 나머지 마법사 패널에 다음과 같은 여러 기본값이 설정됩니다.
      • 개발: 이 단계에서는 웹 서비스의 WSDL 정의 및 구현을 개발합니다. 여기에는 생성된 코드, WSDL 파일, 배치 디스크립터 및 Java 파일이 있는 경우 이를 포함하는 모듈 작성과 같은 태스크가 포함됩니다.
      • 어셈블: 이 단계에서는 웹 서비스 또는 클라이언트를 호스팅하는 프로젝트가 대상 애플리케이션 서버에서 필요할 때 EAR에 연관시킵니다.
      • 배치: 이 단계에서는 서비스 배치 코드를 작성합니다.
      • 설치: 이 단계에서는 대상 서버에 웹 모듈 및 EAR을 설치하고 구성합니다. WSDL 파일의 엔드포인트를 변경해야 하는 경우 이 단계에서 변경합니다.
      • 시작: 이 단계에서는 서비스를 서버에 설치하면 서버를 시작합니다.
      • 테스트: 이 단계에서는 일반 서비스 클라이언트, 웹 서비스 탐색기 또는 샘플 JSP 등 서비스 테스트에 사용할 수 있는 다양한 옵션을 제공합니다.
    2. 서버 런타임 선택: 기본 서버가 표시됩니다. 다른 서버에 서비스를 배치하려면 서버 링크를 클릭하여 다른 서버를 지정하십시오.
      이 태스크는 다음 서버 런타임 환경을 지원합니다.
      • WebSphere Application Server V7.0 이상
      • WebSphere Application Server Liberty Profile V8.5.5
    3. 웹 서비스 런타임 선택: 기본 런타임이 표시됩니다. 서비스를 IBM WebSphere JAX-WS 런타임에 배치하려면 런타임 링크를 클릭하고 열린 창에서 이를 선택하십시오.
    4. 서비스 프로젝트 및 서비스 EAR 프로젝트 선택: 작업공간에서 선택한 프로젝트가 표시됩니다. Java 5.0, Java 6.0 또는 Java 7.0 패싯이 활성화된 웹 프로젝트만 지원됩니다. 다른 프로젝트 및 EAR을 선택하려면 프로젝트 링크를 클릭하거나 이름을 입력하여 마법사가 프로젝트를 작성할 수 있게 하십시오. 클라이언트 웹 프로젝트로 선택한 프로젝트가 서비스 웹 프로젝트와 다른지 또는 클라이언트에서 생성된 아티팩트가 서비스를 겹쳐쓰는지 확인하십시오. JAX-WS 웹 서비스의 경우, 서버와 클라이언트 프로젝트가 동일한 EAR을 공유할 수 있습니다.
    5. 클라이언트를 작성하려면 생성하려는 프록시 유형을 선택하고 클라이언트에 대해 1 - 4단계를 반복하십시오. 클라이언트는 IBM WebSphere JAX-WS 런타임 환경을 사용하여 WSDL 문서에서 웹 서비스 클라이언트 생성에서 설명된 단계에 따라 이후에 작성할 수 있습니다.
    6. 웹 서비스 모니터: 이 단계에서는 웹 서비스에서 생성된 SOAP 트래픽을 관찰하고 WS-I 준수를 확인하기 위해 이 트래픽을 테스트할 수 있는 TCP/IP 모니터를 통해 웹 서비스 트래픽을 송신합니다. 또는 웹 서비스 테스트를 위한 TCP/IP 모니터 사용에 설명된 대로 TCP/IP 모니터를 수동으로 설정할 수 있습니다.
  5. WebSphere JAX-WS 상향식 웹 서비스 구성:
    • 위임 클래스 이름: 위임 Java 구현의 클래스 이름을 입력하거나 기본값을 허용하십시오. 위임 클래스는 Java Bean의 모든 메소드뿐만 아니라 런타임이 웹 서비스로 인식하는 JAX-WS 어노테이션도 포함하는 랩퍼입니다. 원래 Bean과 동일한 패키지에 생성됩니다.
    • Java에서 WSDL로 맵핑 스타일: 스타일은 웹 서비스와 송수신하는 메시지의 인코딩 유형을 정의합니다. 매개변수 스타일은 메소드 매개변수가 전체 메시지 본문을 나타내는지 또는 매개변수가 오퍼레이션 후에 이름이 지정된 최상위 레벨 요소 내에서 랩핑된 요소인지를 판별합니다. 올바른 조합은 RPC, 문서/랩핑 또는 문서/베어입니다.
    • 메소드 매개변수의 @WebParam 어노테이션 생성: 이 선택란을 선택하면 메소드 선언에 있는 매개변수는 각 인수에서 @WebParam 어노테이션 세트를 가집니다. @WebParam 어노테이션은 웹 서비스 메시지 파트 및 XML 요소에 대한 개별 매개변수의 맵핑을 사용자 정의합니다. @WebParam 어노테이션에 대한 자세한 내용은 WebSphere 애플리케이션 서버에 대한 Information Center에서 찾을 수 있는 JAX-WS 어노테이션 주제에서 javax.jws.WebParam을 검색하십시오.
      팁: 도구 모음으로 가서 > 환경 설정 > WebSphere > JAX-WS 코드 생성을 선택하여 환경 설정 페이지에서 이 옵션을 기본으로 사용할 수 있습니다. 상향식 섹션 아래에 있는 메소드 매개변수의 @WebParam 어노테이션 생성 선택란을 선택하십시오.
    • SOAP 1.2 바인딩 사용: 이 옵션을 선택하지 않는 경우 SOAP 1.1 바인딩이 사용됩니다. SOAP 1.1과 1.2의 차이점에 대한 추가 정보는 SOAP 개요를 참조하십시오.
    • MTOM 지원 사용: 이 선택란을 선택하면 SOAP MTOM(Message Transmission Optimization Mechanism)이 2진 컨텐츠 전송을 최적화하는 데 사용됩니다. MTOM에 대한 자세한 정보는 MTOM 개요를 참조하십시오.
    • WSDL 파일을 프로젝트에 생성: 위임 클래스 내의 어노테이션은 Bean이 웹 서비스인지를 나타내는 데 사용되기 때문에, 정적 WSDL 파일은 자동으로 프로젝트에 더 이상 생성되지 않습니다. 런타임은 Bean 내부 정보에서 WSDL 파일을 자동으로 생성할 수 있습니다. 웹 서비스에 대해 정적 WSDL 파일을 생성하려면 이 옵션을 선택하십시오. 이는 이후에 클라이언트를 작성하거나 다른 사용자를 위해 WSDL을 공개하려는 경우에 유용하게 사용됩니다. 마법사의 다음 페이지에서 WSDL을 구성할 수 있습니다.
    • 웹 서비스 배치 디스크립터 생성: JAX-WS의 경우, 웹 서비스 배치 정보는 런타임에 의해 동적으로 생성되므로 정적 배치 디스크립터는 더 이상 필요하지 않습니다. 이 선택란를 선택하면 배치 디스크립터가 생성됩니다.
    • 벤더 확장기능 허용: 이 선택란을 선택하는 경우 -extension 옵션이 wsgen 또는 wsimport 명령에 추가됩니다. -extension 옵션은 JAX-WS 사양에서 지정하지 않은 기능을 사용자 정의 확장기능으로 사용 또는 허용하는지 여부를 지정합니다. 확장기능의 사용으로 응용프로그램이 이식 불가능하거나 다른 구현과 상호 운영되지 않을 수 있습니다. 자세한 내용을 보려면 WebSphere Application Server의 Information Center에서 찾을 수 있는 JAX-WS 애플리케이션의 wsgen 명령JAX-WS 애플리케이션의 wsimport 명령 주제를 참조하십시오.
    참고: Bean에 이미 @javax.jws.WebService 어노테이션이 있는 경우 마법사가 위임 Bean을 생성하지 않아도 되기 때문에 이 페이지에 있는 대부분 필드는 사용 불가능합니다. WSDL 파일 생성만 선택할 수 있습니다. @javax.jws.WebService만 Java Bean에 추가하고 SOAP 1.2 바인딩이나 MTOM과 같은 기타 옵션을 사용하려는 경우, 마법사를 종료하고 어노테이션을 제거하거나 어노테이션 문서를 사용하여 계속 웹 서비스를 작성해야 합니다. 마법사는 부분적으로 어노테이션이 이미 있는 기존 Bean에 새 어노테이션을 추가할 수 없습니다.
  6. WebSphere JAX-WS WSDL 인터페이스 구성 페이지: 이전 페이지에서 WSDL 파일을 생성하도록 선택한 경우 이 페이지가 표시되고 생성된 WSDL 파일을 구성할 수 있습니다. 다음을 구성할 수 있습니다.
    • WSDL 대상 네임스페이스
    • WSDL 서비스 이름
    • WSDL 포트 이름
  7. 웹 서비스 테스트 페이지: 웹 서비스를 테스트하도록 선택한 경우, 생성된 웹 서비스를 위한 테스트 기능을 선택하고 실행을 클릭하십시오. 그러면 웹 서비스가 웹 서비스 탐색기 또는 일반 서비스 클라이언트에서 열립니다. 테스트하려는 오퍼레이션을 선택하고 필수 정보를 입력한 다음 이동을 클릭하십시오. 결과가 상태 분할창에 표시됩니다. 다음을 클릭하십시오.
  8. WebSphere JAX-WS 웹 서비스 클라이언트 구성 페이지: 클라이언트를 생성하도록 선택한 경우 이 페이지에서 다음 옵션을 지정할 수 있습니다.
    • 출력 폴더: 클라이언트 코드가 생성되는 위치입니다.
    • 대상 패키지: 웹 서비스 클라이언트 마법사는 여러 개의 Java 파일을 생성합니다. 기본적으로 WSDL 파일에서 지정된 네임스페이스에 따라 패키지 이름을 작성합니다. 이 기본 동작을 재정의하기 위해 자체 패키지 이름을 지정할 수 있습니다.
    • 이식 가능 클라이언트 생성: 이 선택란을 선택하면 한 시스템에서 다른 시스템으로 또는 WebSphere Application Server의 한 인스턴스에서 다른 인스턴스로 웹 서비스 클라이언트 코드를 이동할 수 있습니다. 이 옵션이 선택되면 WSDL 문서와 이 문서가 종속된 모든 XML 스키마 및 기타 WSDL 문서가 WEB-INF/wsdl 아래의 클라이언트 프로젝트에 복사되며 이 사본을 가리키는 file:relativeURL이 JAX-WS 서비스 클래스의 정적 초기화 블록에 삽입됩니다.
    • 생성된 클라이언트에 대해 비동기 호출 사용: 비동기 클라이언트를 사용 가능하게 선택한 경우, 웹 서비스의 각 메소드에 대해 두 개의 추가 메소드가 작성됩니다. 이 메소드는 클라이언트가 비동기로 기능할 수 있도록 하는 폴링 및 콜백 메소드입니다.
    • JAX-WS 또는 JAXB 바인딩 파일 지정: JAX-WS 또는 JAXB 사용자 정의 바인딩 파일을 작성하는 경우에 웹 서비스 클라이언트를 작성하도록 사용하려면 이 선택란을 선택하십시오. 이를 선택하면 마법사의 다음 페이지에서 사용자 정의 바인딩 선언 파일을 찾을 수 있습니다.
    • 클라이언트 프록시 클래스 이름 사용자 정의: 기본 포트 이름을 서비스 구현 클래스 이름 맵핑으로 변경하려면 이 선택란을 선택하십시오.
  9. 바인딩 선언 사용자 정의 페이지: JAX-WS 또는 JAXB 바인딩 파일을 지정하도록 선택한 경우 이 페이지에서 파일을 찾을 수 있습니다.
  10. 프록시 생성 구성 페이지: 정의된 각 포트에 대해 프록시 클래스 이름을 입력하거나 기본값을 허용할 수 있습니다.
  11. 웹 서비스 클라이언트 테스트 페이지:
    • 생성된 프록시 테스트: 선택한 경우 샘플 클라이언트가 웹 브라우저에서 실행되어 기능을 테스트할 수 있습니다.
    • 테스트 기능을 선택하십시오.일반 서비스 클라이언트 또는 웹 서비스 탐색기에서 생성된 프록시를 테스트할 수 있거나 샘플 JAX-WS 2.0 JSP를 생성하고 사용할 수 있습니다.
    • 폴더: JSP를 통해 프록시를 테스트하도록 선택한 경우 JSP가 배치되는 폴더를 선택할 수 있고 JSP에 포함되는 메소드를 선택할 수 있습니다.
    • 메소드: 표시할 메소드를 선택하십시오. 비동기 호출을 사용 가능하도록 선택하면 비동기 메소드도 나열되어야 합니다.
    • 서버에서 테스트 실행: 자동으로 서버를 시작합니다.

결과

웹 서비스를 작성한 후에 선택한 옵션에 따라 다음이 발생할 수 있습니다.
제한사항:

별도의 JAR 파일에 있는 다른 클래스에 종속된 클래스 파일에서 JAX-WS 웹 서비스를 생성할 경우, 프로젝트가 Java EE 모듈 종속 항목 또는 사용자 라이브러리에서 해당 외부 jar 파일을 참조해야 합니다. jar이 EAR 프로젝트에 포함된 경우 Java EE 모듈 종속 항목을 사용할 수 있습니다.

jar이 WebSphere Application Server에 구성된 공유 라이브러리의 일부인 경우, 웹 서비스를 생성하기 전에 사용자 라이브러리를 사용하여 개발할 프로젝트를 구성해야 합니다. 프로젝트에 사용자 라이브러리를 추가하려면 다음을 수행하십시오.
  1. 프로젝트를 마우스 오른쪽 단추로 클릭하고 특성 > Java 빌드 경로 > 라이브러리를 클릭하십시오.
  2. 라이브러리 추가 > 사용자 라이브러리 > 사용자 라이브러리를 클릭하십시오.
  3. 사용자 라이브러리를 작성하고 유틸리티 JAR 파일을 추가하십시오.
주제 유형을 표시하는 아이콘 태스크 주제
Information Center의 이용 약관 | 피드백

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

파일 이름: twsbeanjaxws.html