The Middleware as Platform for IT Application Services
First Step Guide
First Step: Getting the Hello sample to work(Linux Version)
Preparing The Execution EnvironmentIf the following software packages are not already installed, download from the appropriate distribution site and install. For testing connections between OpenSOAP, it is not necessary to have the Java environment.
OpenSOAP DownloadDownload the latest OpenSOAP package(opensoap-1.0-xxxxxx.tar.gz) from
Unpacking the packageUnpack the package in the your user directory
Compiling/Installing The PackageIn the top directory of the unpacked package, use
At this point, the OpenSOAP API and OpenSOAP Server(Ref.1) have been installed, and the sample files have been compiled. With the OpenSOAP Server installed, a copy of soapInterface.cgi(Ref.2) can be found in the CGI executable directory.
Ref.1 Using the OpenSOAP Server allows you to send dispatches to services, perform asynchronous messaging and message routing.(See below for details)
Ref.2 soapInterface.cgi is the OpenSOAP Server entry (endpoint) interface.
Running the HelloServiceTo test the samples in the existing directory structure, change directory to samples/Hello, which contains the Hello sample. Using
(The main body of the HelloService generated by the full compile can be found at samples/Hello/.libs/HelloService)
With this situation, using the following command,
http://localhost/cgi-bin/HelloService.cgiand analyses the response.
(The default is not the OpenSOAP Server (soapInterface.cgi))
Ref.3 When changing the endpoint of a message being sent to the OpenSOAP Server, it can be specified on line 70 of the HelloClient.c sample program. After modification, re-make and install the sample program. See below for settings for use with the OpenSOAP Server.
Advice for using an original MakefileIn the above installation procedure, with automatic generation by automake, the package directory structure dependent Makefile is used . An independent Makefile, Hello.mak, is provided in the Hello directory. To create an original Makefile please refer to this.
To use this to install the HelloService, firstly in the directory samples/Hello/, use
Next, to install the sample, use
Using the OpenSOAP ServerThrough the OpenSOAP Server, several services can be used at a single endpoint.
To use the OpenSOAP Server, the endpoint setting of the client is set to
http://localhost/cgi-bin/soapInterface.cgi(As seen above, HelloClient.c is modified.)
In the previous description, messages are sent to
By using the OpenSOAP Server, dispatches to a service, asynchronous messaging and message routing services are possible.
In order to use the OpenSOAP Server, the XML description of
/usr/local/opensoap/etc/ssml/Hello.ssmlgenerated in the previous Hello sample service installation is checked. (See : SSML_Readme.txt)
The ssml file specifies the relationship between the OpenSOAP Server and the service program (/usr/local/opensoap/services/Hello/HelloService).
In the default case, a StdIO type connection is specified when a Hello call to the server is made.
(For a socket type connection, the service must be registered with inetd. (See : RegistService.txt))
A StdIO connection type is where standard I/O is used to communicate directly with the OpenSOAP Server. With these settings, in the file
<operation type ='HelloStdio'>Hello</operation>specifies the connection name to be used.
When the ssml file and server settings have been modified, it is necessary to reload the OpenSOAP Server. At this point, the server should be restarted.
after which the client execution can be tested.
Copyright (C) 2001-2004 Webmasters of www.opensoap.jp. All Rights Reserved.