웹 서비스 참조 추가(J2EE 1.4)

J2EE 1.3 스펙부터는 애플리케이션 컴포넌트(애플리케이션 클라이언트, 웹 모듈, EJB 모듈)가 웹 서비스 참조라는 "논리" 이름을 사용하여 외부 웹 서비스에 대한 참조를 정의할 수 있습니다. J2EE 1.3에서는 참조가 모듈의 webservicesclient.xml에 추가됩니다. J2EE 1.4부터는 참조가 배치 디스크립터에 포함됩니다. 배치 디스크립터 편집기를 사용하여 웹 서비스 참조를 정의할 수 있습니다.

이 태스크 정보

배치 시 웹 서비스 참조는 대상 운영 환경에 있는 웹 서비스 인터페이스에 바인딩됩니다.

사용자가 정의하는 각 웹 서비스 참조의 경우 service-ref 요소가 해당 애플리케이션 컴포넌트에 추가됩니다. 웹 서비스 참조는 정의되는 애플리케이션 컴포넌트 또는 엔터프라이즈 Bean으로 범위가 지정되므로 런타임 동안 다른 애플리케이션 컴포넌트에 액세스할 수 없습니다. 기타 컴포넌트는 이름 충돌을 야기하지 않고도 동일한 이름을 가진 웹 서비스 참조를 정의할 수 있습니다.

참고: J2EE 1.4 스펙 레벨 이전의 프로젝트 레벨에서는 워크벤치를 통해 웹 서비스 참조를 정의할 수 있지만 service-ref 요소는 배치 디스크립터에 추가되지 않습니다(application-client.xml, web.xml 또는 ejb-jar.xml). 오히려 웹 서비스 참조는 모듈의 WEB-INF 폴더에 있는 webservicesclient.xml 파일에서 선언됩니다. 예를 들어, 웹 서비스 참조를 J2EE 1.3 애플리케이션 클라이언트에 추가하면 이 참조가 webservicesclient.xml에 추가됩니다. 웹 서비스 참조를 J2EE 1.4 애플리케이션 클라이언트에 추가하면 이 참조는 application-client.xml에 추가됩니다.
팁: EJB 스펙은 Bean의 환경 java:comp/env/service JNDI 컨텍스트의 서비스 하위 컨텍스트에서 모든 웹 서비스 참조를 구성할 것을 권장합니다.

프로시저

  1. J2EE 프로젝트의 배치 디스크립터 편집기에서 참조 추가 마법사를 여십시오.
  2. 서비스 참조를 선택하고 다음을 클릭하십시오.
  3. 작업공간의 웹 서비스 목록에서 참조하려는 웹 서비스를 선택하십시오. 기본 이름은 사용자가 변경할 수 있는 이름 필드에 표시됩니다. 이는 배치 디스크립터에서 service-ref-name 항목의 참조에 대한 이름으로 사용됩니다.

    다음을 클릭하십시오.

  4. 설명 텍스트 영역에 참조에 대한 설명을 입력하십시오.
  5. 네임스페이스 URI 필드에 새 네임스페이스 URI를 입력하십시오. 이 필드에 입력한 값은 배치 디스크립터의 service-qname 항목에서 xmlns:prefix 속성으로 사용됩니다.
  6. 로컬 파트 필드에서 메시지 대상이 메시지를 사용는지 작성하는지 여부를 표시합니다. 이 필드에 입력한 값은 배치 디스크립터에서 service-qname 항목의 값으로 사용됩니다.
    <service-qname xmlns:prefix="http://service.directory">
    		prefix:EmployeeDirectoryService
    </service-qname>
  7. 완료를 클릭하십시오.

피드백