User Tools

Site Tools


kbws_add

[KBWS] How to add a new service

How to add a new SOAP service to KBWS package using gSOAP toolkit.

Notes

  • This method is available SOAP web-based services that prepare WSDL file.
  • In the following examples, we assume KBWS version is 1.0.8.

Tutorial

In this tutorial, we add a new tool named "new_app" to KBWS package.

  1. Write new ACD file for new service.
    • ACD file is put in "KBWS-1.0.8/acd/new_app.acd"
  2. Write document about new service (for tfm utility).
    • EMBOSS requires two document files (plain text and HTML)
    • Plain text file is put in "KBWS-1.0.8/doc/text/new_app.txt"
    • HTML file is put in "KBWS-1.0.8/doc/html/new_app.html"
  3. Move to "KBWS-1.0.8/include ", and execute following commands.
    • [Mac OSX]
      1. $ ../gsoap/bin/macosx/wsdl2h -c -o [header file name].h [WSDL file URL]
      2. $ ../gsoap/bin/macosx/soapcpp2 -c [header file name].h
    • [Linux]
      1. $ ../gsoap/bin/linux386/wsdl2h -c -o [header file name].h [WSDL file URL]
      2. $ ../gsoap/bin/linux386/soapcpp2 -o [header file name].h
    • [Windows]
      1. $ ../gsoap/bin/win32/wsdl2h -c -o [header file name].h [WSDL file URL]
      2. $ ../gsoap/bin/win32/soapcpp2 -o [header file name].h
  4. Write source code for new service.
    1. Source code should be implemented in C programming language
    2. Source code is put in "KBWS-1.0.8/src/new_app.c"
  5. Edit "Makefile.am" files referring to the existing methods.
    • KBWS-1.0.8/doc/text/Makefile.am
      • Add "new_app.txt" to "pkgdata_DATA" valiable
    • KBWS-1.0.8/doc/html/Makefile.am
      • Add "new_app.html" to "pkgdata_DATA" valiable
    • KBWS-1.0.8/src/Makefile.am
      • Add "new_app" to "bin_PROGRAMS" valiable
      • Add following code
        • "new_app_SOURCES = new_app.c"
  6. Execute following commands in top directory (KBWS-1.0.8/).
    • aclocal -I m4
    • autoconf
    • automake -a
  7. "configure", "make" and "make install".
kbws_add.txt · Last modified: 2014/01/18 07:44 (external edit)