2002/ws/desc/wsdl20 wsdl20-adjuncts.xml,1.210,1.211

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