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:
*Logging in to BIRT iHub System
*Creating a user
*Performing a search operation
*Executing a transaction-based operation
*Uploading a file
*Downloading a file
*Executing a report
*Scheduling a custom event
The code examples and explanations in this chapter parallel the code examples and explanations in the Developing Actuate Information Delivery API applications using Microsoft .NET chapter.
Writing a program that logs in to BIRT iHub System
Capturing SOAP messages using 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