JAX-WS에서 웹 서비스 애플리케이션 구현

기존 JavaBeans 또는 엔터프라이즈 Bean에서 시작하는 경우 JAX-WS(Java™ API for XML-Based Web Services) 프로그래밍 모델에 기반하여 웹 서비스 개발에 대한 상향식 접근 방식을 사용할 수 있습니다.

시작하기 전에

기존의 JavaBeans 또는 JAX-WS 웹 서비스로 게시할 엔터프라이즈 Bean을 판별하십시오.

우수 사례: IBM® WebSphere® Application Server는 JAX-WS(Java API for XML-Based Web Services) 프로그래밍 모델 및 JAX-RPC(Java API for XML-based RPC) 프로그래밍 모델을 지원합니다. JAX-WS는 JAX-RPC 프로그래밍 모델에서 제공되는 기반을 확장하는 차세대 웹 서비스 프로그래밍 모델입니다. 전략적 JAX-WS 프로그래밍 모델을 사용하면 표준 기반 어노테이션 모델의 지원을 통해 웹 서비스 및 클라이언트의 개발이 간소화됩니다. JAX-RPC 프로그래밍 모델과 애플리케이션이 계속해서 지원된다고 해도 구현이 쉬운 JAX-WS 프로그래밍 모델을 이용하여 새 웹 서비스 애플리케이션과 클라이언트를 개발하십시오.

이 태스크 정보

JAX-WS 프로그래밍 모델에 기반하여 웹 서비스를 개발하려는 경우 기존 JavaBeans 또는 엔터프라이즈 Bean에서 시작하여 상향식 개발 접근 방식을 사용하거나 기존 WSDL(Web Services Description Language) 파일에서 시작하여 하향식 개발 접근 방식을 사용할 수 있습니다. 이 태스크에서는 상향식 개발 접근 방식을 사용할 때 단계에 대해 설명합니다.

기존 JavaBeans이나 엔터프라이즈 Bean에서 JAX-WS 웹 서비스 개발을 시작하는 경우 어노테이션을 사용하여 JAX-WS 웹 서비스로 Bean을 표시할 수 있습니다. Bean에 @WebService 또는 @WebServiceProvider 어노테이션을 추가하면 JAX-WS 웹 서비스로 Bean을 정의합니다. JAX-WS 웹 서비스는 선택적으로 서비스 엔드포인트 인터페이스를 사용할 수 있습니다. Bean 및 선택적 서비스 엔드포인트 인터페이스의 어노테이션 작성 외에도 웹 서비스에 필요한 아티팩트를 모두 어셈블하고, 결과로 생성된 애플리케이션을 애플리케이션 서버 환경에 배치하여 Bean을 웹 서비스로 사용하는 프로세스를 완료해야 합니다. WSDL 파일의 사용이 우수 사례로 간주되지만, JAX-WS 웹 서비스에서 WSDL 파일을 패키지하지 않아도 됩니다.

JavaBeans 사용 시 고려사항
  • JAX-WS 웹 서비스로 표시되는 JavaBeans는 HTTP 전송에서만 지원됩니다.
  • JavaBeans는 CDI(Contexts and Dependency Injection)를 사용할 수 있습니다. 생성자 인젝션은 지원되지 않습니다.
엔터프라이즈 Bean 사용 시 고려사항
  • 엔터프라이즈 Bean은 Stateless 또는 싱글톤 세션 Bean이어야 합니다.
  • JAX-WS 웹 서비스로 표시되는 엔터프라이즈 Bean은 EJB 3.0 이상 모듈로 패키지되어야 합니다.
  • 엔터프라이즈 Bean을 포함하는 JAX-WS 애플리케이션은 endptEnabler 명령으로 배치되어야 합니다.
  • 엔터프라이즈 Bean을 포함하는 JAX-WS 웹 서비스는 HTTP 또는 JMS(Java Message Service) 전송에서 지원됩니다.
  • 엔터프라이즈 Bean은 CDI를 사용할 수 있습니다. 생성자 인젝션은 지원되지 않습니다.
  • 선택적으로 JAX-WS 애플리케이션 패키지에 WSDL(Web Services Description Language) 문서를 포함할 수 있습니다.

WebSphere Application Server 버전 7.0 이상을 시작하면 JAX-WS 서비스와 클라이언트를 식별하기 위한 어노테이션을 찾기 위해 Java EE 5 애플리케이션 모듈(웹 애플리케이션 모듈 버전 2.5 이상 또는 EJB 모듈 버전 3.0 이상)을 스캔합니다. 하지만 Java EE 5 이전 애플리케이션 모듈(웹 애플리케이션 모듈 버전 2.4 이하 또는 EJB 모듈 버전 2.1 이하)에서는 성능을 고려하여 기본적으로 JAX-WS 어노테이션을 스캔하지 않습니다. 버전 6.1 Feature Pack for Web Services의 경우 기본적으로 애플리케이션을 설치하는 동안 Java EE 5 이전 웹 애플리케이션 모듈을 스캔하여 JAX-WS 서비스를 식별하고 서비스 클라이언트용 Java EE 5 이전 웹 애플리케이션 모듈 및 EJB 모듈을 스캔합니다. WebSphere Application Server 버전 7.0 이상에서의 기본 동작은 애플리케이션 설치 또는 서버 시작 중에 어노테이션을 찾기 위해 Java EE 5 이전 모듈을 스캔하지 않고 이전 릴리스 기능팩과의 역방향 호환성을 유지하는 것이기 때문에 애플리케이션 설치 및 서버 시작 중에 스캐닝을 요청하려면 EJB 모듈 또는 WAR(Web Application Archive) 파일의 META-INF/MANIFEST.MF에서 UseWSFEP61ScanPolicy 특성을 구성하거나 JVM(Java Virtual Machine) 사용자 정의 특성(com.ibm.websphere.webservices.UseWSFEP61ScanPolicy)을 서버에서 정의해야 합니다. 어노테이션 스캐닝에 대해 보다 자세히 학습하려면 JAX-WS 어노테이션 정보를 참조하십시오.

프로시저

  1. 웹 서비스에 대한 개발 환경을 설정하십시오. Rational® Application Developer를 사용하는 경우 개발 환경을 설정하지 않아도 됩니다.
  2. 어노테이션을 통해 JAX-WS 웹 서비스를 개발하십시오.
  3. JAX-WS 애플리케이션에 대한 Java 아티팩트를 생성하십시오.

    JavaBeans 또는 엔터프라이즈 Bean 컴포넌트에서 시작할 때 JAX-WS 도구를 사용하여 JAX-WS 웹 서비스에 필요한 JAX-WS 및 JAXB 아티팩트를 생성합니다.

    HTTP 전송을 사용하여 호출된 서비스 구현 Bean을 개발하는 경우 이 단계 중 wsgen 명령행 도구로 생성된 WSDL 파일은 선택사항입니다. 그러나 SOAP over JMS 전송을 사용하여 호출된 서비스 구현 Bean을 개발하는 경우 이 단계 중 wsgen 도구로 생성된 WSDL 파일은 후속 단계에 필요하므로 선택사항이 아닙니다.

  4. (선택사항) JAX-WS 웹 서비스에 대한 MTOM을 사용하십시오. SOAP MTOM(Message Transmission Optimization Mechanism)을 사용하여 웹 서비스 요청과 함께 이미지 또는 파일과 같은 2진 첨부 파일의 전송을 최적화할 수 있습니다.
  5. (선택사항) JAX-WS 웹 서비스에서 WSDL 바인딩을 준수하십시오. RespectBindingFeature를 사용하여 엔드포인트와 연관된 wsdl:binding의 컨텐츠를 고려하는 데 JAX-WS 구현이 필요한지 여부를 제어할 수 있습니다.
  6. (선택사항) JAX-WS 애플리케이션에 대한 webservices.xml 배치 디스크립터를 개발 및 구성하십시오. 선택적으로 webservices.xml 배치 디스크립터를 JAX-WS 웹 서비스 내 어노테이션에 지정된 애플리케이션 메타데이터를 대체하거나 기능을 보강할 수 있습니다.
  7. 웹 서비스 애플리케이션의 구현을 완료하십시오.
  8. (선택사항) web.xml 파일에서 URL 패턴을 사용자 정의하십시오. JavaBeans가 JAX-WS 엔드포인트로 표시되는 경우 웹 애플리케이션 아카이브(WAR) 파일에 포함된 web.xml 배치 디스크립터에서 선택적으로 URL 패턴을 사용자 정의할 수 있습니다.
  9. 웹 서비스에 대한 아티팩트를 어셈블하십시오.

    애플리케이션 서버에서 제공하는 어셈블리 도구를 사용하여 Java 기반 웹 서비스 모듈을 어셈블하십시오.

    웹 서비스를 포함하는 엔터프라이즈 Bean이 있는 EAR 파일을 어셈블하는 경우 웹 서비스 엔드포인트 WAR 파일을 생성하도록 배치 전에 endptEnabler 명령행 도구 또는 어셈블리 도구를 사용합니다. 또한 이 도구는 SOAP over JMS(Java Message Service) 또는 SOAP over HTTP 중 웹 서비스를 표시하는 방법을 지정하는 데 사용됩니다.

  10. 애플리케이션 서버에 EAR 파일을 배치하십시오. 이제 JAX-WS 웹 서비스에 대해 구성되고 사용 가능한 EAR 파일을 애플리케이션 서버에 배치할 수 있습니다.
  11. 웹 서비스를 테스트하여 애플리케이션 서버에서 서비스가 작동하는지 확인하십시오.

결과

JAX-WS 애플리케이션을 배치합니다.


주제 유형을 표시하는 아이콘 태스크 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_devwbsjaxws
파일 이름:twbs_devwbsjaxws.html