What is whttp:location? (xmlns:whttp="http://www.w3.org/ns/wsdl/http")

Lets take another example where we have multiple input parameters, Here we are exposing an operation named getBooks which has three input parameters author, publisher and numberOfResults. The schema that defines this input message would be

<xs:complexType name="getBooksType">
    <xs:sequence>
        <xs:element name="author" type="xs:string"/>
        <xs:element name="publisher" type="xs:string"/>
        <xs:element minOccurs="0" name="numberOfResults" type="xs:int"/>
    </xs:sequence>
</xs:complexType>

<xs:element name="getBooks" type="ws:getBooksType"/>

Lets assume the instance data is

<getBooks>
    <author>deepal</author>
    <publisher>packtpub</publisher>
    <numberOfResults>10</numberOfResults>
</getBooks>

Assume that whttp:location=”bookService/books/{author}/{publisher}. In this case the request URL would be bookService/books/deepal/packtpub?numberOfResults=10. As the http location property explicitly stated that author and publisher should appear in the path segment of the URL they are serialized as such. Nothing was mentioned about numberOfResults, hence it appears as a query parameter.

Assume that whttp:location=”bookService/books/{author}. In this case  the request URL corresponding to this would be bookService/books/deepal?publisher=packtpub&numberOfResults=10. Here both publisher and numberOfResults appear as query parameters.

This essentially shows how you make your operation available at a dynamic URL using the whttp:location property.

Author: Keith Chapmon, Senior Software Engineer, WSO2 Inc. keith at wso2 dot com