- From: Jean-Jacques Moreau via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 13 Feb 2007 17:58:31 +0000
- To: public-ws-desc-eds@w3.org
Update of /sources/public/2002/ws/desc/wsdl20
In directory hutz:/tmp/cvs-serv25605
Modified Files:
wsdl20-adjuncts.xml
Log Message:
1/2 of CR117: Re: 6.7.1.1 Construction of the request IRI using the http location
Index: wsdl20-adjuncts.xml
===================================================================
RCS file: /sources/public/2002/ws/desc/wsdl20/wsdl20-adjuncts.xml,v
retrieving revision 1.217
retrieving revision 1.218
diff -C 2 -d -r1.217 -r1.218
*** wsdl20-adjuncts.xml 13 Feb 2007 10:52:01 -0000 1.217
--- wsdl20-adjuncts.xml 13 Feb 2007 17:58:29 -0000 1.218
***************
*** 4289,4297 ****
<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>
--- 4289,4306 ----
<termref def="instance_data">instance data</termref> of the
message to be serialized in
! request IRI. Citing is performed:</p>
!
! <ulist>
! <item><p>either by enclosing the element name within curly
! braces. For example, <attval>temperature/{town}</attval>. See
! <specref ref="urlencoded_example_querystring"/> for a more detailed example;</p></item>
! <item><p>or by enclosing the element name within tilded-curly
! braces. For example, <attval>temperature/{~town}</attval>, to
! include the element without percent-encoding.</p></item>
! </ulist>
!
! <p>Details are provided further below.</p>
!
! <p>The following EBNF <bibref ref="EBNF"/> grammar represents
the patterns for constructing the request IRI:
</p>
***************
*** 4301,4328 ****
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
--- 4310,4368 ----
openBrace ::= '{{'
closeBrace ::= '}}'
! elementName ::= rawElementName | encodedElementName
! rawElementName ::= '{!' NCName '}'
! encodedElementName ::= '{' NCName '}'</eg>
<p>The request IRI is constructed as follows:</p>
<ulist>
!
! <item><p>Each cited raw element (refered to as <el>rawElementName</el> in
! the grammar above) is replaced by the possibly empty single value
! of the corresponding element from the
! <termref def="instance_data">instance data</termref>,
! No percent-encoding performed.
! </p></item>
!
! <item><p>Each cited encoded element (refered to as <el>encodedElementName</el> in
! the grammar above) preceeded in the <prop comp="Binding Operation">http location</prop>
! property by a <attval>?</attval> or a <attval>#</attval> character, OR an uncited element,
! is encoded as follows: Any character in the replacement value falling outside the range
! <code>ALPHA | DIGIT | "-" | "." | "_" | "~" | "!" | "$"
! | "&" | "'" | "(" | ")" | "*" | "+" | "," | ";" | "=" | ":" | "@"</code>
! MUST be percent-encoded.</p></item>
!
! <item><p>Each cited encoded element NOT preceeded in the <prop comp="Binding Operation">http location</prop>
! property by a <attval>?</attval> or a <attval>#</attval> character,
! is encoded as follows: Any character in the XML value falling outside the range
! <code>ALPHA | DIGIT | "-" | "." | "_" | "~" | "!" | "$" | "&" | "'" | "(" |
! ")" | "*" | "+" | "," | ";" | "=" | ":" | "@" | "?" | "/"</code>
! MUST be percent-encoded.</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">Cited 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 or tilded single curly braces MUST be element names from the <termref
def="instance_data">instance data</termref> of the input
message.</assert></p></item>
!
! <item><p>Percent-encoding MUST be performed using the UTF-8 representation of the character
! as prescribed by section 6.4 of <bibref ref="RFC3987"/>.</p></item>
!
! <item><p>A double curly brace (refered to as <el>openBrace</el>
! or <el>closeBrace</el> in the grammar above) MAY be used to include a single,
! literal curly brace (i.e. <attval>{</attval> or <attval>}</attval> respectively)
! in the request IRI. This provides a simple escaping
! mechanism.</p></item>
!
! </ulist>
<p>Note that the mechanism described in this section could be used to
***************
*** 4330,4337 ****
(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>
--- 4370,4373 ----
***************
*** 4442,4445 ****
--- 4478,4489 ----
</p>
</item>
+
+ <item><p>Replacement values falling outside the range
+ <code>ALPHA | DIGIT | "-" | "." | "_" | "~" | "!" | "$" | "&" | "'"
+ | "(" | ")" | "*" | "+" | "," | ";" | "=" | ":" | "@"</code>
+ MUST be percent-encoded. Percent-encoding MUST be performed using the
+ UTF-8 representation of the character as prescribed by section 6.4 of
+ <bibref ref="RFC3987"/>.</p></item>
+
</ulist>
***************
*** 5488,5491 ****
--- 5532,5544 ----
<td>JJM</td>
<td><loc
+ href="http://www.w3.org/2002/ws/desc/5/cr-issues/issues.html#CR117">CR117</loc>:
+ Re: 6.7.1.1 Construction of the request IRI using the http location [half-way through]
+ </td>
+ </tr>
+
+ <tr>
+ <td>20070213</td>
+ <td>JJM</td>
+ <td><loc
href="http://www.w3.org/2002/ws/desc/5/cr-issues/issues.html#CR143">CR143</loc>:
Renamed "transfer coding" to "content coding", and made it explicit we set HTTP Content-Encoding.
Received on Tuesday, 13 February 2007 17:58:36 UTC