RE: Primer Review

Hi David,
While incorporating your suggestions below, I came across a few more
questions. Please see below.

Best Regards,



[] On Behalf Of David Orchard
	Sent: Thursday, Jun 30, 2005 12:19 PM
	Subject: Primer Review

	I reviewed the primer for the HTTP binding and ext/versioning
examples.  I did find a few things that need or could use changing.



	As DavidB suggests, the example should be {checkAvailability}
	[Kevin] I don't quite understand your point here. Do you mean
change the value of whttp:location in example 2-12 to
"{CheckAvailability}"? That doesn't answer the question in the Ed note.


	Let's have a closer look at the definition of


	      <xs:element name="checkAvailability"
	      <xs:complexType name="tCheckAvailability">     
	          <xs:element  name="checkInDate" type="xs:date"/>      
	          <xs:element  name="checkOutDate" type="xs:date"/>

	          <xs:element  name="roomType" type="xs:string"/>      


	The question is what kind of elements can be assigned to the
whttp:location.  Should it only be "leaf" element such as "checkInDate"?
or can it be an element that is defined using a complex type, such as
CheckAvailability which contains three children elements. In the
following example, if we let whttp:location = "{CheckAvailability}, then
how the serialization works?   


	If we let whttp:location= "{checkInDate}", should
"checkAvailability" be part of the URI? more specifically, should the
URI be a, b, or something else? 


-5&roomType=foo> . 




	Upon further reflection, I'd suggest changing the section a bit
by having the first example use the safe attribute 

	 and then an example that shows methodDefault, rather than the
inverse as is done now.


	I suggest that example 2-14 just shows setting the

	[Kevin]  you mean take whttp:methodDefault="GET" out from
example 2-12, and move it to example 2-14? 

	 Change "The reservation service can accept" to "The
reservation service is changed to a newer version that can accept" s/Mandadtory/Mandatory/g Formatting of example needs indenting, operation needs
closing > Formatting of example needs indenting for wsoap:action  The example should be


	<xs:element name="ghns2:makeReservation"


	<interface . . .>

	   <operation name="makeReservation">

	       <input messageLabel="In" element="ghns2:makeReservation"


Received on Wednesday, 6 July 2005 19:46:48 UTC