Additionally, the importer generates classes and activity diagrams enabling the modeler to execute the imported services immediately. How these additional model elements are created is not explained in this section, because it follows directly the general Bridge modeling methodology discussed on other pages.

Find here how Web Service Definition Language (WSDL) entities are mapped to UML model elements.
WSDL is a very generic description language allowing the description of Remote Procedure Call (RPC) interfaces as well as Document oriented message interfaces. Additionally, it allows for different type systems and different encoding schemes of these types. Before going into too much detail, we start by explaining the basic building blocks of WSDL and their significance for the WSDL Importer. For more information on how to import WSDL files with the WSDL Importer, see Importing WSDL or XSD. For more information on how to use imported service definitions, refer to SOAP Adapter.

SOAP Encoding Styles

SOAP uses an XML format to marshal data that is transported between software application. SOAP was planned to be used for legacy systems and modern object-oriented systems as well. Consequently, SOAP offers more than one encoding method to convert data from a software object into XML and vice versa (see the page of W3C).

There are two ways, in which it maps high level data types like arrays, integers, floats and so on to a serialized XML format: SOAP encoding  (also called Section 5 encoding) and Literal encoding .
Literal encoding means that the body contents conform to a specific XML Schema. SOAP encoding uses a set of rules based on the XML Schema data types to encode the data, but the message does not conform to a particular schema.
In addition to the SOAP encoding styles, messages can be of two styles: RPC (Remote Procedure Call) style or Document style. The following encodings are commonly used:

• SOAP Remote Procedure Call (RPC) encoding (also known as Section 5 encoding, which is defined by the SOAP 1.1 specification).
  
  • SOAP encoding
  • RPC style messages
• SOAP Remote Procedure Call Literal encoding (SOAP RPC-literal), which uses RPC methods to make calls but uses an XML do-it-yourself method for marshalling the data.
  
  • literal encoding
  • RPC style messages
• SOAP document-style encoding, which is also known as message-style or document-literal encoding.
  • literal encoding
  • document style messages

The following table summarizes these combinations.

Ways to Map Data Types	SOAP Encoding (also called Section 5 encoding)		Literal Encoding
Message Types	RPC style	Document style	RPC style	Document style
Name	SOAP RPC encoding	<commonly not used in SOAP applications>	SOAP RPC-literal	SOAP document-style encoding (or document-literal)
Supported by the Bridge		n/a

Basic Building Blocks of Web Services

A WSDL document is simply a set of definitions. There is a definitions element at the root, and definitions inside. The grammar is as follows:

<wsdl:definitions name="nmtoken"? targetNamespace="uri"?>
   <import namespace="uri" location="uri"/>*
   <wsdl:documentation .... /> ?
  
   <wsdl:types> ?
      <wsdl:documentation .... />?
      <xsd:schema .... />*
      <-- extensibility element -> *
   </wsdl:types>
  
   <wsdl:message name="nmtoken"> *
      ...
   </wsdl:message>
  
   <wsdl:portType name="nmtoken">*
      ...
   </wsdl:portType>
  
   <wsdl:binding name="nmtoken" type="qname">*
      ...
   </wsdl:binding>
  
   <wsdl:service name="nmtoken"> *
      <wsdl:documentation ... />?
      <wsdl:port name="nmtoken" binding="qname"> *
        <wsdl:documentation ... /> ?
        <-- extensibility element ->
      </wsdl:port>
      <-- extensibility element ->
   </wsdl:service>
  
   <-- extensibility element -> *
  
 </wsdl:definitions>

 Services are defined using the following elements:

When importing a WSDL file the importer will generate a package structure that follows roughly the WSDL file structure. The type section corresponds to the Imported Types package, the services section corresponds to the Imported Services package. Within these packages each schema respectively each service has its own package that contains its elements.

The following topics explain the above mentioned WSDL elements and their mapping to UML model elements by the importer in more detail.