esoapcg-readme.txt

gsoap 专注于嵌入式web service开发

eSoap's C++ Code Generator  -   esoapcg
---------------------------------------

This is a C++/Java code generator for eSoap. It is able to read WSDL/eSD documents
and generate proxy stubs as well as the skeletons of server implementation for 
a web service based on eSoap. The eSD document format is an intermediate 
format designed to simplify the design of SOAP servers based on eSoap.
Also, there is a way to export a WSDL file from a eSD. Converting an existing
WSDL to eSD is poosible, using one XSL stylesheet.

For details about the C++ mappings, see document included in this 
distribution( wsdl_mapping.pdf )


Development Tools
------------------

You need to have your own XSLT processor to convert files from/to WSDL format.
The code generator esoapcg operates with eSD files as input. So, it is recommend 
to start development of a web service, defining the interfaces using an eSD file.

Also, you would need to have the eSoap run-time ( library + header files ) in 
order to compile and link the programs. You can generate source code without 
eSoap runtime, but you cannot compile or link to create applications.
eSoap 0.7+ is required.

The stylesheets ( XSL ) file has been tested with two very portable 
XSL processors: 

   + Sablotron 5.2 ( http://www.gingerall.com  )
   + Instant-Saxon (http://users.iclway.co.uk/mhkay/saxon/index.html )

More information about these processors can be found on their web sites.

Using Instant-Saxon ( Windows )

to convert a WSDL file to an eSD file:

  saxon your_wsdl_file wsdl2esd.xsl >your_esd_file

convert from an eSD file to a WSDL file:

  saxon esd2wsdl.xsl your_wsdl_file  >your_wsdl_file


Also, you need the eSoap run-time. Please go to site below to get the
source distribution, or a pre-built binary distribution.

   http://www.embedding.net/eSOAP


Windows Installation
--------------------

md c:\work
cd work
unzip esoapcg-windows-ver.zip

This should create an directory structure such as:

    esoapcg\*.*     ---> binary for windows and XSL stylesheets to process
						 the XML documents and convert them to/from WSDL.
    esoapcg\tests   ---> two simple examples

Just add the file esoapgc.exe somewhere in your PATH, and you ready.



Running the tests example:
--------------------------

NOTE: You need to have the XSLT processor and eSoap Run-time.
Makefiles have saxon hardcoded in them. 

Another thing that you have to do, is to define the location of the
eSoap run-time. set the "TOP" macro in the makefiles to match that
location.


[e-mail]
Rosimildo da Silva.