Web Service References v0.9

• Glen Daniels — Sonic Software
• Jeff Mischkinsky — Oracle
• Arthur Ryman — IBM
• Ümit Yalçınalp — Oracle

23 Sep 2003
W3C WSD WG f2f

Problem Statement

• Representing a Web service reference
• Declaring a Web service reference in WSDL
• Locating WSDL documents
• Two dimensions
  • Specifying type information
    • Interface and binding
  • Specifying instance information
    • Location (e.g. a URL, list of URLs)
    • Optional additional properties (e.g. app dep data)

Representing a WS Reference

• What is known at authoring time?
  • Case 1 — Interface and Binding Known
  • Case 2 — Interface Known
  • Case 3 — No Type Information Known
• What instance information is required at runtime (to be sent as part of the message)
  • Case A — URL
  • Case B — URL(s) plus additional properties

Example

• (not included)

MSG Type and WSDL Decl

MSG Type and WSDL Decl

• A compliant WSDL processor MUST understand and process the types (or derived types) specified in the table
• A compliant WSDL processor MAY understand and process other user defined types
• A WSDL author MAY use the types specified herein or types derived from them

• @type — schema type of the message component that represents the ws:reference
• @interface — Qname of interface implemented by the ws:reference
• @binding — Qname of the binding implemented by the ws:reference
• Level nesting defines the scope of applicability

Rules

• Each individual interface MUST be associated with a unique schema type
  • E.g. references to workers and mgrs contained in the same message will require two different schema types

Description Location

• Message MAY contain Qnames of components defined in a WSDL document,
  • requires ability to locate the WSDL document
• Modify current definition of ServiceElement by adding ws:descriptionLocation attribute
  • Mimics schema location attribute
  • <insert example here>

Summary

• Introduces ws:reference element for authoring-time type information
• Specifies use of xs:anyURI and wsdl:Service (and their derived types) for transmitting Web service references
  • But allows use of user-defined types
• Specifies wsdl:descriptionLocation attribute for locating WSDL documents