WSDL


 

+

Search Tipsa>   |   Advanced Searcha>

 

WSDL is an XML-based description language submitted to the W3C as the industry standard for describing Web services.

A WSDL document defines services as collections of network endpoints, or ports, where a port is defined by associating a network address with a reusable binding, and a collection of ports defines a service.

To find all wsdl files on your system:

cd WAS_HOME
find . -name \*.wsdl -print | tar -T - -c -v -f wsdl.tar

Here are some typical wsdl files...

A WSDL document is composed of several elements.

A WSDL file contains the following parts:

A WSDL file describes a Web service with the following elements:

 

portType

The description of the operations and associated messages. The portType element defines abstract operations. 

<portType name="EightBall">
  <operation name="getAnswer">
    <input message="ebs:IngetAnswerRequest"/>
    <output message="ebs:OutgetAnswerResponse"/>
  </operation>
</portType>

 

message

The description of input and output parameters and return values. 

<message name="IngetAnswerRequest">
  <part name="meth1_inType" type="ebs:questionType"/>
</message>
<message name="OutgetAnswerResponse">
  <part name="meth1_outType" type="ebs:answerType"/>
</message>

 

types

The schema for describing XML types used in the messages. 

<types>
  <xsd:schema targetNamespace="...">
    <xsd:complexType name="questionType">
      <xsd:element name="question" type="string"/>
    </xsd:complexType>
    <xsd:complexType name="answerType">
    ...
</types>

 

binding

The bindings describe the protocol used to access a portType, as well as the data formats for the messages defined by a particular portType element. 

<binding name="EightBallBinding" type="ebs:EightBall">
  <soap:binding style="rpc" transport="schemas.xmlsoap.org/soap/http">
  <operation name="ebs:getAnswer">
  <soap:operation soapAction="urn:EightBall"/>
    <input>
      <soap:body namespace="urn:EightBall" ... />
    ...

 

Service

The services and ports define the location of the Web service. The service contains the Web service name and a list of ports.

 

Ports

The ports contain the location of the Web service and the binding used for service access. 

<service name="EightBall">
  <port binding="ebs:EightBallBinding" name="EightBallPort">
    <soap:address location="localhost:8080/axis/EightBall"/>
  </port>
</service>

When creating Java API for XML Web Services (JAX-WS) or JAX-RPC Web services, we can use a bottom-up development approach when you start from Java Beansor an enterprise bean, or we can use a top-down development approach when you start with an existing WSDL file.

When creating JAX-WS Web services for this product, we can start with either a WSDL or an implementation bean class. If we start with an implementation bean class, then use the wsgen command line tool to generate all the Web services server artifacts, including a WSDL if requested. If we start with a WSDL, then use the wsimport command line tool to generate all the Web services artifacts for either the server or client side.

When creating JAX-RPC Web services for this product, first have an implementation bean that includes a service endpoint interface. Then, you use the Java 2WSDL command-line tool to create a WSDL file that defines the Web services. If starting with the WSDL to generate the implementation bean class, run the WSDL2Java command line tool against the WSDL file to create Java APIs and deployment descriptor templates.

 

Multipart WSDL and WSDL publication

The product supports deployment of Web services using a multipart Web Services Description Language (WSDL) file. In multipart WSDL files, an implementation WSDL file contains the wsdl:service. This implementation WSDL file imports an interface WSDL file, which contains the other WSDL constructs. This supports multiple Web services using the same WSDL interface definition.

The <wsdl:import> element indicates a reference to another WSDL file. If the <wsdl:import> element location attribute does not contain a URL, that is, it contains only a file name, and does not begin with http://, https: // or file: //, the imported file must be located in the same directory and must not contain a relative path component. For example, if META-INF/wsdl/A_Impl.wsdl is in the module and contains the <wsdl:import="A.wsdl" namespace="..."/> import statement, the A.wsdl file must also be located in the module META-INF/wsdl directory.

IBM recommends that you place all WSDL files in either the META-INF/wsdl directory, if we are using EJBs, or the WEB-INF/wsdl directory, if we are using Java Beans components, even if relative imports are located within the WSDL files. Otherwise, implications exist with the WSDL publication when you use a path like <location="../interfaces/A_Interface.wsdl"namespace="..."/>.

Using a path like this example fails because the presence of the relative path, regardless of whether the file is located at that path or not. If the location is a Web address, it must be readable at both deployment and server startup.

We can publish the files located in the META-INF/wsdl or the WEB-INF/wsdl directory through either a URL address or file, including WSDL or XML Schema Definition (XSD) files. For example, if the file referenced in the <wsdl-file> element of the webservices.xml deployment descriptor is located in the META-INF/wsdl or the WEB-INF/wsdl directory, it is publishable. If the files imported by the <wsdl-file> are located in the wsdl/ directory or its subdirectory, they are publishable.

If the WSDL file referenced by the <wsdl-file> element is located in a directory other than wsdl, or its subdirectories, the file and its imported files, either WSDL or XSD files, which are in the same directory, are copied to the wsdl directory without modification when the application is installed. These types of files can also be published.

If the <wsdl-file> imports a file located in a different directory (a directory not -INF/wsdl or a subdirectory), the file is not copied to the wsdl directory and not available for publishing.

For JAX-WS Web services, we can use an annotation to specify the location of the WSDL. Use the @WebService annotation with the WSDLLocation attribute. The WSDLLocation attribute is optional. If this attribute is not specified, then WSDL is generated and published from the information that is found in the Web service classes. You can optionally specify the location of the WSDL file in the webservices.xml deployment descriptor. However, any information that you define in the webservices.xml deployment descriptor overrides any corresponding information specified by annotations.


Related concepts


Web Services for Java EE specification

 

Related tasks


Generating Java artifacts for JAX-WS applications
Develop a WSDL file for JAX-RPC applications
Making deployed Web services applications available to clients

 

Related


wsimport command for JAX-WS applications
wsgen command for JAX-WS applications
Java 2WSDL command for JAX-RPC applications
WSDL2Java command for JAX-RPC applications
Web services specifications and APIs

 

Related information


Web Services Description Language (WSDL) 1.1