Web Service Description Language (WSDL) is an XML language that contains information about the interface, semantics and “administrivia” of a call to a Web service.

Once you have developed a Web service, you publish its description and a link to it in a UDDI (Universal Description, Discovery and Integration) repository so that potential users can find it. When someone thinks they want to use your service, they request your WSDL file in order to find out the location of the service, the function calls and how to access them. Then they use this information in your WSDL file to form a SOAP (Simple Object Access Protocol) request to your computer.

The WSDL Standard

The WSDL standard is being worked out by the W3C (World Wide Web Consortium). That body further defines the standard as “an XML format for describing network services as a set of endpoints operating on messages containing either document-oriented or procedure-oriented information. The operations and messages are described abstractly, and then bound to a concrete network protocol and message format to define an endpoint. Related concrete endpoints are combined into abstract endpoints (services). WSDL is extensible to allow description of endpoints and their messages regardless of what message formats or network protocols are used to communicate.”

A Java API for WSDL (JWSDL)

A Java API for WSDL (JWSDL) specification is currently in the works in the Java Community Process (JCP). When released, it will provide an API for manipulating WSDL documents without directly interacting with the XML documents. While you can currently achieve the full range of WSDL functionality using JAXP, JWSDL will be much easier and faster to use, simplifying the developer’s work.

How WSDL Works in the World of Java Technology

The diagram illustrates how a Web service is registered, found and called in a scenario based on Java technology. In this diagram, the Web service is registered in a UDDI repository using the Java API for XML Registries (JAXR), where a business partner or other system can find the service. The registry information from UDDI is used to locate a WSDL document that details the call semantics for the Web service. With the WSDL document in hand, the Java programmer can then feed it to a tool that can generate a Java object proxy to the Web service, or simply use it as a reference document along with a lower-level SOAP API.