- From: Hugo Haas <hugo@dev.w3.org>
- Date: Mon, 26 Jul 2004 10:30:49 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/wsdl20
In directory homer:/tmp/cvs-serv13613
Modified Files:
wsdl20-bindings.xml
Log Message:
Added proposal #1 of:
http://lists.w3.org/Archives/Public/www-ws-desc/2004Jul/0276.html
http://lists.w3.org/Archives/Public/www-ws-desc/2004Jul/0061.html
Index: wsdl20-bindings.xml
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-bindings.xml,v
retrieving revision 1.82
retrieving revision 1.83
diff -C2 -d -r1.82 -r1.83
*** wsdl20-bindings.xml 26 Jul 2004 08:06:44 -0000 1.82
--- wsdl20-bindings.xml 26 Jul 2004 10:30:47 -0000 1.83
***************
*** 1900,1904 ****
</p>
<example id="urlencoded_example">
! <head>instance data serialized in a URI</head>
<p>
The following instance data of an input message
--- 1900,1904 ----
</p>
<example id="urlencoded_example">
! <head>Instance data serialized in a URI</head>
<p>
The following instance data of an input message
***************
*** 1914,1918 ****
<eg xml:space="preserve"><http:operation
location='temperature/{town}'
! method='get' /></eg>
<p>
will serialize the message in the URI as follow:
--- 1914,1918 ----
<eg xml:space="preserve"><http:operation
location='temperature/{town}'
! method='GET' /></eg>
<p>
will serialize the message in the URI as follow:
***************
*** 1961,1967 ****
the <att>location</att>
&AII;.</p>
<p>Strings enclosed within single curly braces MUST be
element names from the <termref def="instance_data">instance
! data</termref> of the input message; any other strings enclosed
within single curly braces are a fatal error.
</p>
--- 1961,1974 ----
the <att>location</att>
&AII;.</p>
+ <p>An element name MAY be followed by a slash (i.e. "/")
+ inside curly braces
+ (e.g. location="temperature/{town/}") to indicate that
+ no other element must be serialized in the request URI
+ (see <specref
+ ref="_http_operation_location_notcited_get"/>).</p>
<p>Strings enclosed within single curly braces MUST be
element names from the <termref def="instance_data">instance
! data</termref> of the input message, possibly followed by
! a slash; any other strings enclosed
within single curly braces are a fatal error.
</p>
***************
*** 1969,1977 ****
<div4 id="_http_operation_location_notcited_get">
<head>Case elements NOT cited in <att>location</att> attribute</head>
<p>All elements of the <termref def="instance_data">instance
data</termref> from the input message NOT cited by the
<att>location</att>
&AII; are serialized as query parameters appended to the
! request URI.
</p>
<p>
--- 1976,1994 ----
<div4 id="_http_operation_location_notcited_get">
<head>Case elements NOT cited in <att>location</att> attribute</head>
+ <p>If an element name appears in the <att>location</att>
+ &AII; followed by a slash, then other elements must be
+ serialized in the message body (see <specref
+ ref="_http_operation_location_notcited_body"/>), otherwise
+ they must be serialized as parameters in the request URI
+ (see <specref
+ ref="_http_operation_location_notcited_uri"/>).</p>
+
+ <div5 id="_http_operation_location_notcited_uri">
+ <head>Serialization in the request URI</head>
<p>All elements of the <termref def="instance_data">instance
data</termref> from the input message NOT cited by the
<att>location</att>
&AII; are serialized as query parameters appended to the
! request URI (e.g. <specref ref="urlencoded_example"/>).
</p>
<p>
***************
*** 2001,2004 ****
--- 2018,2074 ----
</item>
</ulist>
+ </div5>
+
+ <div5 id="_http_operation_location_notcited_body">
+ <head>Serialization in the message body</head>
+
+ <p>All elements of the <termref
+ def="instance_data">instance data</termref> from the
+ input message NOT cited by the <att>location</att> &AII;
+ are serialized in the message body following the rules
+ of the <attval>application/xml</attval> (see <specref
+ ref="_http_operation_xml_encoding"/>).</p>
+
+ <p>The <termref def="instance_data">instance
+ data</termref> serialized in the <termref
+ def="instance_data">instance data</termref> of the input
+ message with the elements cited in the
+ <att>location</att> &AII; removed.</p>
+
+ <example id="urlencoded_example_body">
+ <head>Instance data serialized in a URI and in a
+ message body</head>
+ <p>
+ The following instance data of an input message
+ </p>
+ <eg xml:space="preserve"><data>
+ <town>Fréjus</town>
+ <date>2004-01-16</date>
+ <unit>C</unit>
+ <value>24</value>
+ </data></eg>
+ <p>
+ with the following <el>operation</el> element:
+ </p>
+ <eg xml:space="preserve"><http:operation
+ inputSerialization='application/x-www-form-urlencoded'
+ location='temperature/{town/}'
+ method='POST' /></eg>
+ <p>
+ will serialize the message in the URI as follow:
+ </p>
+ <eg xml:space="preserve">temperature/Fr%C3%A9jus</eg>
+ <p>
+ and in the <code>application/xml</code> message body
+ as follow:
+ </p>
+
+ <eg xml:space="preserve"><data>
+ <date>2004-01-16</date>
+ <unit>C</unit>
+ <value>24</value>
+ </data></eg>
+ </example>
+ </div5>
</div4>
</div3>
Received on Monday, 26 July 2004 06:30:49 UTC