OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

ws-tx message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: NEW Issue - Remove wsaw:Action attribute from WSDL



Protocol: All WS-Tx

Artifact:  Specs and WSDL

Draft:  AT, C PR drafts; BA CD-03

Link to the document referenced:

http://docs.oasis-open.org/ws-tx/wstx-wscoor-1.1-spec-pr-01.pdf
http://docs.oasis-open.org/ws-tx/wstx-wsat-1.1-spec-pr-01.pdf
http://www.oasis-open.org/apps/org/workgroup/ws-tx/download.php/20776/wstx-wsba-1.1-spec-cd-03.pdf



Issue type: Editorial
Related issues: i098, i099

Issue Description:

Issue i099 properly noted that the WSDLs incorrectly used the "wsa" rather
than the "wsaw" namespace for the message "action" attribute.
While changing to the "wsaw" namespace is technicaLly correct it may be
premature in that the WS-Addressing WSDL binding spec is not yet a Proposed
Recommendation and the wsaw namespace is likely to change.
Since there is no requirement to specify a wsaw:action attribute in the
WSDL, we can isolate ourselves from a dependency on the not-yet-stable wsaw
namespace by removing this attribute and the import of the schema for the
wsaw namespace.

The specifications already normatively define the action URI that MUST be
used in protocol messages. Having said that, the normative definition could
be made clearer than it currently is. The text (for example in the WS-C
spec) says:

The action URI MUST consist of the coordination namespace URI concatenated
with the '/' character and the element  name.  For example:

            http://docs.oasis-open.org/ws-tx/wscoor/2006/06/Register

It may not be clear what "element" refers to here. Also, the action URIs
for faults do not follow this pattern as there is no message element part
of the URI. Instead each spec defines a specific action URI to be used for
all protocol faults defined for that spec. For example, WS-C says:

WS-Coordination faults MUST include as the [action] property the following
fault action URI:
    http://docs.oasis-open.org/ws-tx/wscoor/2006/06/fault

Proposed resolution

1. Remove the wsaw:Action attribute and xsd:import of the wsaw namespace
from eack WSDL.

2. In each spec, move the text in the "Namespace" section that begins "The
action URI MUST consist of..."  to the section "Use of WS-Addressing
Headers" and and change the wording to:
Request and reply messages used in WS-Coordination MUST include as the
[action] property an action URI that consists of the wscoor namespace URI
concatenated with the "/" character and the element name of the message.
For example:

        http://docs.oasis-open.org/ws-tx/wscoor/2006/06/Register


or


Notification messages used in [WS-AtomicTransaction | WS-BusinessActivity]
MUST include as the [action] property an action URI that consists of the
[wsat | wsba] namespace URI concatenated with the "/" character and the
element name of the message.   For example:


        http://docs.oasis-open.org/ws-tx/wsat/2006/06/Commit


This is clearer about which "element" we are referring to. The definition
of the fault action URI can be left exactly as is.




[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]