[Ws Wiki] Update of "FrontPage/Axis/WsdlFile" by RichardGregory

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Ws Wiki" for change notification.

The following page has been changed by RichardGregory:
http://wiki.apache.org/ws/FrontPage/Axis/WsdlFile

------------------------------------------------------------------------------
  
  Also see the article: [http://www.fawcette.com/javapro/2003_02/online/WSDL_kjones_02_27_03/ Configure Axis Web Services: Return prewritten WSDL from an AXIS Web service] by Kevin Jones 
  
+ One thing to be aware of is that Axis (at least 1.2.1 and 1.3) sometimes change the service address element of wsdl files, including hand written wsdl files. For example, if a service is deployed at:
+ 
+ {{{
+      http://www.myco.com/webservices/axis/services/MyService
+ }}}
+  
+ When requesting the wsdl with:
+ 
+ {{{
+      http://www.myco.com/webservices/axis/services/MyService?wsdl
+ }}}
+ 
+ Axis will sometimes change the hand written wsdl and replace "www.myco.com/webservices" with the machine name and port number of the machine on which the service is deployed, and return a wsdl with an address like:
+ 
+ {{{
+      http://mahcine_name:8080/axis/services/MyService
+ }}}
+ 
+ Of course, this may cause problems for clients automatically generated from the wsdl, which may not recognise the machine name if they are external to the organisation. Including a <documentation/> element with the correct service address within the wsdl may at least enable developers to spot the error in their generated clients.
+