describing a service that returns an image/jpg (for example)

• From: Sanjiva Weerawarana <sanjiva@opensource.lk>
• Date: Thu, 13 Oct 2005 22:47:06 +0600
• To: WS-Description WG <www-ws-desc@w3.org>
• Message-Id: <1129222026.30938.24.camel@localhost.localdomain>

Consider a service that takes a URI and returns a picture. 

Input message:

<element name="input">
  <complexType>
    <sequence>
      <element name="id" type="xsd:string"/>
    </sequence>
  </complexType>
</element>

Output message:

<element name="output">
  <complexType>
    <sequence>
      <element name="image" type="xsd:base64"
               xmime:expectedContentType="image/*"/>
    </sequence>
  </complexType>
</element>

Operation:

<operation name="gimme-image"
           style="style/iri style/one-binary-thing">
  <input message="tns:input"/>
  <output message="tns:output"/>
</operation>

Note that the use of the style "style/iri" on /operation effectively
constrains the input element. The addition of the style
"style/one-binary-thing" constrains the output schema to be of the
pattern above: exactly one child in the sequence and it must be declared
as xsd:base64 along with the xmime:expectedContentType attribute.

And now the all important binding:

<binding name="foo" interface="..">
  <operation name="gimme-image" whttp:operation="GET"
        whttp:outputSerialization="image/jpg"/>
</binding>

When we document the "one-binary-thing" style we say that that if that
style is used then the output serialization must be set to something
that conforms to the expected content type given in the schema.

This obviously needs to be spec'ized to become real, but is it really
that simple?

Sanjiva.

Received on Thursday, 13 October 2005 16:47:35 UTC