- 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
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"><binding name="reservationSOAPBinding" type="tns:reservationInterface">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" />
<wsaw:UsingAddressing wsdl:required="true" />
--- 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"><binding name="reservationSOAPBinding" type="tns:reservationInterface">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" />
<wsaw:UsingAddressing wsdl:required="true" />
***************
*** 558,593 ****
</binding>
</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 ----
</binding>
</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 UTC