================================================================================
Thanks for using gSOAP!
The gSOAP toolkit provides a cross-platform software development toolkit for C
and C++ server and client Web service applications, and simplifies the overall
use of XML in any type of application. The toolkit supports SOAP 1.1/1.2 RPC
encoding and document/literal styles, WSDL 1.1, MTOM/MIME/DIME attachments
(streaming), SOAP-over-UDP, request-response and one-way messaging. The toolkit
also supports WS-Addressing and WS-Security, with several other WS-* available
or under development. See the official open-source gSOAP website
http://gsoap2.sourceforge.net for project status and latest news.
* The gSOAP 'soapcpp2' compiler and code generator and 'stdsoap2' runtime
engine are stable since version release 2.1.3.
* The gSOAP 'wsdl2h' WSDL/schema parser and code generator is stable since
wsdl2h version release 1.1.0. The 'wsdl2h' tool fully supports WSDL 1.1 and
XML schemas.
The software is provided "as is", without any warranty. However, gSOAP
has received a lot of support from users and has been extensively tested
in the real world. We also continue to improve gSOAP and add new features.
================================================================================
WHAT'S COOL?
================================================================================
The gSOAP 'wsdl2h' tool is a gSOAP application itself, which demonstrates the
capabilities of the generic XML handling by the toolkit to parse WSDL, XML
schemas, and SOAP/XML.
The gSOAP toolkit supports streaming technologies to expedite SOAP/XML and
MTOM/MIME attachment transfers of potentially unlimited data lengths.
The gSOAP toolkit is the only toolkit that supports the serialization of native
C and C++ data types directly in XML. You can use it to export and import your
application data in XML without having to write wrapper routines.
The gSOAP toolkit ensures as small memory footprint. XML is a processed as a
transient format and not buffered. Many optimizations have been applied to
reduce resource requirements and to expedite XML parsing.
The gSOAP toolkit provides stand-alone HTTP(S) web server functionality as well
as Apache mod and IIS hooks. Also CGI and FastCGI is possible. A web server
example demonstrating the stand-alone functionality is included in the package.
================================================================================
PACKAGE
================================================================================
This distribution package contains platform-independent source code. Pre-built
'soapcpp2' and 'wsdl2h' binaries are included for the following platforms:
* Win32 i386 compatible
* Linux i386 compatible
* MAC OS X universal
The binaries are located in 'gsoap/bin'.
Important: these 'wsdl2h' binaries use the default configuration without SSL
support (no HTTPS site access).
To configure and build the toolkit binaries and libraries, please see the
installation instructions in the 'INSTALLATION' section below.
================================================================================
INSTALLATION
================================================================================
This part explains how gSOAP is built on your platform.
Requirements to configure and build the package:
1. Automake tools (make and GNU m4) to configure and build
2. Bison http://www.gnu.org/software/bison or the alternative Yacc
3. Flex http://flex.sourceforge.net
4. OpenSSL (for optional HTTPS) http://www.openssl.org
5. Zlib (for optional compression) http://www.zlib.net
6. Pthreads or win32 threads (optional)
The open source licenses for these tools are compatible with gSOAP licensing
under GPL and commercial licensing.
Some example applications won't compile without OpenSSL and Pthreads.
Win32 binaries and project code is included in this package. Win32 users can
start right away without autoconf/automake. The 'soapcpp2.exe' binary compiler
and 'wsdl2h.exe' WSDL parser are included in 'gsoap/bin/win32', see also the
'gsoap/VisualStudio2005' folder for the tool project files. The 'soapcpp2.exe'
and 'wsdl2h.exe' tools are command-line based and should be invoked from within
the IDE to process WSDL, XSD, and gSOAP service specification header files:
.wsdl .xsd --> wsdl2h.exe --> .h (special .h formatted with gSOAP annotations)
.h --> soapcpp2.exe --> .h .c .cpp .xml ...
Symbian instructions and example code is located in 'gsoap/Symbian'.
Palm OS support is no longer available for this release. The latest stable
release with Palm OS support is gSOAP 2.7.8c.
To build gSOAP on your platform using autoconf/automake, please enter the
following commands:
$ ./configure
$ make
$ make install
This will install the executables and libraries on your system (and you need
root access to do so).
To build without OpenSSL support, use:
$ ./configure --disable-openssl
$ make
$ make install
To configure and build the examples, use the --enable-samples option:
$ ./configure --enable-samples
To configure and build the libraries in DEBUG mode, which produces 'SENT.log',
'RECV.log' and 'TEST.log' files for message logs and gSOAP engine event logs,
use:
$ ./configure --enable-debug
If you want to install the executables in your local folder, enter:
$ ./configure
$ make
$ make install exec_prefix=$HOME
To build your projects, you need the following executables:
soapcpp2 the gSOAP stub/skeleton generator
wsdl2h the gSOAP WSDL/schema parser and code generator
These are created after 'make' in 'gsoap/src' and 'gsoap/wsdl'. Note that
pre-built executables for select platforms can be found in 'gsoap/bin'.
You also need the following libraries (build from stdsoap2.c[pp]):
libgsoap++.a C++ runtime
libgsoapck++.a C++ runtime with HTTP cookie support
libgsoapssl++.a C++ runtime with cookies, zlib, and SSL
libgsoap.a C runtime
libgsoapck.a C runtime with HTTP cookie support
libgsoapssl.a C runtime with cookies, zlib, and SSL
This version of gSOAP requires SSL support with OpenSSL 0.9.6 or later.
Alternatively, you can use the stdsoap2.c[pp] source code to build your project
instead of the libraries (libraries are all derived from stdsoap2.c[pp]). See
the gSOAP documentation on how to enable HTTP cookies, Zlib compression, and
SSL support in stdsoap2.c[pp].
For developers: there is a command file ./makemake
It can be used to generate the required ./configure script.
This will create the Makefiles:
$ ./makemake
$ make
You can also execute the following steps from the commandline:
$ aclocal
$ autoheader
$ automake --add-missing
$ autoconf
$ automake
$ ./configure --enable-samples
$ make
If the above fails, try the following:
* remove autom4te.cache
* get the latest config.guess and config.sub from GNU
================================================================================
GETTING STARTED
================================================================================
The gSOAP 'wsdl2h' tool converts WSDLs into a gSOAP header file for processing
with the gSOAP stub/skeleton generator 'soapcpp2' to generate XML
serialization, stubs, and skeletons code to build Web services applications.
Use 'wsdl2h' followed by 'soapcpp2' to translate an entire set of WSDL and XML
schemas into representative C or C++ data structures and associated XML
parsers. You can also use the gSOAP 'soapcpp2' tool directly on existing C/C++
data structure declarations to create XML serialization routines for these
types to simplify the storage of data in XML.
Example translation of WSDL to code in two steps:
$ wsdl2h -s -o calc.h http://www.cs.fsu.edu/~engelen/calc.wsdl
$ soapcpp2 calc.h
The 'calc.h' header file
评论7
最新资源