Running an unmanaged Web services JAX-WS client

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 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

  1. Configure the path. Enter the following command to add the Java bin directories to your path:
    [Windows] [z/OS]
    set PATH=<your_JDK_bin_directory>;%PATH%
    [AIX] [HP-UX] [Solaris] [Linux]
    export PATH=<your_JDK_bin_directory>:$PATH
  2. Configure the classpath.
    • Add the Thin Client for JAX-WS jar file to the classpath definition.
      [Windows] [z/OS]
      set CLASSPATH=.;<your_jax-ws_thin_client_install_directory>\com.ibm.jaxws.thinclient_6.1.0.jar;<your_application_jars>;%CLASSPATH%
      [AIX] [HP-UX] [Solaris] [Linux] [iSeries]
      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.
      [Windows] [z/OS]
      set CLASSPATH=.;<your_Xerces_install_directory>\xml-apis.jar;<your_Xerces_install_directory>\xercesImpl.jar;%CLASSPATH%
      [AIX] [HP-UX] [Solaris] [Linux] [iSeries]
      export CLASSPATH=.:<your_Xerces_install_directory>/xml-apis.jar:<your_Xerces_install_directory>\xercesImpl.jar:$CLASSPATH
  3. Enter the following command to run your client application:
    [Windows] [z/OS]
    %JAVA_HOME%\bin\java <your_client_application>
    [AIX] [HP-UX] [Solaris] [Linux] [iSeries]
    $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.



In this information ...


Related information

IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 1:23:07 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-dist&topic=twbs_jaxwsthinclient
File name: twbs_jaxwsthinclient.html