WebSphere Application Server Version 6.1 Feature Pack for
Web Services provides a thin Java 2 Platform, Standard Edition (J2SE)
Web services client runtime implementation that is based on the Java
API for XML-based Web Services (JAX-WS) 2.0 specification. The Thin
Client for JAX-WS with WebSphere Application Server is a stand-alone
J2SE client environment that enables running unmanaged JAX-WS Web
services client applications in a non-WebSphere Application server
environment to invoke Web services that are hosted by the application
server.
Before you begin
Supported configurations: The Thin Client for JAX-WS with WebSphere Application
Server is a small embeddable J2SE client run time that you can use
as a stand-alone client run time in a pure J2SE environment, or in
an OSGi environment. The Thin Client for JAX-WS is not supported
when running within WebSphere Application Server or client environments
and you must not have any other Thin Client run times provided with
the application server in the CLASSPATH.
sptcfg
Before you set up
a JAX-WS unmanaged client execution environment, obtain the Thin Client
for JAX-WS jar file. To obtain the Thin Client for JAX-WS, install
the Feature Pack for Web Services. The Thin Client for JAX-WS jar
file, com.ibm.jaxws.thinclient_6.1.0.jar, is located
in the app_server_root\runtimes directory.
Copy
the Thin Client for JAX-WS, com.ibm.jaxws.thinclient_6.1.0.jar file,
to other machines to create a lightweight client environment that
enables communications with the product and the Version 6.1 Feature
Pack for Web Services. Copies of the Thin Client for JAX-WS are subject
to the same terms and conditions of the license agreement for the
Version 6.1 Feature Pack for Web Services where you obtained the Thin
Client for JAX-WS. Refer to the license agreements for correct usage
and other limitations.
The Thin Client for JAX-WS is supported
in the following environments:
- IBM® Software Development Kits (SDKs) Version
1.5
- non-IBM SDKs V1.5 with the following limitations:
- Secure Sockets Layer (SSL) limitation on non-IBM SDKs
SSL is
not supported with the Sun JDK or other non-IBM SDKs.
- Xerces limitation on non-IBM SDKs
You must download Xerces-J
Version 2.6.2, and add the file to the classpath when setting up the
Thin Client for JAX-WS environment.
- Equinox 3.2.1 OSGi runtime environments
About this task
Set up a Thin Client for JAX-WS environment by completing
the following steps.
Procedure
- Configure the path. Enter the following command
to add the Java bin directories to your path:
set PATH=<your_JDK_bin_directory>;%PATH%
export PATH=<your_JDK_bin_directory>:$PATH
- Configure the classpath.
- Add the Thin Client for JAX-WS jar file to the classpath definition.
set CLASSPATH=.;<your_jax-ws_thin_client_install_directory>\com.ibm.jaxws.thinclient_6.1.0.jar;<your_application_jars>;%CLASSPATH%
export CLASSPATH=.:<your_jax-ws_thin_client_install_directory>/com.ibm.jaxws.thinclient_6.1.0.jar:<your_application_jars>;$CLASSPATH
- If you are using a non-IBM SDK, obtain a Xerces xml-apis.jar file
and xercesImpl.jar file from the Xerces Web site,
and configure the classpath definition.
set CLASSPATH=.;<your_Xerces_install_directory>\xml-apis.jar;<your_Xerces_install_directory>\xercesImpl.jar;%CLASSPATH%
export CLASSPATH=.:<your_Xerces_install_directory>/xml-apis.jar:<your_Xerces_install_directory>\xercesImpl.jar:$CLASSPATH
- Enter the following command to run your client application:
%JAVA_HOME%\bin\java <your_client_application>
$JAVA_HOME/bin/java <your_client_application>
Results
You have set up an unmanaged JAX-WS client runtime environment
to invoke Web services hosted on a WebSphere Application Server.