W3C home > Mailing lists > Public > public-soap-jms@w3.org > March 2010

ISSUE-31: soapjms:isFault typing is ambiguous and its value is weakened because it is an optional property

From: SOAP-JMS Binding Working Group Issue Tracker <sysbot+tracker@w3.org>
Date: Tue, 2 Mar 2010 14:07:17 +0000 (GMT)
To: public-soap-jms@w3.org
Message-Id: <20100302140717.070BEC6DB9@barney.w3.org>

ISSUE-31: soapjms:isFault typing is ambiguous and its value is weakened because it is an optional property

http://www.w3.org/2002/ws/soapjms/tracker/issues/31

Raised by: Mark Phillips
On product: 

There is a disparity between the text in 2.2.3 which talks about the value of soapjms:isFault being 0 or 1, and the example in 2.2.3.1 which shows it being set as a Boolean property.  

Furthermore, presumably the main value of "isFault" is that it allows faults to be detected quickly without needing to parse the SOAP payload.  However, because the property is optional, an implementation cannot rely on the property to detect faults (or non-fault responses).  I suggest we make this mandatory - at least for faults.   Should be added to the table in 2.6.2.3 (responding node)

Proposal: 
In section 2.2.3, change: 
[Definition: soapjms:isFault] (xsd:boolean) 
        *          This property indicates whether a SOAP/JMS message is a fault. For senders, this property should be set to true when responding with a SOAP fault. When this property is true, the sending software SHOULD  include a JMS property named SOAPJMS_isFault with a value of 1.
        *          For receivers, this property is derived from the JMS property named SOAPJMS_isFault — if present and containing a value of 1, the value of soapjms:isFault is true. If omitted, or present with a value of 0, the value of soapjms:isFault is false.

to:

        *          This property indicates whether a SOAP/JMS message is a fault. For senders, this property is set to true when responding with a SOAP fault. When this property is true, the sending software MUST include a JMS property named SOAPJMS_isFault with a value of true.
        *          For receivers, this property is derived from the JMS property named SOAPJMS_isFault — if present and containing a value of true, the value of soapjms:isFault is true. If omitted, or present with a value of false, the value of soapjms:isFault is false.

...this change would introduce a new assertion in the first bullet, which would require a test case.  


In section 2.6.2.3, add a new row to the JMS Message properties section of the table 

SOAPJMS_isFault	  -   Set to true if the response is a SOAP fault
Received on Tuesday, 2 March 2010 14:07:18 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 18:16:23 GMT