RE: New Issue: Migration of @Action from WS-A 200408 to WS-A 1.0 [i064]

Per our AI from the FTF, Hugo, Anish, and I have agreed on updated
language for the i064 proposal:

 

Appendix XX: Compatibility of [action] with previous versions of
WS-Addressing (non-normative)

 

This section describes strategies for choosing [action] values
consistent between this specification and the WS-Addressing Member
Submission published 10 August 2004 (hereafter called "2004-08").  The
wsa200408 namespace prefix below refers to the
"http://schemas.xmlsoap.org/ws/2004/08/addressing
<http://schemas.xmlsoap.org/ws/2004/08/addressing> " namespace defined
in the 2004-08 version.

 

The WS-Addressing 1.0 [action] property, which identifies the semantics
implied by a message, is semantically equivalent to the [action] message
information header defined in the 2004-08 version.  Authors are
therefore advised to use the same value for 1.0 [action] and 2004-08
[action].

 

However, when describing services in WSDL, the namespace of the Action
attribute used to associate values with WSDL operations differs in the
two versions (wsaw:Action versus wsa200408:Action), and the default
action pattern in WS-Addressing 1.0 differs in two respects from that in
the 2004-08 version: the [delimiter] can be either "/" or ":" in 1.0
while in 2004-08 it is always "/", and the default action pattern for
faults is closer to that of other messages instead of a constant URI.

 

If a default action pattern is desired, this specification recommends
the 1.0 default action pattern.  The 200408 [action] can be made
consistent with the 1.0 default by:

 

1.	specifying wsa200408:Action explicitly when the targetNamespace
is a URN, and 
2.	specifying wsa200408:Action explicitly when the message is a
fault. 

 

If the targetNamespace is a URN, it is not advisable to use the 2004-08
default action pattern, as it leads to malformed IRIs.  If the
targetNamespace is not a URN, and the 2004-08 default action pattern is
in use, the 1.0 [action] value can be made consistent by:

 

1.	specifying wsaw:Action explicitly when the message is a fault. 

 

 

 

> -----Original Message-----

> From: Mark Nottingham [mailto:mark.nottingham@bea.com]

> Sent: Thursday, September 22, 2005 5:17 PM

> To: Jonathan Marsh

> Cc: public-ws-addressing@w3.org

> Subject: Re: New Issue: Migration of @Action from WS-A 200408 to WS-A

> 1.0 [i064]

> 

> This is now issue 064;

>    http://www.w3.org/2002/ws/addr/wd-issues/#i064

> 

> Sorry for the delay.

> 

> 

> On 30/08/2005, at 2:11 PM, Jonathan Marsh wrote:

> 

> > We've been exploring the best way to support both the 200408

> > version of WS-Addressing and eventually the 1.0 version in WSDL.

> > The Action attribute and the default action pattern rules pose an

> > interesting challenge.

> >

> >

> >

> > The @Action attribute serves identical purposes in the two versions

> > - they set the [action] property which is semantically the same

> > thing in both the 200408 and 1.0 versions.  We propose a non-

> > normative appendix to suggest ways users can author WSDLs that

> > allow a client to choose either version of Addressing, and that

> > unambiguously generate the same [action] values regardless of the

> > version of addressing chosen.  This appendix would highlight the

> > divergence of the default pattern between the 200408 and 1.0

> > versions and advise on how that difference can be managed.

> >

> >

> >

> > Note that in the majority of cases, the default patterns are

> > identical, requiring no explicit specification of the action in

> > either namespace to achieve the desired alignment.

> >

> >

> >

> > Proposal:

> >

> >

> >

> > Add the following non-normative appendix to the WS-Addressing WSDL

> > Binding spec.

> >

> >

> >

> > Appendix XX: Migration strategies from the 2004-08 version of WS-

> > Addressing

> >

> >

> >

> > The WS-Addressing 1.0 [action] property is semantically equivalent

> > to that described in the 2004-08 version of WS-Addressing. However,

> > the syntax (namespace of the attribute) used to specify values

> > differs in the two versions, and the default action pattern in WS-

> > Addressing 1.0 differs in two respects from that in the 2004-08

> > version: the [delimiter] can be either "/" or ":" in 1.0 while in

> > 2004-08 it is always "/", and the default action pattern for faults

> > is closer to that of other messages instead of a constant URI.

> >

> >

> >

> > Authors of WSDL that support both versions are advised to use the

> > same value for 1.0 [action] and 200408 [action].

> >

> >

> >

> > If a default action pattern is desired, we recommend the 1.0

> > default action pattern.  The 200408 [action] can be made consistent

> > with the 1.0 default by:

> >

> >

> >

> > specifying wsa200408:Action explicitly when the targetNamespace is

> > a URN, and

> > specifying wsa200408:Action explicitly when the message is a fault.

> >

> >

> > If the targetNamespace is a URN, we recommend against using the

> > 200408 default action pattern, as it leads to malformed IRIs.

> > Otherwise, if the 200408 default action pattern is used, the 1.0

> > [action] value can be made consistent by:

> >

> >

> >

> > specifying wsaw:Action explicitly when the message is a fault.

> >

> >

> > --  Jonathan Marsh  --  jmarsh@microsoft.com  --  http://

> > spaces.msn.com/members/auburnmarshes/  --

> >

> >

> >

> >

> 

> 

> --

> Mark Nottingham   Principal Technologist

> Office of the CTO   BEA Systems

> 

> ______________________________________________________________________

> __________

> BEAWorld 2005: coming to a city near you.  Everything you need for SOA

> and enterprise infrastructure success.

> 

> 

> Register now at http://www.bea.com/4beaworld

> 

> 

> Santa Clara 27-29 Sep| London 11-12 Oct| Paris13-14 Oct| Prague18-19

> Oct |Tokyo 25-26 Oct| Beijing 7-8 Dec