List Info

Thread: Http location text for 6.8.1.1




Http location text for 6.8.1.1
user name
2007-02-22 11:14:30
Jonathan,
as requested on the WG call today, here is (I think) the new text for bullet 2 in section 6.8.1.1 in part 2

For each encoded template (encodedTemplate production in the grammar above) NOT preceded in the
{http location} property by a "?" or a "#" character, the characters NOT in the following set MUST
be percent-encoded:

    * The characters in the range: ALPHA | DIGIT | "-" | "." | "_" | "~" | "!" | "$" | "';" | "(" |
     ; ")" | "*" | "+" | "," | ";" | "=" | ":" | "" | "&;".

regards,
John Kaputin
RE: Http location text for 6.8.1.1
country flaguser name
United States
2007-02-22 15:26:25

I still think the text of 6.8.1.1 is a bit imprecise.  Below I propose some editorial work to fix it.  I’ve included a MS Word diff version as well.  I haven’t addressed the questions of “;”, “=”, or “&” in this text, which are more substantial questions.

 

The request IRI is constructed as follows:

·         The local name in a template SHOULD match at least one element from the instance data of the input message. When there is no match, the template is replaced by an empty string. Otherwise, the template consumes the first non-consumed matching element from the instance data. The next occurrence of the template consumes the next non-consumed matching element, and so on until all templates are processed. Matching elements are consumed in the order in which they appear in the instance data.  Cited elements (i.e. elements referenced in templates) MUST NOT carry an xs:nil attribute whose value is "true".

·         Each raw template (rawTemplate production in the grammar above) is replaced by the possibly empty single value of the corresponding element from the instance data. No percent-encoding is performed.

·         Each encoded template (encodedTemplate production in the grammar above) NOT preceded in the {http location} property by a "?" or a "#" character is replaced by the possibly empty single value of the corresponding element from the instance data.  All characters EXCEPT the following ones MUST be percent-encoded:

o        ALPHA | DIGIT | "-" | "." | "_" | "~" | "!" | "$" | "'" | "(" | ")" | "*" | "+" | "," | ";" | "=" | ":" | "".

·         Each encoded template (encodedTemplate production in the grammar above) preceded in the {http location} property by a "?" or a "#" character is replaced by the possibly empty single value of the corresponding element from the instance data.  All the following characters MUST be percent-encoded:

o        The value of the {http query parameter separator} property, if present, otherwise the value of the {http query parameter separator default} property.

o        The other characters, EXCEPT the ones in the range: ALPHA | DIGIT | "-" | "." | "_" | "~" | "!" | "$" | "'" | "(" | ")" | "*" | "+" | "," | ";" | "=" | ":" | "" | "?" | "/".

·         Each uncited element (i.e. each element not referenced in a template) to be serialized, if any, is encoded as for an encoded template.

·         Percent-encoding MUST be performed using the UTF-8 representation of the character as prescribed by section 6.4 of [IETF RFC 3987].

·         Each double curly brace (openBrace or closeBrace production in the grammar above) is replaced by a single literal curly brace ("{" or "}" respectively). This provides a simple escaping mechanism.

 

 

 


From: www-ws-desc-requestw3.org [mailto:www-ws-desc-requestw3.org] On Behalf Of John Kaputin (gmail)
Sent: Thursday, February 22, 2007 9:15 AM
To: www-ws-desc
Subject: Http location text for 6.8.1.1

 

Jonathan,
as requested on the WG call today, here is (I think) the new text for bullet 2 in section 6.8.1.1 in part 2

For each encoded template (encodedTemplate production in the grammar above) NOT preceded in the
{http location} property by a "?" or a "#" character, the characters NOT in the following set MUST
be percent-encoded:

    * The characters in the range: ALPHA | DIGIT | "-" | "." | "_" | "~" | "!" | "$" | "'" | "(" |
     ; ")" | "*" | "+" | "," | ";" | "=" | ":" | "" | "&".

regards,
John Kaputin

  
Re: Http location text for 6.8.1.1
user name
2007-03-01 02:29:26
+1 to your proposed text. (Why did firefox automatically
select my gmail 
identity when I responded yesterday? and the message got
lost.)

JJ.

Jonathan Marsh wrote:
>
> I still think the text of 6.8.1.1 is a bit imprecise. 
Below I propose 
> some editorial work to fix it.  I’ve included a MS Word
diff version 
> as well.  I haven’t addressed the questions of “;”,
“=”, or “&” in 
> this text, which are more substantial questions.
>
>  
>
> The request IRI is constructed as follows:
>
> ·         The local name in a template SHOULD match at
least one 
> element from the instance data 
> <http://dev.w3.org/cv
sweb/%7Echeckout%7E/2002/ws/desc/wsdl20/wsdl20-adjuncts.html
?content-type=text/html;%20charset=utf-8#instance_data#insta
nce_data> 
> of the input message.^† 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2002/w
s/desc/wsdl20/wsdl20-adjuncts.html?content-type=text/html;%2
0charset=utf-8#HTTPSerialization-5073-summary#HTTPSerializat
ion-5073-summary> 
> When there is no match, the template is replaced by an
empty string. 
> Otherwise, the template consumes the first non-consumed
matching 
> element from the instance data 
> <http://dev.w3.org/c
vsweb/%7Echeckout%7E/2002/ws/desc/wsdl20/wsdl20-adjuncts.htm
l?content-type=text/html;%20charset=utf-8#instance_data#inst
ance_data>. 
> The next occurrence of the template consumes the next
non-consumed 
> matching element, and so on until all templates are
processed. 
> Matching elements are consumed in the order in which
they appear in 
> the instance data 
> <http://dev.w3.org/c
vsweb/%7Echeckout%7E/2002/ws/desc/wsdl20/wsdl20-adjuncts.htm
l?content-type=text/html;%20charset=utf-8#instance_data#inst
ance_data>.  
> Cited elements (i.e. elements referenced in templates)
MUST NOT carry 
> an |xs:nil| attribute whose value is "true"^†

> <http://dev.w3.org/cvsweb/%7Echeckout%7E/
2002/ws/desc/wsdl20/wsdl20-adjuncts.html?content-type=text/h
tml;%20charset=utf-8#HTTPSerialization-2607010-summary#HTTPS
erialization-2607010-summary> 
> .
>
> ·         Each raw template (|rawTemplate| production
in the grammar 
> above) is replaced by the possibly empty single value
of the 
> corresponding element from the instance data 
> <http://dev.w3.org/c
vsweb/%7Echeckout%7E/2002/ws/desc/wsdl20/wsdl20-adjuncts.htm
l?content-type=text/html;%20charset=utf-8#instance_data#inst
ance_data>. 
> No percent-encoding is performed.
>
> ·         Each encoded template (|encodedTemplate|
production in the 
> grammar above) NOT preceded in the {http location 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2002/ws/d
esc/wsdl20/wsdl20-adjuncts.html#property-BindingOperation.ht
tplocation>} 
> property by a "?" or a "#"
character is replaced by the possibly empty 
> single value of the corresponding element from the
instance data 
> <http://dev.w3.org/c
vsweb/%7Echeckout%7E/2002/ws/desc/wsdl20/wsdl20-adjuncts.htm
l?content-type=text/html;%20charset=utf-8#instance_data#inst
ance_data>.  
> All characters EXCEPT the following ones MUST be
percent-encoded:
>
> o        |ALPHA | DIGIT | "-" | "."
| "_" | "~" | "!" |
"$" | "'" | 
> "(" | ")" | "*" |
"+" | "," | ";" |
"=" | ":" | ""|.
>
> ·         Each encoded template (|encodedTemplate|
production in the 
> grammar above) preceded in the {http location 
> <http://dev.w3.org/cvsweb/%7Echeckout%7E/2002/ws/d
esc/wsdl20/wsdl20-adjuncts.html#property-BindingOperation.ht
tplocation>} 
> property by a "?" or a "#"
character is replaced by the possibly empty 
> single value of the corresponding element from the
instance data 
> <http://dev.w3.org/c
vsweb/%7Echeckout%7E/2002/ws/desc/wsdl20/wsdl20-adjuncts.htm
l?content-type=text/html;%20charset=utf-8#instance_data#inst
ance_data>.  
> All the following characters MUST be percent-encoded:
>
> o        The value of the {http query parameter
separator 
> <http://dev.w3.org/cvsweb/%7Echecko
ut%7E/2002/ws/desc/wsdl20/wsdl20-adjuncts.html#property-Bind
ingOperation.httpqueryparameterseparator>} 
> property, if present, otherwise the value of the {http
query parameter 
> separator default 
> <http://dev.w3.org/cvsweb/%7Echeckout
%7E/2002/ws/desc/wsdl20/wsdl20-adjuncts.html#property-Bindin
g.httpqueryparameterseparatordefault>} 
> property.
>
> o        The other characters, EXCEPT the ones in the
range: |ALPHA | 
> DIGIT | "-" | "." | "_" |
"~" | "!" | "$" |
"'" | "(" | ")" |
"*" | 
> "+" | "," | ";" |
"=" | ":" | "" | "?" |
"/"|.
>
> ·         Each uncited element (i.e. each element not
referenced in a 
> template) to be serialized, if any, is encoded as for
an encoded template.
>
> ·         Percent-encoding MUST be performed using the
UTF-8 
> representation of the character as prescribed by
section 6.4 of [/IETF 
> RFC 3987 
> <http://dev.w3.org/cvsweb/%7Eche
ckout%7E/2002/ws/desc/wsdl20/wsdl20-adjuncts.html?content-ty
pe=text/html;%20charset=utf-8#RFC3987#RFC3987>/].
>
> ·         Each double curly brace (|openBrace| or
|closeBrace| 
> production in the grammar above) is replaced by a
single literal curly 
> brace ("{" or "}" respectively).
This provides a simple escaping 
> mechanism.
>
>  
>
>  
>
>  
>
> **Jonathan Marsh** - http://www.wso2.com - 
> http://auburnmar
shes.spaces.live.com
>
>  
>
>
------------------------------------------------------------
------------
>
> *From
www-ws-desc-requestw3.org [mailto:www-ws-desc-requestw3.org] 
> *On Behalf Of *John Kaputin (gmail)
> *Sent Thursday,
February 22, 2007 9:15 AM
> *To
www-ws-desc
> *Subject Http
location text for 6.8.1.1
>
>  
>
> Jonathan,
> as requested on the WG call today, here is (I think)
the new text for 
> bullet 2 in section 6.8.1.1 <http://6.8.1.1> in part 2
>
> For each encoded template (encodedTemplate production
in the grammar 
> above) NOT preceded in the
> {http location} property by a "?" or a
"#" character, the characters 
> NOT in the following set MUST
> be percent-encoded:
>
>     * The characters in the range: ALPHA | DIGIT |
"-" | "." | "_" | 
> "~" | "!" | "$" |
"'" | "(" |
>       ")" | "*" | "+" |
"," | ";" | "=" |
":" | "" | "&".
>
> regards,
> John Kaputin
>



[1-3]

about | contact  Other archives ( Real Estate discussion Medical topics )