Previous Topic: CA SiteMinder® Web Services Security SDK API Reference MaterialNext Topic: Sample Web Service Client API Java Application


Using the Web Service Client API

This section contains the following topics:

Web Service Client API Members

How to Implement an Application Using the Web Service Client API

Sample Web Service Client API Java Application

Web Service Client API Members

This section provides a brief summary of the classes in the Java XML Agent API. Reference information on all the classes and methods, can be found in the Javadoc.

The Web Service Client API contains four classes that are contained in the package com.netegrity.tm.client.api.

The following table lists all four classes in the Web Service Client API.

Class/Interface

Description

XMLDocument

Wrapper class that encapsulates all XML document processing methods.

Utils

Wrapper class that encapsulates all utilities that assist in key and certificate generation.

HTTPClient

Class that provides methods to post XML documents over HTTP and obtain response message returned from a successful HTTP post.

HTTPSClient

Class that provides methods to post XML documents over HTTPS and obtain response message returned from a successful HTTPS post.

How to Implement an Application Using the Web Service Client API

Note: For a list of operating systems, Java environments, and platforms that the Web Service Client API supports, see the CA SiteMinder® Web Services Security Platform Matrix on the Technical Support site at http://ca.com/support.

To implement an application the Web Service Client API

  1. Review the required software as listed in the accompanying release notes.
  2. Review the sample code.
  3. Write source code for your client application.
  4. Ensure that the XML Agent Content Helper API JAR file is available whenever you compile or run a Web service client application built using the Web Service Client API. The JAR file, soasmapi.jar, is stored in the following locations:

    Add soasmapi.jar to your CLASSPATH setting. When compiling, you can use the -classpath switch.

  5. Compile the application using javac.

    For an example, see java-build.bat or java-build.sh in the sample directory smjavaagentapi.

  6. Run the Web service client application.

More information:

SDK Samples