"interface" - Interface Definition Element

This section describes 'interface', a definition element that defines an interface type with one or multiple operations. An operation is defined with an input-output pattern. An input or output is defined use a given data element.

"interface" is a top level element of a WSDL 2.0 document. "interface" is used to define an interface with one or multiple operations with "operation" sub elements. An operation is defined with a sequence of input and output messages to form an input-output pattern.

WSDL 2.0 supports 3 predefined input-output patterns:

The syntax of "interface" looks like this:

  <wsdl:interface name="nmtoken0" extends="qname_list"
    styleDefault="uri_list">

    <wsdl:fault name="nmtoken1" element="qname1"/>
    ...
    
    <-- in-only operation -->
    <wsdl:operation name="nmtoken2" pattern="uri" style="uri_list">
      <wsdl:input messageLabel="name" element="qname1"/>
      <wsdl:infault ref="qname2" messageLabel="In"/>
    </wsdl:operation>

    <-- in-out operation -->
    <wsdl:operation name="nmtoken2" pattern="uri" style="uri_list">
      <wsdl:input messageLabel="name" element="qname1"/>
      <wsdl:output messageLabel="name" element="qname1"/>
      <wsdl:infault ref="qname2" messageLabel="name"/>
      <wsdl:outfault ref="qname2" messageLabel="name"/>
    </wsdl:operation>

    ...
  </wsdl:interface >

Notes on the "interface" element:

Here is an example of "interface" element:

  <wsdl:interface name="helloInterface" >
    <wsdl:operation name="Hello" 
      pattern="http://www.w3.org/ns/wsdl/in-out" 
      style="http://www.w3.org/ns/wsdl/style/iri">
      <wsdl:input messageLabel="In" element="hy:Hello"/>
      <wsdl:output messageLabel="Out" element="hy:HelloResponse"/>
    </wsdl:operation>
  </wsdl:interface>

In this example,

Last update: 2009.

Table of Contents

 About This Book

 Introduction to WSDL 2.0

WSDL 2.0 Document Structure and Syntax

 Overview of WSDL 2.0 Document Structure

 "description" - The Root Element

 "types" - The Container Element for Data Types

"interface" - Interface Definition Element

 "binding" - Binding Definition Element

 "service" - Service Definition Element

 WSDL Version 2.0 Part 2: Adjuncts

 WSDL 2.0 Document Examples with SOAP Binding

 Using WSDL Document in Java Apache Axis2/Java for WSDL

 Apache Woden for WSDL Documents in Java

 SoapUI - Web Service Testing Tool

 PHP SOAP Extension for WSDL

 Perl SOAP::Lite for WSDL

 Introduction to WSDL 1.1

 WSDL 1.1 Document Structure and Syntax

 WSDL 1.1 Binding Extension for SOAP 1.1

 SoapUI as WSDL 1.1 Testing Tool

 WSDL 1.1 and SOAP 1.1 Examples - Document and RPC Styles

 PHP SOAP Extension for WSDL 1.1

 Perl SOAP::Lite for WSDL 1.1

 Apache Axis2/Java for WSDL 1.1

 Using WSDL2Java to Generate Web Service Stub Classes

 WSDL 1.1 Binding Extension for SOAP 1.2

 WSDL 1.1 and SOAP 1.2 Examples - Document and RPC Styles

 SOAP 1.2 Binding - PHP, Java and Perl Clients

 WSDL Related Terminologies

 Outdated Tutorials

 References

 Full Version in PDF/EPUB