W3C home > Mailing lists > Public > public-ws-addressing-eds@w3.org > April to June 2006

2004/ws/addressing ws-addr-wsdl.xml,1.94,1.95

From: Tony Rogers via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 28 Apr 2006 13:25:13 +0000
To: public-ws-addressing-eds@w3.org
Message-Id: <E1FZSy9-00026w-QN@lionel-hutz.w3.org>

Update of /sources/public/2004/ws/addressing
In directory hutz:/tmp/cvs-serv8057

Modified Files:
	ws-addr-wsdl.xml 
Log Message:
Implemented the resolution of LC129, removing the default for wsaw:Anonymous

Index: ws-addr-wsdl.xml
===================================================================
RCS file: /sources/public/2004/ws/addressing/ws-addr-wsdl.xml,v
retrieving revision 1.94
retrieving revision 1.95
diff -C2 -d -r1.94 -r1.95
*** ws-addr-wsdl.xml	28 Apr 2006 13:09:30 -0000	1.94
--- ws-addr-wsdl.xml	28 Apr 2006 13:25:11 -0000	1.95
***************
*** 477,547 ****
                  
              </div2>
!             <div2  id="anonelement">
                  <head> Anonymous Element </head>
!                 <p>
! 		WS-Addressing defines a wsaw:Anonymous element that
! 		is only used in conjunction with
! 		wsaw:UsingAddressing (or its equivalent wsoap:module)
! 		element. The usage of wsaw:Anonymous element is
! 		associated with the usage constraints specified for
! 		the wsaw:UsingAddressing element. Hence, it MUST NOT
! 		contain the wsdl:required attribute.
!                 </p>
!                 <p>The inclusion of wsaw:Anonymous without inclusion
!                 of wsaw:UsingAddressing has no normative meaning and is
!                 only informational. In other words, the inclusion of
!                 wsaw:Anonymous element in WSDL alone does not imply a
!                 requirement on clients to use Message Addressing
!                 Properties in messages it sends to the service. A
!                 client, however, MAY include Message Addressing
!                 Properties in the messages it sends, either on its own
!                 initiative or as described by other elements of the
!                 service contract, regardless of the presence or
!                 absence of a wsaw:UsingAddressing element.
!                 </p>
!                 <p>The wsaw:Anonymous element MUST have one of three distinct
!                 values that indicate three different levels of support
!                 for handling anonymous addresses in EPRs. In the
!                 following text, the term response endpoint EPR refers
!                 to the [reply endpoint] and [fault endpoint] message
!                 addressing properties collectively.
!                 </p>
                  <ulist>
                      <item>
! 		        <p>"optional": This value indicates that
! 		        a response endpoint EPR in a request message
! 		        MAY contain an anonymous URI as an address.
! 		        </p>
!                         <p>This is the default value, omission of a wsaw:Anonymous element is equivalent to inclusion with this value.</p>
                      </item>
                      <item>
! 		        <p>"required":This value indicates that all
! 		        response endpoint EPRs in a request message
! 		        MUST always use anonymous URI as an address.
!                         </p>
!                         <p>If a response endpoint EPR does not contain
!                         the anonymous URI as an address value, then a
!                         predefined InvalidAddressingHeader fault
!                         defined in Web Services Addressing 1.0 - SOAP Binding [<bibref
!                         ref="WSADDR-SOAP"/>] MUST be generated. </p>
                      </item>
!                     <item> 
!                         <p>"prohibited":This value indicates that any
!                         response EPRs in a request message MUST NOT
!                         use anonymous URI as an address.</p>
! 			<p>If a response endpoint EPR contains the
! 			anonymous URI as an address value, then a
! 			predefined InvalidAddressingHeader fault
! 			defined in Web Services Addressing 1.0 - SOAP
! 			Binding [<bibref ref="WSADDR-SOAP"/>] MUST be
! 			generated. </p>
                      </item>
! 	       </ulist>
!                <p>This element MAY appear as a child of an operation
!                element in a binding element in WSDL 1.1, or as a
!                binding operation extension element in WSDL 2.0.</p>
!                <example>
! 	           <head> Indicating use of anonymous addresses using wsaw:Anonymous. </head>
! 		   <eg xml:space="preserve">&lt;binding name="reservationSOAPBinding" type="tns:reservationInterface"&gt;
  &nbsp; &lt;soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" /&gt;
  &nbsp; &lt;wsaw:UsingAddressing wsdl:required="true" /&gt;
--- 477,530 ----
                  
              </div2>
!             <div2 id="anonelement">
                  <head> Anonymous Element </head>
!                 <p> WS-Addressing defines a wsaw:Anonymous element that is only used in conjunction
!                     with wsaw:UsingAddressing (or its equivalent wsoap:module) element. The usage of
!                     wsaw:Anonymous element is associated with the usage constraints specified for
!                     the wsaw:UsingAddressing element. Hence, it MUST NOT contain the wsdl:required
!                     attribute. </p>
!                 <p>A WSDL or policy based service description that includes the wsaw:UsingAddressing
!                     but no wsaw:Anonymous marker makes no assertion regarding a requirement or a
!                     constraint in the use of the anonymous URI in EPRs contained in messages sent to
!                     the endpoint. In this cases, endpoint service descriptions have to rely on
!                     additional metadata, such as WSDL bindings or additional policy assertions, to
!                     indicate any requirements or restrictions on the use of the anonymous URI by
!                     clients. However, in the absence of additional metadata, clients of the endpoint
!                     MAY assume that the service endpoint follows the behavior indicated by the
!                     'optional' value of the wsaw:Anonymous marker. An endpoint SHOULD send a
!                     wsa:OnlyAnonymousAddressSupported or a wsa:OnlyNonAnonymousAddressSupported
!                     fault back to the client if a message received includes a response epr with an
!                     [address] that is unsupported by the endpoint. </p>
!                 <p>The wsaw:Anonymous element, if present, MUST have one of three distinct values that indicate
!                     three different levels of support for handling anonymous addresses in EPRs. In
!                     the following text, the term response endpoint EPR refers to the [reply
!                     endpoint] and [fault endpoint] message addressing properties collectively. </p>
                  <ulist>
                      <item>
!                         <p>"optional": This value indicates that a response endpoint EPR in a
!                             request message MAY contain an anonymous URI as an address. </p>
                      </item>
                      <item>
!                         <p>"required":This value indicates that all response endpoint EPRs in a
!                             request message MUST always use anonymous URI as an address. </p>
!                         <p>If a response endpoint EPR does not contain the anonymous URI as an
!                             address value, then a predefined InvalidAddressingHeader fault defined
!                             in Web Services Addressing 1.0 - SOAP Binding [<bibref ref="WSADDR-SOAP"
!                             />] MUST be generated. </p>
                      </item>
!                     <item>
!                         <p>"prohibited":This value indicates that any response EPRs in a request
!                             message MUST NOT use anonymous URI as an address.</p>
!                         <p>If a response endpoint EPR contains the anonymous URI as an address
!                             value, then a predefined InvalidAddressingHeader fault defined in Web
!                             Services Addressing 1.0 - SOAP Binding [<bibref ref="WSADDR-SOAP"/>]
!                             MUST be generated. </p>
                      </item>
!                 </ulist>
!                 <p>This element MAY appear as a child of an operation element in a binding element
!                     in WSDL 1.1, or as a binding operation extension element in WSDL 2.0.</p>
!                 <example>
!                     <head> Indicating use of anonymous addresses using wsaw:Anonymous. </head>
!                     <eg xml:space="preserve">&lt;binding name="reservationSOAPBinding" type="tns:reservationInterface"&gt;
  &nbsp; &lt;soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" /&gt;
  &nbsp; &lt;wsaw:UsingAddressing wsdl:required="true" /&gt;
***************
*** 558,593 ****
  &lt;/binding&gt;
  </eg>
!                </example>
!                <div3 id='wsdl20_anonymous'>
!                    <head>WSDL 2.0 Component Model Changes</head>
! 
! 		   <p>Use of the Anonymous element adds the following property to the WSDL 2.0 component model: </p>
!                    <ulist>
! 		       <item>
! 		           <p>{anonymous addresses} REQUIRED, of type xs:string, to the Binding Operation component.</p>
!                        </item>
!                    </ulist>
! 
! 		    <p><specref ref="tab_anonymous_Mapping"/> shows the
! 		    mapping from the XML representation to the WSDL
! 		    2.0 component model.</p>
! 
! 		    <table border="1" id="tab_anonymous_Mapping">
! 		      <caption>Mapping from XML Representation to Binding Operation component Extension Properties</caption>
! 		      <tbody>
! 			<tr>
! 			  <th rowspan="1" colspan="1">Property</th>
! 			  <th rowspan="1" colspan="1">Value</th>
! 			</tr>
! 			<tr>
! 			  <td>{anonymous addresses}</td>
! 			  <td>
! 			    The value of the <el>wsaw:Anonymous</el> &EII;, if present.
! 			    Otherwise, <attval>optional</attval>.
! 			  </td>
! 			</tr>
! 		      </tbody>
! 		    </table>
! 
                  </div3>
              </div2>
--- 541,572 ----
  &lt;/binding&gt;
  </eg>
!                 </example>
!                 <div3 id="wsdl20_anonymous">
!                     <head>WSDL 2.0 Component Model Changes</head>
!                     <p>Use of the Anonymous element adds the following property to the WSDL 2.0
!                         component model: </p>
!                     <ulist>
!                         <item>
!                             <p>{anonymous addresses} OPTIONAL, of type xs:string, to the Binding
!                                 Operation component.</p>
!                         </item>
!                     </ulist>
!                     <p><specref ref="tab_anonymous_Mapping"/> shows the mapping from the XML
!                         representation to the WSDL 2.0 component model.</p>
!                     <table border="1" id="tab_anonymous_Mapping">
!                         <caption>Mapping from XML Representation to Binding Operation component
!                             Extension Properties</caption>
!                         <tbody>
!                             <tr>
!                                 <th rowspan="1" colspan="1">Property</th>
!                                 <th rowspan="1" colspan="1">Value</th>
!                             </tr>
!                             <tr>
!                                 <td>{anonymous addresses}</td>
!                                 <td> The value of the <el>wsaw:Anonymous</el> &EII;, if present.
!                                     Otherwise, it is not present. </td>
!                             </tr>
!                         </tbody>
!                     </table>
                  </div3>
              </div2>
Received on Friday, 28 April 2006 13:25:37 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:19:41 GMT