← Back to branch summary

~ifolder-dev/simias/trunk-packaging

« back to all changes in this revision

Viewing changes to tools/gsoap/macosx-x86-2.7/.svn/text-base/NOTES.txt.svn-base

  • Committer: Jorge O. Castro
  • Date: 2007-12-03 06:56:46 UTC
  • Revision ID: jorge@ubuntu.com-20071203065646-mupcnjcwgm5mnhyt
* Remove a bunch of .svn directories we no longer need.

Show diffs side-by-side

added added

removed removed

Lines of Context:
tools/gsoap/macosx-x86-2.7/.svn/text-base/NOTES.txt.svn-base
1
 
 
2
 
DISTRIBUTION NOTES
3
 
 
4
 
To install gSOAP, unpack the archive. You will get the following files:
5
 
 
6
 
README.txt      read this first
7
 
NOTES.txt       this file
8
 
changelog.html  changes
9
 
license.html    gSOAP public license (HTML)
10
 
license.pdf     gSOAP public license (PDF)
11
 
gpl.txt         GPL license
12
 
soapcpp2        executable gSOAP 2 compiler
13
 
wsdl2h          executable gSOAP WSDL parser
14
 
soapdoc2.html   documentation (HTML)
15
 
soapdoc2.pdf    documentation (PDF)
16
 
stdsoap2.h      header file for stdsoap2.c[pp]
17
 
stdsoap2.c      library and gSOAP runtime
18
 
stdsoap2.cpp    library (identical to stdsoap2.c)
19
 
dom.html        gSOAP DOM parser (HTML)
20
 
dom.pdf         gSOAP DOM parser (PDF)
21
 
dom.h           header file for dom.c
22
 
dom.c           C DOM parser
23
 
dom++.h         header file for dom++.cpp
24
 
dom++.cpp       C++ DOM parser
25
 
stl.h           STL extensions (combines the .h files below)
26
 
stldeque.h      STL deque interface
27
 
stllist.h       STL list interface
28
 
stlvector.h     STL vector interface
29
 
stlset.h        STL set interface
30
 
typemap.dat     XML schema to C/C++ type mapper for WSDL parser
31
 
xml.h           File imported by .h files generated by the WSDL parser
32
 
 
33
 
and the following subdirectories:
34
 
src             gSOAP compiler sources
35
 
samples         examples
36
 
extras          (contributed) extras
37
 
wsdl            WSDL parser sources
38
 
 
39
 
If any of the above files is missing, please contact us: contact@genivia.com
40
 
 
41
 
Examples are included in the 'samples' subdirectory. The examples are:
42
 
 
43
 
calc.h calcclient.c calcserver.c:        Simple calculator client and server
44
 
ck.h ckclient.cpp ckserver.cpp:          Cookie client and server example
45
 
dime.h dimeclt.cpp dimesrv.cpp:          Client and image server using DIME
46
 
factory.h factory.cpp                    Remote object factory and simple ORB
47
 
factorytest.h factorytest.cpp            Test client for remote object factory
48
 
googleapi.h googleapi.c                  Google Web API client
49
 
listing.h listing.cpp:                   XMethod service listing client
50
 
localtime.h localtime.c:                 Get localtime DOC/LIT client example
51
 
lu.h lumat.cpp luclient.cpp luserver.cpp:Linear solver example client+server
52
 
magic.h magicclient.cpp magicserver.cpp: Magic Squares client and server
53
 
magic.h mtmagicserver.cpp:               Multi-threaded Magic Squares server
54
 
mybubble.h mybubble.c:                   MyBubble client
55
 
oneliners:                               Directory with one-line services
56
 
polymorph.h polymorph.cpp:               Polymorphic object exchange
57
 
quote.h quote.c                          Get delayed stock quote
58
 
quote2.h quote2.c                        Get delayed stock quote (SOAP messages)
59
 
quote3.h quote3.cpp                      Get delayed stock quote (Stock class)
60
 
quote4.h quote4.cpp                      Get delayed stock quote using XML DOM
61
 
quotex.h quotex.cpp:                     Combined client/server example
62
 
ssl.h sslclient.c sslserver.c:           SSL example (requires OpenSSL)
63
 
uddi.h uddi.cpp:                         UDDI client
64
 
varparam.h varparam.cpp:                 Variable polymorphic parameters example
65
 
webserver:                               Stand-alone Web server
66
 
 
67
 
To build the example services and clients, type "make" in the 'samples'
68
 
directory (Sun Solaris users should type "make -f MakefileSolaris"). See
69
 
also http://www.cs.fsu.edu/~engelen/soapexamples.html
70
 
for details and explanations for some of these examples.
71
 
 
72
 
For Windows users, the archive includes 'magic_VC' and 'quote_VC' Visual
73
 
Studio projects in the 'samples' directory.
74
 
 
75
 
For Mac users, the archive includes a 'quote_MAC_ProjBuild' Project Builder
76
 
example in the 'samples' directory.
77
 
 
78
 
To try the SSL-secure SOAP server, install OpenSSL and change the occurrences
79
 
of "linprog2.cs.fsu.edu" in sslclient.c and sslserver.c to the machine name
80
 
(or machine IP) you are using. Example .pem files are included but you need to
81
 
create your own .pem files (see OpenSSL documentation).
82
 
 
83
 
The sslclient and sslserver codes can then be build as follows:
84
 
 
85
 
soapcpp2 -c ssl.h
86
 
gcc -DWITH_OPENSSL -o sslclient sslclient.c stdsoap2.c soapC.c soapClient.c -lssl -lcrypto
87
 
gcc -DWITH_OPENSSL -o sslserver sslserver.c stdsoap2.c soapC.c soapServer.c -lssl -lcrypto -lpthread
88
 
 
89
 
DISCLAIMER: WE TRY OUR BEST TO PROVIDE YOU WITH "REAL-WORLD" EXAMPLES BUT WE
90
 
CANNOT GUARANTEE THAT ALL CLIENT EXAMPLES CAN CONNECT TO THIRD PARTY WEB
91
 
SERVICES WHEN THESE SERVICES ARE DOWN OR HAVE BEEN REMOVED.
92
 
 
93
 
The 'wsdlcpp' directory contains the WSDL importer. The importer converts WSDL
94
 
files to .h files.
95
 
 
96
 
Contributions are included in the 'extras' directory:
97
 
 
98
 
GSoapWinInet.h and GSoapWinInet.cpp:
99
 
Allows gsoap to use the WinInet API instead of calls to the socket API. The
100
 
primary benefit of this arrangement is that "if IE works, your program will
101
 
work". There is no need to read proxy settings from the registry, deal with
102
 
proxy configuration scripts, etc. Changes in the "Internet Options" dialog box
103
 
will immediately take effect in your program. Additionally, this will allow
104
 
gsoap to handle forms of authentication not yet supported natively, such as
105
 
NTLM (Integrated Windows Authentication), etc.
106
 
 
107
 
ckdb.h ckdb.c:
108
 
HTTP cookie database load and store operations for persistant cookie support.
109
 
Cookies are saved in XML format using gSOAP's serializers.
110
 
 
111
 
ckdbtest.h ckdbtest.c:
112
 
Test client program for cookie database.
113
 
 
114
 
soapdefs.h logging.cpp:
115
 
C++ message logging with streams.
116
 
 
117
 
plugin.h plugin.c:
118
 
Example plugin. Enables customized message logging.