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.jar은
app_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용 씬 클라이언트 환경을 설정하십시오.
프로시저
- JAX-WS용 씬 클라이언트 파일, com.ibm.jaxws.thinclient_8.5.0.jar을
다른 시스템으로 복사하여 경량형 클라이언트 환경을 작성하십시오.
- 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 파일만 포함하는 것이 우수 사례입니다.
- 경로를 구성하십시오. 다음 명령을 입력하여 경로에
Java bin 디렉토리를 추가하십시오.
![[Windows]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
set PATH=<your_JDK_bin_directory>;%PATH%
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
export PATH=<your_JDK_bin_directory>:$PATH
- 클래스 경로를 구성하십시오.
- 옵션: 클라이언트에 대한 정책 세트를 구현하십시오.
- 클라이언트에 대한 SSL을 구성하십시오.
- Java 명령에 다음 시스템 특성을 추가하십시오.
-Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props
WebSphere Application Server 설치에서
ssl.client.props 파일을 가져와 환경에 맞게 파일을 수정할 수
있습니다. 적어도 사용자의 대상 환경의 위치와 일치하도록
ssl.client.props 파일에서 com.ibm.ssl.keyStore 및
com.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에서 지원되지 않습니다.
- 클라이언트 애플리케이션을 실행하십시오.
- endorsed_apis_8.5.0.jar 파일을
JAVA_JRE\lib\endorsed 기본 디렉토리로 복사한 경우 다음 명령을 입력하십시오.
![[Windows]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
%JAVA_HOME%\bin\java -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
$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]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
%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]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
$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