- From: Jean-Jacques Moreau via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 12 Feb 2007 16:36:21 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/wsdl20
In directory hutz:/tmp/cvs-serv28604
Modified Files:
wsdl20-adjuncts.xml
Log Message:
CR130: Question on double curly braces with HTTP Location
Index: wsdl20-adjuncts.xml
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-adjuncts.xml,v
retrieving revision 1.210
retrieving revision 1.211
diff -C 2 -d -r1.210 -r1.211
*** wsdl20-adjuncts.xml 12 Feb 2007 13:52:35 -0000 1.210
--- wsdl20-adjuncts.xml 12 Feb 2007 16:36:13 -0000 1.211
***************
*** 4282,4322 ****
location} property</head>
<p>The <prop comp="Binding Operation">http location</prop>
! property, if present, MAY cite local names of
! elements from the
<termref def="instance_data">instance data</termref> of the
message to be serialized in
! request IRI by enclosing the element name within curly
! braces (e.g. <attval>temperature/{town}</attval>, see <specref ref="urlencoded_example_querystring"/>):
</p>
! <ulist>
! <item>
! <p>When constructing the request IRI, each pair of
! curly braces (and enclosed element name) is replaced
by the possibly empty single value of the
! corresponding element.
No percent-encoding mechanism, as defined in section 2.1 of <bibref ref="RFC3986"/>,
! is performed on the replacement value. If a local name appears more than once,
the elements are used in the order they appear in the
! <termref def="instance_data">instance data</termref>.
<assert class="message" id="HTTPSerialization-2607010">This element MUST NOT
carry an <att>xs:nil</att> attribute whose value is
! <attval>true</attval></assert>.
! </p>
! </item>
! <item>
! <p>A double curly brace (i.e. <attval>{{</attval> or <attval>}}</attval>) MAY be used to include
! a single, literal curly brace in the request IRI.</p>
! </item>
! </ulist>
! <p><assert class="component"
id="HTTPSerialization-5073">Strings enclosed within single
curly braces MUST be element names from the <termref
def="instance_data">instance data</termref> of the input
! message.</assert>
! </p>
<p>Note that the mechanism described in this section could be used to
indicate the entire abosulte IRI, including the scheme, host, or port
(e.g. "{scheme}://{host}:{port}/temperature/{town}" or even "{myIRI}").</p>
</div4>
--- 4282,4333 ----
location} property</head>
<p>The <prop comp="Binding Operation">http location</prop>
! property MAY cite local names of elements from the
<termref def="instance_data">instance data</termref> of the
message to be serialized in
! request IRI, by enclosing the element name within curly
! braces. For example, <attval>temperature/{town}</attval> allows
! using the <el>town</el> from the message(see
! <specref ref="urlencoded_example_querystring"/> for additional details).
! The following EBNF <bibref ref="EBNF"/> grammar represents
! the patterns for constructing the request IRI:
</p>
!
! <eg xml:space="preserve">httpLocation ::= charData? (( openBrace | closeBrace | elementName ) charData?)*
! charData ::= [^{}]*
! openBrace ::= '{{'
! closeBrace ::= '}}'
! elementName ::= '{' NCName '}'</eg>
!
! <p>The request IRI is constructed as follows:</p>
!
! <ulist>
! <item><p>Each <el>elementName</el>
! (as defined in the above grammar) is replaced
by the possibly empty single value of the
! corresponding element from the <termref def="instance_data">instance data</termref>.
No percent-encoding mechanism, as defined in section 2.1 of <bibref ref="RFC3986"/>,
! is performed on the replacement value.</p></item>
! <item><p>If a local name appears more than once,
the elements are used in the order they appear in the
! <termref def="instance_data">instance data</termref>. </p></item>
! <item><p>
<assert class="message" id="HTTPSerialization-2607010">This element MUST NOT
carry an <att>xs:nil</att> attribute whose value is
! <attval>true</attval></assert>.</p></item>
! <item><p><assert class="component"
id="HTTPSerialization-5073">Strings enclosed within single
curly braces MUST be element names from the <termref
def="instance_data">instance data</termref> of the input
! message.</assert></p></item>
! </ulist>
<p>Note that the mechanism described in this section could be used to
indicate the entire abosulte IRI, including the scheme, host, or port
(e.g. "{scheme}://{host}:{port}/temperature/{town}" or even "{myIRI}").</p>
+
+ <p>The following escaping mechanism is provided: a double curly brace
+ (i.e. <attval>{{</attval> or <attval>}}</attval>) MAY be used to include
+ a single, literal curly brace in the request IRI.</p>
+
</div4>
***************
*** 5193,5196 ****
--- 5204,5213 ----
http://www.w3.org/TR/xml-c14n.
</bibl>
+ <bibl id="EBNF" key="ISO/IEC 14977:1996" href="http://isotc.iso.org/livelink/livelink/fetch/2000/2489/Ittf_Home/PubliclyAvailableStandards.htm">
+ <titleref>Extended BNF</titleref>,
+ IS0 (the International Organization for Standardization) and IEC (the International
+ Electrotechnical Commission), Dec 1996. Available at
+ http://isotc.iso.org/livelink/livelink/fetch/2000/2489/Ittf_Home/PubliclyAvailableStandards.htm.
+ </bibl>
<bibl key="IETF RFC 2119" href="http://www.ietf.org/rfc/rfc2119.txt" id="RFC2119">
<titleref>Key words for use in RFCs to Indicate Requirement
***************
*** 5457,5460 ****
--- 5474,5486 ----
<td>JJM</td>
<td><loc
+ href="http://www.w3.org/2002/ws/desc/5/cr-issues/issues.html#CR130">CR130</loc>:
+ Question on double curly braces with HTTP Location
+ </td>
+ </tr>
+
+ <tr>
+ <td>20070212</td>
+ <td>JJM</td>
+ <td><loc
href="http://www.w3.org/2002/ws/desc/5/cr-issues/issues.html#CR123">CR123</loc>:
HTTP Method selection
Received on Monday, 12 February 2007 16:36:27 UTC