NAME

       wsdl2aws - Generate stubs and skeletons for web services

SYNOPSIS

       wsdl2aws [options] URL

DESCRIPTION

       The  Ada  Web  Server  is  a library that allows you to embed a web server into your Ada application.  It
       provides not only HTTP but also SOAP, WSDL and several other facilities.  Thus you can write full-fledged
       web applications.

       WSDL  (Web Service Definition Language) is a language based on XML.  WSDL documents describe, in a formal
       way, the interface to Web Services. This description  consists  of  the  end-point  (URL  to  the  server
       offering  the  service),  the SOAPAction (needed to call the remote procedure), the procedure names and a
       description of the input and output parameters.

       Using wsdl2aws, you can create both the client and server sides of a Web Service.   On  both  sides,  the
       generated  code handles marshalling and unmarshalling of parameters and return values, so you do not have
       to deal with SOAP directly.

       The client side is an Ada package that contains stubs for the remote subprograms  declared  by  the  WSDL
       document.  These stubs call the remote subprograms using SOAP.

       The server side is another package consisting of skeleton implementations of these subprograms.

       The URL points to the WSDL document to be processed.

OPTIONS

       -a     Generate  using  Ada  style  names.  For example `getPrice' will be converted to `Get_Price'. This
              formatting is done for packages, routines and formal parameters.

       -cb    Generate a SOAP dispatcher callback routine for the server. This dispatcher routine  contains  the
              code  to handle all the operations as described in the WSDL document. You need also to specify the
              -types option, see below.

       -cvs   Add CVS id tag in every generated file.

       -doc   Handle document style binding as RPC ones. This is sometimes needed because  some  WSDL  documents
              specify a document style binding even though it is really an RPC one.

       -f     Force creation of the file. Overwrite any exiting files with the same name.

       -main filename
              Specify  the  name  of  the  server's  procedure  main to generate. If file filename.amt (Ada Main
              Template) is present, it uses this template file to generate the main procedure. The template  can
              reference the following variable tags:

              SOAP_SERVICE
                     The  name  of  the  service  as  described  into the WSDL document. This tag can be used to
                     include the right units

                                with @_SOAP_SERVICE_@.Client;
                                with @_SOAP_SERVICE_@.CB;

              SOAP_VERSION
                     The AWS SOAP version.

              BAWS_VERSION
                     The AWS version.

              UNIT_NAME
                     The name of the generated unit. This is the name of the procedure that will be created.

                          procedure @_UNIT_NAME_@ is
                          begin
                             ...

       -noskel
              Do not generate skeletons, only stubs.

       -nostub
              Do not generate stubs, only skeletons.

       -o name
              Specify the name of the local WSDL document. This option can be used only when using  a  Web  WSDL
              document (i.e. passing an URL to wsdl2aws).

       -pp password
              User password for the proxy if proxy authentication required.

       -proxy nameIP
              Use  this  proxy to access the WSDL document and generate code to access to these Web Services via
              this proxy. The proxy can be specified by its DNS name or IP address.

       -pu name
              User name for the proxy if proxy authentication required.

       -q     Quiet mode (no output).

       -s     Skip non supported SOAP routines. By default, wsdl2aws exits with an error when a problem is found
              while  parsing the WSDL document. This option is useful to skip routines using non supported types
              and still be able to compile the generated files.

       -types spec
              Specify the name of the spec containing the Ada implementation of the SOAP routines. This is  used
              for  example by the -cb option above to instantiate all the server side SOAP callbacks used by the
              main SOAP dispatcher routine.

       -v     Verbose mode, display the parsed spec.

       -v -v  Verbose mode, display the parsed spec and lots of information while parsing the WSDL document.

       -wsdl  Add WSDL document as comment into the generated root unit.

SEE ALSO

       ada2wsdl(1), aws_password(1), awsres(1), webxref(1)

       The Ada Web Server User's Guide in package libaws-doc.

AUTHOR

       wsdl2aws was written by Dmitriy Anisimkov <anisimkov@yahoo.com> and Pascal  Obry  <p.obry@wanadoo.fr>  as
       part of the Ada Web Server.

       This manual page was written by Ludovic Brenta <ludovic.brenta@insalien.org> for Debian GNU/Linux.