This tutorial from Malinda Kaushalye Kapuruge, is for an absolute beginner, sniffing around wanting to try WSO2 Web Services Framework for C. It contains basic information on the WSF/C framework and a detailed description on installation, executing samples and using different tools.

Applies To

Table of Contents

• What is WSO2 WSF/C? [0]
• WSO2 WSF/C and Apache projects [0]
• Setting WSF/C in your machine [0]
• Important directories [0]
• How to run the server [0]
• How to run a client [0]
• Spying the wire content [0]
• WSO2 WSF/C with httpd [0]
• Conclusion [0]
•  

WSF/C v 1.2.0 [1] released in January 2008.

 

Prerequisites:

In order to follow this tutorial, the following packages must also be installed in your system:

• Libxml2 - http://www.xmlsoft.org/ [2]
• libiconv - http://www.gnu.org/software/libiconv/ [3]
• zlib - http://www.zlib.net/ [4]
• Microsoft VSExpress2005 edition and Platform SDK (If Win32)
• OpenSSL - http://www.openssl.org/ [5] (For Web services security samples)
• Either SQLite - http://www.sqlite.org/ [6] or MySQL - http://www.mysql.org/ [7] - (Required for WS-ReliableMessaging with Apache Sandesha2/C) 

UNIX

Following steps will install WSF/C in your UNIX box:

1. Extract the source package to any directory. Let's say /home/bob/wsfc
2. Set the WSFC_HOME environment variable use following commands:
   1. % WSFC_HOME='/home/bob/wsf/c/deploy' (You are free to choose any location)
   2. % Export WSFC_HOME
      
      To make sure that it's done, use % echo $WSFC_HOME. This should give you the path you configured in the earlier step.
3. Now go back to the directory where you extracted the source package and build the source
   1. % ./configure --prefix=${WSFC_HOME}
   2. % make
   3. % make install
   4. % make samples

WIN32

Following steps will install WSO2 WSF/C in your Windows machine from the source:

1. Extract the source package to any directory. Let's say C:\wsfc-src
2. Open the configure.in file
   
   This is where you specify the directories or values for different parameters. Names of these parameter settings are self explanatory. For example, the openssl binaries are specified as follows:
   
   OPENSSL_BIN_DIR= C:\OpenSSL
   
   Please edit the file giving correct configuration parameters.
3. Open a DOS command shell. Go to the source directory
   
   %cd C:\wsfc-src
4. Run build.bat file
   
   %build.bat
   
   If you get a build error, please check settings in the configure.in file.
5. Now see that there is a directory called wsfc-bin created under C:\wsfc-src. Copy this directory to any place where you'd like your WSFC_HOME to be. Let's say we copy and rename it to C:\wsfc
6. Export following environment variables:
   
   % set WSFC_HOME=C:\wsfc
   
   % set PATH=%PATH%;%WSFC_HOME%\lib

WSF/C mailing list [8]. It's advisable to attach the log file in such querying for easy troubleshooting.

 

WSF-C user list [9]to receive updates and details on the framework.

References

1. Apache Axis2/C [10]
2. Apache Rampart/C [11]
3. Apache Sandesha2/C [12]
4. Apache Savan/C [13]
5. WSO2 WSF/C [14]
6. OpenSSL [15]
7. Libxml2 [16]
8. libiconv [17]
9. zlib [18]
10. SQLite [19]
11. MySQL [20]

Author

Malinda Kaushalye Kapuruge is a Senior Software Engineer, WSO2 Inc. kaushalye at wso2 dot com