ISSUE-26: Encoding URI parameters for use in WSDL

mphillip

Encoding URI parameters for use in WSDL

State:
CLOSED
Product:
SOAP-JMS Binding specification
Raised by:
Mark Phillips
Opened on:
2010-01-25
Description:
When using multiple query parameters on a URI in WSDL documents, the parameter separator '&' needs to be escaped to ensure valid XML. This is not immediately obvious and is not mentioned in the specification..

Proposal:

In section 3.4.5, add a new final paragraph:

If more than one property is used in a URI, then the URI query parameters will be separated by an ampersand. To ensure that this ampersand does not invalidate the XML document, it MUST be escaped with the "&amp" XML character reference. This is true for any of the character entities that require special encoding in XML (e.g. &, <,>, ',"). (This is in addition to any URI encoding though this is arguably covered in the URI spec). We should make this clearer with at least one example showing multiple properties in a WSDL URI, and possibly a property showing URI encoding.

Change:

<wsdl11soap11:address location="jms:jndi:destinationName?targetService=service1"/>

to:

<wsdl11soap11:address location="jms:jndi:destinationName?targetService=service1&amp;priority=5&amp;userAddress=5%20Main%20Street"/>
Related Actions Items:
No related actions
Related emails:
  1. Applied resolution for action 141 (from M8PHILLI@uk.ibm.com on 2010-02-16)
  2. Agenda for 2010-02-09 conference call (from eric@tibco.com on 2010-02-08)
  3. Agenda for 2010-02-02 conference call (from eric@tibco.com on 2010-02-01)
  4. ACTION-134 - propose alternate wording to resolve ISSUE-26 (from eric@tibco.com on 2010-02-01)
  5. Agenda for the 2010-01-26 conference call (from eric@tibco.com on 2010-01-25)
  6. ISSUE-26 (mphillip): Encoding URI parameters for use in WSDL [SOAP-JMS Binding specification] (from sysbot+tracker@w3.org on 2010-01-25)

Related notes:

Opened as per conference call of 2010-01-26: http://www.w3.org/2010/01/26-soap-jms-minutes.html

Eric Johnson, 2 Feb 2010, 00:04:26

Applied resolution accepted as per:
http://www.w3.org/2010/02/16-soap-jms-minutes.html

Eric Johnson, 23 Feb 2010, 00:51:48

Display change log ATOM feed


Chair, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: 26.html,v 1.1 2013-09-16 14:06:35 carine Exp $