- From: Hugo Haas via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 21 Nov 2005 20:03:45 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/wsdl20
In directory homer:/tmp/cvs-serv32558
Modified Files:
wsdl20-adjuncts.xml
Log Message:
Reworked serialization tables
Index: wsdl20-adjuncts.xml
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-adjuncts.xml,v
retrieving revision 1.147
retrieving revision 1.148
diff -C2 -d -r1.147 -r1.148
*** wsdl20-adjuncts.xml 18 Nov 2005 20:16:29 -0000 1.147
--- wsdl20-adjuncts.xml 21 Nov 2005 20:03:42 -0000 1.148
***************
*** 4018,4021 ****
--- 4018,4022 ----
<!-- +++++++++ -->
+
<div2 id="_http_serialization">
<head>Serialization Format of Instance Data</head>
***************
*** 4024,4029 ****
<termref def="instance_data">instance data</termref>
corresponding to an input and output message as an HTTP
! message. <specref ref="http_sftab"/> gives an overview of
! those serialization formats. All of them allow serialization of parts of the
<termref def="instance_data">instance data</termref> in the HTTP Request IRI,
as defined in section <specref ref="_http_location_template"/>.
--- 4025,4030 ----
<termref def="instance_data">instance data</termref>
corresponding to an input and output message as an HTTP
! message. <specref ref="http_sftab"/> and <specref ref="http_sfstyles"/> give an overview of
! those serialization formats and their constraints. All of them allow serialization of parts of the
<termref def="instance_data">instance data</termref> in the HTTP Request IRI,
as defined in section <specref ref="_http_location_template"/>.
***************
*** 4033,4041 ****
restrictions on the style of the Interface Operation bound.
</p>
! <!--
! <ednote>
! <name>HH</name>
! <edtext>Below are two proposed tables for the summary</edtext>
! </ednote>
<table border="1" id='http_sftab'>
--- 4034,4038 ----
restrictions on the style of the Interface Operation bound.
</p>
!
<table border="1" id='http_sftab'>
***************
*** 4044,4090 ****
<tbody>
<tr>
! <th colspan="2" rowspan="2"> </th>
<th colspan="4">Serialization of the instance data in
! parts of an HTTP message:</th>
</tr>
<tr>
! <th>In the request URI</th>
<th colspan="3">In the message body</th>
</tr>
<tr>
! <th colspan="2">Serialization formats:</th>
! <td><emph>application/x-www-form-urlencoded</emph>,
! <emph>application/xml</emph> &
! <emph>multipart/form-data</emph></td>
! <td><emph>application/x-www-form-urlencoded</emph></td>
! <td><emph>application/xml</emph></td>
! <td><emph>multipart/form-data</emph></td>
</tr>
<tr>
! <th rowspan="2">Serialization of an input message</th>
! <td>HTTP request without message body (GET, DELETE, etc.)</td>
! <td>All, some or none</td>
! <td>N/A</td>
! <td>N/A</td>
! <td>N/A</td>
</tr>
<tr>
! <td>HTTP request with message body (POST, PUT, etc.)</td>
! <td>All, some or none</td>
! <td>All, some or none</td>
! <td>All</td>
! <td>All</td>
</tr>
<tr>
! <th>Serialization of an output message</th>
! <td>HTTP response</td>
! <td>N/A</td>
! <td>N/A</td>
! <td>All</td>
! <td>N/A</td>
</tr>
</tbody>
</table>
! -->
<table border="1" id='http_sftab'>
<caption>Applicability of the serialization
--- 4041,4083 ----
<tbody>
<tr>
! <td colspan="2" rowspan="3" align="center">-</td>
<th colspan="4">Serialization of the instance data in
! parts of an HTTP message</th>
</tr>
<tr>
! <th rowspan="2">In the request URI</th>
<th colspan="3">In the message body</th>
</tr>
<tr>
! <th><emph>application/x-www-form-urlencoded</emph></th>
! <th><emph>multipart/form-data</emph></th>
! <th><emph>application/xml</emph></th>
</tr>
<tr>
! <th rowspan="2">HTTP request (input message)</th>
! <th>Without message body: GET, DELETE, …</th>
! <td align="center">All, some or none</td>
! <td align="center">-</td>
! <td align="center">-</td>
! <td align="center">-</td>
</tr>
<tr>
! <th>With message body: POST, PUT, …</th>
! <td align="center">All, some or none</td>
! <td align="center">Remainder</td>
! <td align="center">All</td>
! <td align="center">All</td>
</tr>
<tr>
! <th colspan="2">HTTP response (output message)</th>
! <td align="center">-</td>
! <td align="center">-</td>
! <td align="center">-</td>
! <td align="center">All</td>
</tr>
</tbody>
</table>
!
! <!--
<table border="1" id='http_sftab'>
<caption>Applicability of the serialization
***************
*** 4092,4096 ****
<tbody>
<tr>
! <th colspan="2" rowspan="3">Serialization formats:</th>
<th colspan="2"><emph>application/x-www-form-urlencoded</emph></th>
<th colspan="2"><emph>multipart/form-data</emph></th>
--- 4085,4093 ----
<tbody>
<tr>
! <td colspan="2" rowspan="3" align="center">-</td>
! <th colspan="6" align="center">Serialization of the instance data in
! parts of an HTTP message</th>
! </tr>
! <tr>
<th colspan="2"><emph>application/x-www-form-urlencoded</emph></th>
<th colspan="2"><emph>multipart/form-data</emph></th>
***************
*** 4098,4115 ****
</tr>
<tr>
! <td colspan="6" align="center">Serialization of the instance data in
! parts of an HTTP message:</td>
! </tr>
! <tr>
! <td>In the request URI</td>
! <td>In the message body</td>
! <td>In the request URI</td>
! <td>In the message body</td>
! <td>In the request URI</td>
! <td>In the message body</td>
</tr>
<tr>
! <th rowspan="2">Serialization of an input message</th>
! <td>HTTP request without message body (GET, DELETE, etc.)</td>
<td align="center">All, some or none</td>
<td align="center">N/A</td>
--- 4095,4108 ----
</tr>
<tr>
! <th>In the request URI</th>
! <th>In the message body</th>
! <th>In the request URI</th>
! <th>In the message body</th>
! <th>In the request URI</th>
! <th>In the message body</th>
</tr>
<tr>
! <th rowspan="2">HTTP request (input message)</th>
! <th>Without message body: GET, DELETE, …</th>
<td align="center">All, some or none</td>
<td align="center">N/A</td>
***************
*** 4118,4124 ****
</tr>
<tr>
! <td>HTTP request with message body (POST, PUT, etc.)</td>
! <td align="center">All, some or none</td>
<td align="center">All, some or none</td>
<td align="center">All, some or none</td>
<td align="center">All</td>
--- 4111,4117 ----
</tr>
<tr>
! <th>With message body: POST, PUT, …</th>
<td align="center">All, some or none</td>
+ <td align="center">Remainder</td>
<td align="center">All, some or none</td>
<td align="center">All</td>
***************
*** 4127,4132 ****
</tr>
<tr>
! <th>Serialization of an output message</th>
! <td>HTTP response</td>
<td colspan="2" align="center">Invalid</td>
<td colspan="2" align="center">Invalid</td>
--- 4120,4124 ----
</tr>
<tr>
! <th colspan="2">HTTP response (output message)</th>
<td colspan="2" align="center">Invalid</td>
<td colspan="2" align="center">Invalid</td>
***************
*** 4136,4139 ****
--- 4128,4166 ----
</tbody>
</table>
+ -->
+
+ <table border="1" id='http_sfstyles'>
+ <caption>Operation styles required for using serialization formats defined below
+ as input serialization</caption>
+ <tbody>
+ <tr>
+ <th rowspan="3">HTTP Method</th>
+ <th colspan="4">Request</th>
+ </tr>
+ <tr>
+ <th rowspan="2">Request URI: query parameters or path components</th>
+ <th colspan="3">Input serialization</th>
+ </tr>
+ <tr>
+ <th><emph>application/x-www-form-urlencoded</emph></th>
+ <th><emph>multipart/form-data</emph></th>
+ <th><emph>application/xml</emph></th>
+ </tr>
+ <tr>
+ <th>Without message body: GET, DELETE, …</th>
+ <td align="center">IRI style</td>
+ <td align="center">IRI style</td>
+ <td align="center">-</td>
+ <td align="center">-</td>
+ </tr>
+ <tr>
+ <th>With message body: POST, PUT, …</th>
+ <td align="center">IRI style, if any data is serialized as path components or query parameters</td>
+ <td align="center">IRI style</td>
+ <td align="center">Multipart style</td>
+ <td align="center">None required</td>
+ </tr>
+ </tbody>
+ </table>
<div3 id="_http_location_template">
Received on Monday, 21 November 2005 20:04:06 UTC