Generating Web Services Description Language (WSDL)
A Web Services Description Language (WSDL) file is generated for each selected Web service exposure from the properties and options defined for that exposure.
The Unicode version of JADE generates UTF8-encoded WSDL files that can be imported by JADE, .NET, and other Web service consumers.
See "Using the Generated WSDL", later in this chapter, for an example of the JADE code defined for the getClient method in the ErewhonInvestmentsService subclass (created in the example under "Creating a Web Service Class", earlier in this chapter).
When you have specified your Web services options and clicked the Generate WSDL button on the Web Services sheet of the Define Application dialog, the common Save As dialog is displayed, to enable you to specify the location and name of the generated file.
The generated WSDL file (of type .wsdl) is based on the following entities.
-
The selected Web service classes and its methods
-
Classes and selected properties selected for exposure
-
Machine name and virtual directory
-
Session handling
-
Secure service
-
Version control
-
Selected SOAP headers for the Web service methods
-
Use of RPC
-
Circular references
As changing any of these entities can make a previously generated WSDL incompatible, it is important that you design your Web service carefully and use some form of version control to detect requests from Web service consumers who may be using a WSDL version that is no longer compatible.
