← Back to branch summary

~ifolder-dev/simias/trunk-packaging

« back to all changes in this revision

Viewing changes to tools/gsoap/macosx-2.7/wsdl/.svn/text-base/README.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-2.7/wsdl/.svn/text-base/README.txt.svn-base
1
 
The gSOAP WSDL parser and importer
2
 
 
3
 
INSTRUCTIONS
4
 
 
5
 
The gSOAP WSDL parser converts WSDL into a gSOAP header file for processing
6
 
with the gSOAP soapcpp2 compiler to generate client stubs and server skeletons.
7
 
 
8
 
Example:
9
 
 
10
 
$ wsdl2h -o Amazon.h http://soap.amazon.com/schemas/AmazonWebServices.wsdl
11
 
 
12
 
$ soapcpp2 Amazon.h
13
 
 
14
 
The generated Amazon.h includes the definitions of data types and service
15
 
operations of the Amazon Web service. To develop a C++ client application, you
16
 
can use the generated 'soapAmazonSearchBindingProxy.h' class and
17
 
'AmazonSearchBinding.nsmap' XML namespace table to access the Amazon Web
18
 
service. Both need to be '#include'-d in your source. Then compile and link the
19
 
soapC.cpp, soapClient.cpp, and stdsoap2.cpp sources to complete the build.
20
 
More information can be found in the gSOAP documentation.
21
 
 
22
 
When parsing a WSDL, the output file name is the WSDL input file name with
23
 
extension '.h' instead of '.wsdl'. When an input file is absent or a WSDL file
24
 
from a Web location is accessed, the header output will be produced on the
25
 
standard output. An input file may also contain a schema and will be handled as
26
 
such.
27
 
 
28
 
INPUT
29
 
 
30
 
wsdl2h reads from standard input or the file name provided at the command line:
31
 
 
32
 
wsdl2h [options] [-o outfile.h] [infile.wsdl]
33
 
 
34
 
Valid input file formats are .wsdl and .xsd (schema) files.
35
 
 
36
 
OUTPUT
37
 
 
38
 
The output file is a gSOAP-formatted header file. The header file syntax is
39
 
augmented with annotations reflecting WSDL and schema-specific bindings and
40
 
validation constraints.
41
 
 
42
 
We suggest the use of Doxygen (www.doxygen.org) to produce documented for the
43
 
generated header file. However, we STRONGLY recommend user to inspect the
44
 
generated header file first for warnings and other annotations indicating
45
 
potential problems.
46
 
 
47
 
Note that Doxygen's license model does not infinge on your ownership of the
48
 
gSOAP source code output when you purchased a commercial license.
49
 
 
50
 
COMMAND OPTIONS
51
 
 
52
 
-c      generate pure C header file code
53
 
-e      enum names will not be prefixed
54
 
-f      generate flat C++ class hierarchy for schema extensions
55
 
-i      don't import schemas, but treat them as modules (using -m below)
56
 
-m      create modules for separate compilation
57
 
-nname  use name as the base namespace prefix name instead of 'ns'
58
 
-ofile  output to file
59
 
-p      create polymorphic types with C++ inheritance with base xsd__anyType
60
 
-rhost:port
61
 
        connect via proxy host and port
62
 
-s      do not generate STL code (no std::string and no std::vector)
63
 
-tfile  use type map file instead of the default file typemap.dat
64
 
-v      verbose output
65
 
-?      help
66
 
 
67
 
DOCUMENTATION
68
 
 
69
 
See soapdoc2.pdf for documentation.
70
 
 
71
 
TYPEMAP FILE
72
 
 
73
 
The 'typemap.dat' file can be used to provide custom type mappings for binding
74
 
XML schema types to C and/or C++ types. The WSDL parser 'wsdl2h' can be used
75
 
without the 'typemap.dat' file, because and internal table is used to associate
76
 
XML schema types to C or C++ types (for C, use the -c option).
77
 
 
78
 
The 'typemap.dat' file also allows you to change the generation of the 'ns1',
79
 
'ns2', 'ns3', ... namespace prefixes with custom names.
80
 
 
81
 
INSTALLATION
82
 
 
83
 
Type 'make' in the 'wsdl' directory to build wsdl2h. You must first install the
84
 
gSOAP package and build the gSOAP compiler soapcpp2 to rebuild the wsdl2h WSDL
85
 
parser.
86
 
 
87
 
USING SSL FOR HTTPS
88
 
 
89
 
You must build the WSDL parser with 'make secure' to build an SSL-enabled
90
 
version of wsdl2h that can access HTTPS secure sites.
91
 
 
92
 
LICENSE
93
 
 
94
 
The gSOAP WSDL parser 'wsdl2h' and source code are released under the GPL.
95
 
See gpl.txt for more details. A commercial license is available from Genivia.
96
 
Please contact Genivia (contact@genivia.com) for more details.
97
 
 
98
 
COPYRIGHT NOTICE
99
 
 
100
 
gSOAP XML Web services tools
101
 
Copyright (C) 2001-2004, Robert van Engelen, Genivia, Inc. All Rights Reserved.