Running an unmanaged Web services JAX-RPC client

WebSphere® Application Server Version 6.1 and the Application Client for WebSphere Application Server Version 6.1 provides a thin Java 2 Platform, Standard Edition (J2SE) Web services client runtime implementation that is based on the Java API for XML-based RPC (JAX-RPC) 1.1 specification. The Thin Client for JAX-RPC with WebSphere Application Server is a stand-alone J2SE client environment that enables running unmanaged JAX-RPC Web services client applications in a non-WebSphere environment to invoke Web services that are hosted by the application server.

Before you begin

Supported configurations Supported configurations: You can use the Thin Client for JAX-RPC with WebSphere Application Server as a stand-alone client run time in a pure Java SE environment, or within an OSGi environment. The Thin Client for JAX-RPC is not supported running within WebSphere Application Server or WebSphere Application Client environments. You must not have any other Thin Client run times provided with the application server in the CLASSPATH.sptcfg

Before you can set up a JAX-RPC unmanaged client execution environment you will need to obtain the Thin Client for JAX-RPC jar file. To obtain the Thin Client for JAX-RPC, you must either install the application server or install the application server or the application client.

The Thin Client for JAX-RPC jar file, com.ibm.ws.webservices.thinclient_6.1.0.jar, is located in the app_server_root\runtimes directory. Refer to the license agreements to ensure correct usage and for limitations on copies of the Thin Client for JAX-RPC outside of the WebSphere environment.

The Thin Client for JAX-RPC is supported in the following environments:
  • IBM® Software Development Kits (SDKs) V1.5
  • Oracle Java Development Kit (JDK) V1.5 that are packaged by IBM
  • non-IBM SDKs V1.5 with these limitations:
    • Secure Sockets Layer (SSL) limitation on non-IBM SDKs

      The Thin Client for JAX-RPC has a dependency on the IBM Java Secure Socket Extension (JSSE2) provider. The Oracle JDK prevents a vendor-acquired JSSE provider from being plugged in, which causes SSL not to be supported with the Oracle JDK or other non-IBM SDKs.

    • Xerces limitation on non-IBM SDKs

      If you are using a non-IBM SDK, because of dependencies with the Xerces implementation, you will need to download Xerces-J version 2.6.2 and set it in the classpath before attempting to run the Thin Client for JAX-RPC.

  • Equinox 3.2.1 OSGi runtime environments

About this task

Supported configurations Supported configurations: WS-Addressing is not supported for JAX-RPC Web services in an unmanaged client environment. If you need to use WS-Addressing, or a Web service standard that relies on WS-Addressing, such as WS-Notification, you must use the Thin Client for Java API for XML-based Web Services (JAX-WS) instead. If you use WebSphere Application Server Version 6.1, you must first obtain and install the WebSphere Application Server Version 6.1 Feature Pack for Web Services. sptcfg

Procedure

  1. Configure the path. You can add the Java bin directories to your path by typing:

  2. Configure the classpath.
    • If you are using an SDK or JDK that is provided by IBM, you can add the thin client jar file to the classpath definition.
      export CLASSPATH=.:<your_web_services_thin_client_install_directory>/com.ibm.ws.webservices.thinclient_6.1.0.jar:<your_application_jars>;$CLASSPATH
    • If you are using SSL, add the plugins/com.ibm.ws.security.crypto_6.1.0.jar file to the classpath.
      export CLASSPATH=.:<your_web_services_thin_client_install_directory>/com.ibm.ws.webservices.thinclient_7.0.0.jar:
      /plugins/com.ibm.ws.security.crypto_6.1.0.jar:<your_application_jars>;$CLASSPATH
    • If you are using a non-IBM SDK, first obtain a Xerces xml-apis.jar and xercesImpl.jar from the Xerces Web site and then configure the classpath definition.
      export CLASSPATH=.:<your_Xerces_install_directory>/xml-apis.jar:<your_Xerces_install_directory>\xercesImpl.jar:$CLASSPATH
  3. Run your client application using the following Java command.
    $JAVA_HOME/bin/java <your_client_application>

Results

You have set up an unmanaged JAX-RPC client runtime environment that can be used 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 30, 2013 10:47:11 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-iseries&topic=twbs_wbsthinclient
File name: twbs_wbsthinclient.html