Proposal for spec changes for "action" feature.

Hi folks:

At last week's call, Jean-Jacques and I took an action to write up what changes to the spec might look like in order to describe an "action" feature which would allow setting the action parameter of the SOAP media type on bindings which use MIME serialization.  The following is a cut at the text changes.  We believe this addition to be fairly minor (as with most features, it exists primarily to ease the creation of other specs and service descriptions which refer to these items in a clear and precise manner).  In particular, implementations will not be required to do anything particularly different as a result of this addition.

-- Jean-Jacques and Glen

--- Begin spec amendment ---

[introduce new section 6.5]

6.5 Action Feature

This section describes the "Action Feature".

6.5.1 Feature Name

The Action Feature is identified by the URI (see SOAP 1.2
Part 1 [SOAP Part 1] SOAP Features):

* "http://www.w3.org/2002/12/soap/features/action/"

6.5.2 Description

Many SOAP 1.2 underlying protocol bindings will likely
utilize the "application/soap+xml" media type (described in
Appendix A) to transmit XML serializations of SOAP messages.
The media type specifies an optional "action" parameter (see
A.3), which can be used to optimize dispatch or routing,
among other things.  The Action Feature specifies well-known
URIs to indicate support for the action parameter in
bindings which use MIME, and also to refer to value of the
parameter itself.

6.5.3 Action feature state machine

The Action feature describes a single property

http://www.w3.org/2002/12/soap/features/action/action

of type xsd:string.

If this property has a value at a sending node utilizing a
binding supporting this feature, the node MUST use the
property value as the value of the "action" parameter in
the media type designator.

Conversely, if a value arrives in the "action" parameter of
the media type designator at a receiving node, the node MUST
make that value available as the value of the action
property.

[section 7.4 HTTP binding, add the feature URI above to the
list of features supported]

[section 7.5.1.1 Init, table 15, add a new row]

[Field] action parameter
[Value] According to the
http://www.w3.org/2002/12/soap/features/action/action
property

--- End spec amendment ---

Received on Monday, 31 March 2003 03:26:22 UTC