W3C home > Mailing lists > Public > public-soap-jms@w3.org > September 2009

ISSUE-14 (WSDL conformance statements missing): Apparently normative statements about WSDL are not written that way. [SOAP-JMS Binding specification]

From: SOAP-JMS Binding Working Group Issue Tracker <sysbot+tracker@w3.org>
Date: Tue, 29 Sep 2009 00:38:08 +0000 (GMT)
To: public-soap-jms@w3.org
Message-Id: <20090929003808.849E3BF91@nelson.w3.org>

ISSUE-14 (WSDL conformance statements missing): Apparently normative statements about WSDL are not written that way. [SOAP-JMS Binding specification]

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

Raised by: Eric Johnson
On product: SOAP-JMS Binding specification

>From email:
http://lists.w3.org/Archives/Public/public-soap-jms/2009Sep/0019.html

Description: Section three of the specification includes statements that
sound like they're intended to be normative.  But they're not written
that way, or captured that way.

Section 3.4.2:

This section currently reads:
"The wsdl11soap11:binding element has a transport attribute. The
developer indicates the use of the SOAP/JMS binding by putting
http://www.w3.org/2008/07/soap/bindings/JMS/ as the value of the transport."

The should probably read something like:
"For each of SOAP 1.1 and SOAP 1.2, the @transport attribute of the
wsdl11soap11:binding element, and the wsdl11soap12:binding element,
respectively, indicate the transport value.  To indicate that this
SOAP/JMS binding is in use, the @transport attribute MUST be set to the
value http://www.w3.org/2008/07/soap/bindings/JMS/ ."

Section 3.4.5:
This section is missing any sort of declaration that ties the URL to the
use of JMS.  Suggest adding to the second paragraph of this section:

"The value of the @location attribute MUST be a URI corresponding to a
JMS Destination, and SHOULD be a "jms" scheme URI."

Section 3.5:

Has an sentence that reads:
"Line 4 shows the protocol URI in the wsoap:protocol attribute of the
<binding>, which indicates that this SOAP over JMS binding is in use."

This should probably read something like this:
"Line 4 shows the protocol URI in the @wsoap:protocol attribute of the
<binding>.  To indicate that this SOAP/JMS binding is in use, the
@wsoap:protocol attribute MUST be set to the value
http://www.w3.org/2008/07/soap/bindings/JMS/ ."

Section 3.5:
This section has another sentence that reads:
"Lines 18-19 are also additions to specify the location at which this
new implementation exists. Line 19 showing the JMS URI Scheme jms: in
the address  attribute of the <endpoint> element. As with the WSDL 1.1
binding, you may also set connection properties in the URI."

This should get an additional sentence:
"The value of the @address attribute MUST be a URI corresponding to a
JMS Destination, and SHOULD be a "jms" scheme URI."
Received on Tuesday, 29 September 2009 00:38:18 GMT

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