4.6. Other WSDL Features
4.6.1. Documenting Your WSDL
The WSDL documents you've seen so far contain lots of information on the operations, messages, and parameters exposed by a Web service. They do not, however, contain any information on what each operation actually does. For example, the quote of the day service had an operation called getFortuneByDictionary, which had one input parameter called dictionaryName. How would a client know what values to pass in as the dictionaryName? And how would it know exactly what the method does, that is, how would it know that the method returns quotes and definitions?
To provide such information, you can add documentation to your WSDL using <document>, which may appear inside any WSDL element such as <operation> ...
Get Real World XML Web Services: For VB and VB .NET Developers now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.
