웹 서비스(J2EE 1.3에서 J2EE 1.4로)

J2EE 1.4 스펙은 새 JAX-RPC 1.0 API를 이용하는 웹 서비스를 지원합니다.

JAX-RPC API는 다음을 통해 서비스 엔드포인트를 지원합니다. J2EE 1.4 스펙은 J2EE 스펙(JSR 109)에 대해 웹 서비스를 지원합니다. JSR 109는 웹 서비스에 대한 배치 요구사항을 정의하며 JAX-RPC 프로그래밍 모델을 사용합니다.
다음 웹 서비스 아티팩트는 J2EE 이주 마법사를 사용하여 이주됩니다.
  • 웹 서비스 설명자
  • 웹 서비스 클라이언트 설명자
  • JAX-RPC 맵핑 설명자

웹 서비스 배치 설명자 이주

J2EE 1.4 스펙 레벨로 이주된 J2EE 1.3 프로젝트에 포함된 모든 웹 서비스 배치 설명자는 JSR-109 V1.0(J2EE 1.3의 경우)에서 J2EE 1.4로 이주됩니다.

웹 서비스 배치 설명자는 JSR-109 V1.0에 정의된 대로 webservices.xmlwebservicesclient.xml과, webservices.xmlwebservicesclient.xml에 언급된 모든 JAX-RPC 맵핑 배치 설명자로 구성되어 있습니다. 다른 J2EE 배치 설명자의 경우와 마찬가지로, 이주를 하면 설명자에 포함된 정보의 구조가 J2EE 1.4에 적합하도록 수정됩니다. 특히 웹 서비스 배치 설명자의 구조 변경은 규정된 이름이 표시되는 방법에 대한 변경입니다. JSR-109 V1.0에서 규정된 이름은 각각 이름 공간 URI 및 이름의 로컬 파트를 포함하는 일련의 두 요소 <namespaceURI><localpart>를 사용하여 표시됩니다. J2EE 1.4에서 규정된 이름은 XML 이름 공간을 사용하는 XMLSchema QName 유형을 기초로 합니다.

각 웹 서비스 배치 설명자의 이주에 대한 자세한 설명은 아래를 참조하십시오.
  • 웹 서비스 설명자(webservices.xml)

    webservices.xml 배치 설명자는 J2EE 웹 서비스를 포함하는 웹 프로젝트에 있습니다. <wsdl-port> 요소 및 <soap-header> 요소 둘 다 규정된 이름을 포함하며 그 컨텐츠는 J2EE 1.4 형식으로 이주됩니다.

    예를 들어, <wsdl-port>가 이주 전에 다음과 같이 표현되는 경우,

    <wsdl-port>
      <namespaceURI>http://addressbook.webservice</namespaceURI>
      <localpart>AddressBook</localpart>
    </wsdl-port>

    이주 후에는 <wsdl-port>가 다음과 같이 제시됩니다.

    <wsdl-port xmlns:pfx="http://addressbook.webservice">pfx:AddressBook</wsdl-port>

    접두부 "pfx"는 이주된 모든 규정된 이름에 대해 이름 공간 접두부로 사용됩니다.

  • 웹 서비스 클라이언트 설명자(webservicesclient.xml)
    webservicesclient.xml 배치 설명자는 J2EE 웹 서비스 클라이언트를 포함하는 J2EE 1.3 웹 프로젝트 및 응용프로그램 클라이언트 프로젝트에 있습니다. J2EE 1.3에서 1.4로 이주하는 중에 webservicesclient.xml 컨텐츠가 이주되어 프로젝트에 대한 배치 설명자로 이동됩니다. 발생하는 프로세스는 다음과 같습니다.
    • 웹 프로젝트의 경우, webserivcesclient.xml의 모든 <service-ref> 요소는 web.xml의 <web-app> 요소 아래로 이동됩니다.
    • 응용프로그램 클라이언트 프로젝트의 경우, webservicesclient.xml의 모든 <service-ref> 요소는 application-client.xml<application-client> 요소 아래로 이동됩니다.
    • Webservicesclient.xml이 삭제되었습니다.

    <service-qname> 요소 및 <soap-header> 요소 둘 다 규정된 이름을 포함하며 그 컨텐츠가 J2EE 1.4 형식으로 이주됩니다. 예를 들어, <service-qname>이 이주 전에 다음과 같이 표현되는 경우,

    <service-qname>
      <namespaceURI>http://addressbook.webservice</namespaceURI>
      <localpart>AddressBookService</localpart>
    </service-qname>

    이주 후에는 <service-qname>이 다음과 같이 제시됩니다.

    <service-qname xmlns:pfx="http://addressbook.webservice">pfx:AddressBookService</service-qname>

    접두부 "pfx"는 이주된 모든 규정된 이름에 대해 이름 공간 접두부로 사용됩니다.

  • JAX-RPC 맵핑 설명자

    webservices.xmlwebservicesclient.xml 배치 설명자는 각각 하나 이상의 JAX-RPC 맵핑 배치 설명자를 참조할 수 있습니다.

    webservices.xml 파일에서 이 참조는 각 <webservice-description> 요소 아래의 <jaxrpc-mapping-file> 요소에 포함됩니다. webservicesclient.xml 파일에서 이 참조는 각 <service-ref> 요소 아래의 <jaxrpc-mapping-file> 요소에 포함됩니다.

    J2EE 1.3에서 1.4로 이주하는 중에 webservices.xmlwebservicesclient.xml에서 참조되는 모든 JAX-RPC 맵핑 배치 설명자가 이주됩니다. 이 이주에는 모든 규정된 이름이 J2EE 1.4 형식으로의 이주도 포함됩니다. (이주된 규정된 이름의 예는 webservices.xmlwebservicesclient.xml에 관한 위의 절을 참조하십시오.)

관련 태스크
보안 웹 서비스 이주
관련 참조
웹 프로젝트(Servlet 레벨 2.3에서 Servlet 레벨 2.4로)
커넥터 프로젝트(JCA 1.0에서 JCA 1.5로)
J2EE 1.3에서 1.4 스펙 레벨로의 이주
피드백
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.