비관리 웹 서비스 JAX-WS 클라이언트 실행

WebSphere® Application Server에서는 JAX-WS(Java™ API for XML-based Web Services) 2.2 스펙에 기반하는 Java SE 6(Java Platform, Standard Edition 6) 웹 서비스 클라이언트 런타임 구현을 제공합니다. WebSphere Application Server에서 JAX-WS용 씬 클라이언트는 애플리케이션 서버가 호스팅하는 웹 서비스를 호출하기 위해 WebSphere 이외 환경에서 비관리 JAX-WS 웹 서비스 클라이언트 애플리케이션을 실행할 수 있는 독립형 Java SE 6 클라이언트 환경입니다.

시작하기 전에

지원된 구성 지원된 구성: WebSphere Application Server에서 JAX-WS용 씬 클라이언트를 기본(pure) Java SE 환경 또는 OSGi 환경에서 독립형 클라이언트 런타임으로 사용할 수 있습니다. WebSphere Application Server 또는 WebSphere Application Client 환경에서 실행 중인 경우 JAX-WS용 씬 클라이언트는 지원되지 않습니다. 이 버전의 애플리케이션 서버에서 Administration Thin Client를 제외하고 애플리케이션 서버에서 제공하는 기타 씬 클라이언트 런타임은 CLASSPATH에 상주하고 JAX-WS용 씬 클라이언트와 공존할 수 있습니다. sptcfg

JAX-WS 비관리 클라이언트 실행 환경을 설정하기 전에 JAX-WS용 씬 클라이언트 Java 아카이브(JAR) 파일을 확보하십시오. JAX-WS용 씬 클라이언트를 확보하려면 WebSphere Application Server 버전 9.0 또는 Application Client for WebSphere Application Server 버전 9.0를 설치하십시오. JAX-WS용 씬 클라이언트 JAR 파일, com.ibm.jaxws.thinclient_8.5.0.jarapp_server_root\runtimes 디렉토리에 있습니다.

JAX-WS용 씬 클라이언트, com.ibm.jaxws.thinclient_8.5.0.jar 파일 및 endorsed_apis_8.5.0.jar 파일을 다른 시스템으로 복사하여 제품과의 통신을 사용하는 경량형 클라이언트 환경을 작성합니다. JAX-WS용 씬 클라이언트의 사본은 JAX-WS용 씬 클라이언트를 가져온 WebSphere 제품의 라이센스 계약과 동일한 이용 약관에 종속됩니다. 올바른 사용법 및 기타 제한사항에 대한 라이센스 계약을 참조하십시오.

JAX-WS용 씬 클라이언트는 다음 환경에서 지원됩니다.
  • IBM® SDK(Software Development Kit) 버전 6.0
  • 다음 제한사항이 적용되는 IBM 이외 SDK V6.0:
    • IBM 이외 SDK에서 Xerces 제한사항

      Xerces-J 버전 2.6.2를 다운로드하고 JAX-WS용 씬 클라이언트 환경을 설정할 때 클래스 경로에 파일을 추가해야 합니다.

    • IBM SDK 이외 위치에서 WS-SecurityKerberos

      WS-SecurityKerberos는 Sun JDK 또는 기타 IBM 이외 SDK에서 지원되지 않습니다. WS-Security 메시지 레벨 보호를 사용하고 웹 서비스 보안 Kerberos 토큰 프로파일 1.1 스펙에서 설명한 대로, Kerberos 보안 토큰을 사용하는 JAX-WS용 씬 클라이언트 환경에서 실행되는 애플리케이션은 IBM 이외의 JDK에서 올바르게 작동하지 않습니다. 이러한 제한사항은 IBM SDK에서만 사용 가능한 IBM JGSS 제공자에서의 종속성 때문에 존재합니다.

  • Equinox 3.6 OSGi 런타임 환경

이 태스크 정보

다음 단계를 완료하여 JAX-WS용 씬 클라이언트 환경을 설정하십시오.

프로시저

  1. JAX-WS용 씬 클라이언트 파일, com.ibm.jaxws.thinclient_8.5.0.jar을 다른 시스템으로 복사하여 경량형 클라이언트 환경을 작성하십시오.
  2. Java Endorsed Standards 대체 메커니즘을 사용하여 시스템의 JDK에서 사용 가능한 API를 대체하십시오.

    WebSphere Application Server버전 9.0에서 JAX-WS용 씬 클라이언트에는 JAX-WS 2.2 및 JAXB 2.2 구현을 지원하기 위해 JDK에서 사용 가능한 항목보다 최신 상태인 API가 필요하므로 Java Endorsed Standards 대체 메커니즘을 사용하여 시스템에서 사용 중인 기본 JDK API를 대체해야 합니다.

    app_server_root\runtimes\endorsed\endorsed_apis_8.5.0.jar 파일을 기본 디렉토리, JAVA_JRE\lib\endorsed로 복사하십시오. 또는 java.endorsed.dirs 특성을 사용하여 원하는 디렉토리를 지정할 수 있습니다. 대체 디렉토리를 사용하려는 경우 endorsed_apis JAR 파일만 포함하는 것이 우수 사례입니다.

  3. 경로를 구성하십시오. 다음 명령을 입력하여 경로에 Java bin 디렉토리를 추가하십시오.
    [Windows][z/OS]
    set PATH=<your_JDK_bin_directory>;%PATH%
    [AIX][HP-UX][Solaris][Linux]
    export PATH=<your_JDK_bin_directory>:$PATH
  4. 클래스 경로를 구성하십시오.
    • JAX-WS용 씬 클라이언트 JAR 파일을 클래스 경로 정의에 추가하십시오.
      중요사항: 씬 클라이언트가 JMS(Java Message Service)를 사용하는 경우 모든 필수 파일에 대한 항목이 존재하도록 필요한 모든 JAR 파일은 반드시 JSM 및 클라이언트의 클래스 경로에 있어야 합니다. 그렇지 않으면 필수 파일은 설치된 상태로 식별되지 않으며, 사용 준비를 마칩니다.
      [Windows][z/OS]
      set CLASSPATH=.;<your_jax-ws_thin_client_install_directory>\com.ibm.jaxws.thinclient_8.5.0.jar;
      <your_application_jars>;%CLASSPATH%
      [AIX][HP-UX][Solaris][Linux][IBM i]
      export CLASSPATH=.:<your_jax-ws_thin_client_install_directory>/com.ibm.jaxws.thinclient_8.5.0.jar:
      <your_application_jars>;$CLASSPATH
    • IBM 이외의 SDK를 사용하는 경우 Xerces 웹 사이트에서 Xerces xml-apis.jar 파일 및 xercesImpl.jar 파일을 확보하고 클래스 경로 정의를 구성하십시오.
      [Windows][z/OS]
      set CLASSPATH=.;<your_Xerces_install_directory>\xml-apis.jar;<your_Xerces_install_directory>
      \xercesImpl.jar;%CLASSPATH%
      [AIX][HP-UX][Solaris][Linux][IBM i]
      export CLASSPATH=.:<your_Xerces_install_directory>/xml-apis.jar:<your_Xerces_install_directory>
      \xercesImpl.jar:$CLASSPATH
  5. 옵션: 클라이언트에 대한 정책 세트를 구현하십시오.
  6. 클라이언트에 대한 SSL을 구성하십시오.
    1. Java 명령에 다음 시스템 특성을 추가하십시오.
      -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props

      WebSphere Application Server 설치에서 ssl.client.props 파일을 가져와 환경에 맞게 파일을 수정할 수 있습니다. 적어도 사용자의 대상 환경의 위치와 일치하도록 ssl.client.props 파일에서 com.ibm.ssl.keyStorecom.ibm.ssl.trustStore 키 파일의 위치를 업데이트해야 합니다.

      예를 들어, Sun JRE에서 애플리케이션을 실행할 때 이러한 SSL 구성 설정을 사용하십시오.
      com.ibm.ssl.protocol=SSL
      com.ibm.ssl.trustManager=SunX509
      com.ibm.ssl.keyManager=SunX509
      com.ibm.ssl.contextProvider=SunJSSE
      
      com.ibm.ssl.keyStoreType=JKS
      com.ibm.ssl.keyStoreProvider=SUN
      com.ibm.ssl.keyStore=/home/user1/etc/key.jks
      
      com.ibm.ssl.trustStoreType=JKScom.ibm.ssl.trustStoreProvider=SUN
      com.ibm.ssl.trustStore=/home/user1/etc/trust.jks

      애플리케이션이 실행되기 전에 키 저장소 파일과 신뢰 저장소 파일은 Java keytool 유틸리티를 사용하여 작성해야 합니다. 자동 키 파일 생성은 IBM 이외 제품의 JRE에서 지원되지 않습니다.

  7. 클라이언트 애플리케이션을 실행하십시오.
    • endorsed_apis_8.5.0.jar 파일을 JAVA_JRE\lib\endorsed 기본 디렉토리로 복사한 경우 다음 명령을 입력하십시오.
      [Windows][z/OS]
      %JAVA_HOME%\bin\java -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>
      [AIX][HP-UX][Solaris][Linux][IBM i]
      $JAVA_HOME/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>
    • endorsed_apis_8.5.0.jar 파일을 기본 JAVA_JRE\lib\endorsed 디렉토리 이외 디렉토리로 복사한 경우 다음 명령을 입력하십시오.
      [Windows][z/OS]
      %JAVA_HOME%\bin\java 
      -Djava.endorsed.dirs=<directory_that_includes_endorsed_apis_8.5.0.jar> 
      -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>
      [AIX][HP-UX][Solaris][Linux][IBM i]
      $JAVA_HOME/bin/java 
      -Djava.endorsed.dirs=<directory_that_includes_endorsed_apis_8.5.0.jar>
      -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>

결과

WebSphere Application Server에 호스팅된 웹 서비스를 호출하도록 비관리 JAX-WS 클라이언트 런타임 환경을 설정합니다.
문제점 방지 문제점 방지: 다음 명령은 실행 중인 씬 클라이언트의 버전을 표시하는 방법을 보여줍니다.
java -cp (wasHome)/runtimes/com.ibm.jaxws.thinclient_8.5.0.jar com.ibm.ws.webservices.Version
다음 예제에서는 명령의 출력을 보여줍니다.
IBM Web services build: cf021412.02
IBM Web services release: 8.5.5
Time stamp: 5/14/14 21:11:46
gotcha

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



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