1WSDL2AWS(1)                    AWS User's Guide                    WSDL2AWS(1)
2
3
4

NAME

6       wsdl2aws - Generate stubs and skeletons for web services
7

SYNOPSIS

9       wsdl2aws [options] URL
10

DESCRIPTION

12       The  Ada  Web Server is a library that allows you to embed a web server
13       into your Ada application.  It provides not only HTTP  but  also  SOAP,
14       WSDL and several other facilities.  Thus you can write full-fledged web
15       applications.
16
17       WSDL (Web Service Definition Language) is  a  language  based  on  XML.
18       WSDL  documents  describe,  in  a formal way, the interface to Web Ser‐
19       vices. This description consists of the end-point (URL  to  the  server
20       offering the service), the SOAPAction (needed to call the remote proce‐
21       dure), the procedure names and a description of the  input  and  output
22       parameters.
23
24       Using  wsdl2aws,  you  can create both the client and server sides of a
25       Web Service.  On both sides, the generated code handles marshalling and
26       unmarshalling  of  parameters  and return values, so you do not have to
27       deal with SOAP directly.
28
29       The client side is an Ada package that contains stubs  for  the  remote
30       subprograms declared by the WSDL document.  These stubs call the remote
31       subprograms using SOAP.
32
33       The server side is another package consisting of  skeleton  implementa‐
34       tions of these subprograms.
35
36       The URL points to the WSDL document to be processed.
37

OPTIONS

39       -a     Generate  using  Ada style names. For example `getPrice' will be
40              converted to `Get_Price'. This formatting is done for  packages,
41              routines and formal parameters.
42
43
44       -cb    Generate a SOAP dispatcher callback routine for the server. This
45              dispatcher routine contains the code to handle  all  the  opera‐
46              tions  as described in the WSDL document. You need also to spec‐
47              ify the -types option, see below.
48
49
50       -cvs   Add CVS id tag in every generated file.
51
52
53       -doc   Handle document style binding as RPC  ones.  This  is  sometimes
54              needed  because  some  WSDL  documents  specify a document style
55              binding even though it is really an RPC one.
56
57
58       -f     Force creation of the file. Overwrite any exiting files with the
59              same name.
60
61
62       -main filename
63              Specify  the name of the server's procedure main to generate. If
64              file filename.amt (Ada Main Template) is present, it  uses  this
65              template  file  to generate the main procedure. The template can
66              reference the following variable tags:
67
68
69              SOAP_SERVICE
70                     The name of the service as described into the WSDL  docu‐
71                     ment. This tag can be used to include the right units
72
73                                with @_SOAP_SERVICE_@.Client;
74                                with @_SOAP_SERVICE_@.CB;
75
76
77              SOAP_VERSION
78                     The AWS SOAP version.
79
80
81              BAWS_VERSION
82                     The AWS version.
83
84
85              UNIT_NAME
86                     The  name  of the generated unit. This is the name of the
87                     procedure that will be created.
88
89                          procedure @_UNIT_NAME_@ is
90                          begin
91                             ...
92
93
94       -noskel
95              Do not generate skeletons, only stubs.
96
97
98       -nostub
99              Do not generate stubs, only skeletons.
100
101
102       -o name
103              Specify the name of the local WSDL document. This option can  be
104              used only when using a Web WSDL document (i.e. passing an URL to
105              wsdl2aws).
106
107
108       -pp password
109              User password for the proxy if proxy authentication required.
110
111
112       -proxy nameIP
113              Use this proxy to access the WSDL document and generate code  to
114              access  to  these  Web Services via this proxy. The proxy can be
115              specified by its DNS name or IP address.
116
117
118       -pu name
119              User name for the proxy if proxy authentication required.
120
121
122       -q     Quiet mode (no output).
123
124
125       -s     Skip non supported SOAP routines.  By  default,  wsdl2aws  exits
126              with  an  error  when  a problem is found while parsing the WSDL
127              document. This option is useful to skip routines using non  sup‐
128              ported types and still be able to compile the generated files.
129
130
131       -types spec
132              Specify  the  name of the spec containing the Ada implementation
133              of the SOAP routines. This is used for example by the -cb option
134              above  to instantiate all the server side SOAP callbacks used by
135              the main SOAP dispatcher routine.
136
137
138       -v     Verbose mode, display the parsed spec.
139
140
141       -v -v  Verbose mode, display the parsed spec and  lots  of  information
142              while parsing the WSDL document.
143
144
145       -wsdl  Add WSDL document as comment into the generated root unit.
146
147

SEE ALSO

149       ada2wsdl(1), awsres(1)
150
151       The Ada Web Server User's Guide in package aws-doc.
152

AUTHOR

154       wsdl2aws  was  written  by  Dmitriy Anisimkov <anisimkov@yahoo.com> and
155       Pascal Obry <p.obry@wanadoo.fr> as part of the Ada Web Server.
156
157       This    manual    page    was     written     by     Ludovic     Brenta
158       <ludovic.brenta@insalien.org> for Debian GNU/Linux.
159
160       adopted by Pavel Zhukov <landgraf@fedoraproject.org> for Fedora Project
161
162
163
164GNU Ada Tools                     11 JUN 2004                      WSDL2AWS(1)
Impressum