Programming Guides › CA SiteMinder® Web Services Security Programming Guide for Java › Using the Web Service Client API › Sample Web Service Client API Java Application

Sample Web Service Client API Java Application

CA SiteMinder® Web Services Security provides a Sample Web Server Client Application that illustrates usage of the Web Service Client APIs. The Web Server Client Application is provided (along with its source code) to give you a better understanding of the APIs. It can also be used during development to test CA SiteMinder® Web Services Security policies and web services, by allowing you to post test XML documents to your protected web servers.

Set Up and Start the Sample Web Service Client Application

The following sections describes how to set up and run the Sample Web Service Client Application.

Perform Initial Setup

Before you run the Sample Web Service Client Application for the first time:

• (Windows) Edit the SDK_install_dir\samples\javaClientAPI\
  sampleapp.bat file:
  • Uncomment and modify the NETE_TXM_ROOT entry to specify the path to SDK_Install_Dir (for example, set NETE_TXM_ROOT=C:\Program Files\CA\SOA Security Manager\SDK).
  • Uncomment and modify the jre entry to specify the path to the jre subfolder of your JDK installation (for example, set jre=c\/jdk1.4.1\jre)
• (UNIX) Modify the SDK_install_dir/samples/javaClientAPI/
  sampleapp.sh file as follows:
  • Set the NETE_TXM_ROOT variable to point to SDK_Install_Dir
  • Set the java variable to point to the Java executable (java.exe), located in the bin subdirectory of your JDK installation.

Configure Values to be Used in the Sample Application

Optionally, you can specify values to be used to fill fields in the sample application by editing the txmclient.properties file. This can be particularly useful when you are using the sample application for testing purposes.

The txmclient.properties file can be found in:

• (Windows) SDK_install_dir\java
• (UNIX) SDK_install_dir/java

Run the Sample Application

To run the sample application

• (Windows) Run sampleapp.bat from SDK_install_dir\samples\javaClientAPI.
• (UNIX) Execute the sampleapp.sh script from SDK_install_dir/samples/javaClientAPI.

Source Code Location

The sample application source code can be found in the following locations:

• (Windows) SDK_install_dir\samples\javaClientAPI
• (UNIX) SDK_install_dir/samples/javaClientAPI