Developing Actuate Information Delivery API applications
To run the BIRT iHub Integration Technology example applications for the Apache Axis 2 client, open a command prompt. Navigate to the Axis Client directory.
In a Windows environment, you can run the file, setClassPath.bat, to set the environment variables needed to access the required source code, compiled classes, libraries, and other resources. setClassPath.bat contains the following environment variable settings:
set SAMPLEBASEDIR=.
set LIBDIR=%SAMPLEBASEDIR%\lib
set AXIS_JAR=%LIBDIR%\axis.jar;%LIBDIR%\commons-discovery.jar;
%LIBDIR%\commons-logging.jar;%LIBDIR%\jaxrpc.jar;%LIBDIR%
\log4j-1.2.4.jar;%LIBDIR%\wsdl4j.jar
set SUN_JAR=%LIBDIR%\activation.jar;%LIBDIR%\mail.jar;%LIBDIR%
\saaj.jar
set XMLPARSER_JAR=%LIBDIR%\xercesImpl.jar;%LIBDIR%
\xmlParserAPIs.jar
set CLASSPATH=%AXIS_JAR%;%SUN_JAR%;%SAMPLEBASEDIR%\build;
%SAMPLEBASEDIR%\source;%XMLPARSER_JAR%;%LIBDIR%\servlet.jar;
In a UNIX environment, you can run the shell script, setClassPath.sh. setClassPath.sh contains the following environment variable settings:
#!/bin/sh
export SAMPLEBASEDIR
export LIBDIR
export AXIS_JAR
export SUN_JAR
export XMLPARSER_JAR
export CLASSPATH
SAMPLEBASEDIR='pwd'
LIBDIR=$SAMPLEBASEDIR/lib
AXIS_JAR=$LIBDIR/axis.jar:$LIBDIR/commons-discovery.jar:$LIBDIR/commons-logging.jar:$LIBDIR/jaxrpc.jar:$LIBDIR/log4j-1.2.4.jar:$LIBDIR/wsdl4j.jar
SUN_JAR=$LIBDIR/activation.jar:$LIBDIR/mail.jar:$LIBDIR/saaj.jar
XMLPARSER_JAR=$LIBDIR/xercesImpl.jar:$LIBDIR/xmlParserAPIs.jar
CLASSPATH=$AXIS_JAR:$SUN_JAR:$SAMPLEBASEDIR/build:$SAMPLEBASEDIR/source:$XMLPARSER_JAR:$LIBDIR/servlet.jar
The following sections describe the use of the Axis TCPMonitor utility to capture SOAP messages and the development process for following types of Actuate Information Delivery API applications:
*Writing a program that logs in to BIRT iHub System
*Catching a SOAP message with Axis TCPMonitor
*Writing a simple administration application
*Performing a search operation
*Writing a batch or transaction application
*Uploading a file
*Downloading a file
*Executing a report
The code examples and explanations in this chapter parallel the code examples and explanations in Chapter 22, “Developing Actuate Information Delivery API applications using Microsoft .NET.”