Hi Sanjeewa
On Thu, Oct 22, 2015 at 1:47 PM, Sanjeewa Malalgoda <[email protected]>
wrote:
>
>
> Other important thing we should focus is define resources which do not
> accept query parameters.
>
What would be a use case for this ? Usually in APIs we simply ignore the
additional query parameters.
> And other important usage of * is create APIs for services which does not
> implemented completely.
> As example we can have this kind of resource
>
> /bookStore/{bookID}*
>
> In future backend service implementation may have
> /bookStore/{bookID}/move
> /bookStore/{bookID}/transfer
> etc.
>
> So its not necessary query parameters but those are control verbs in
> resource path(no query parameters).
> So we may need to focus on that aspect as well.
>
Above use case can be handled by using "/bookStore/{bookID}{/paths*}"
which will qualify above paths see [1].
Thanks
Jo
[1] https://tools.ietf.org/html/rfc6570#section-3.2.6
>
> Thanks,
> sanjeewa.
>
> On Thu, Oct 22, 2015 at 12:00 PM, Joseph Fonseka <[email protected]> wrote:
>
>>
>>
>>> Do you think we can migrate Resources of APIs which have been defined
>>> with * without breaking existing clients?
>>>
>>
>> For API manager it is possible but this affects the existing ESB users
>> as well for them it would be a manual migration.
>>
>> 4. Support full URI Templates in ESB and only support what is supported
>>>> in swagger in API Manager.
>>>>
>>>
>>> I don't think it's a good idea to limit ourselves to what swagger
>>> supports.
>>>
>>
>> Yes that make sense going forward swagger might adopt the URI Templating.
>> If so we have following two options.
>> 1. Do nothing and clearly inform users if unsupported URITemplate is used
>> it will not work properly with swagger console.
>> 2. Use swagger vendor extension to give support to unsupported url
>> template.
>> Ex. In swagger we can use an attribute like "x-uri-template"
>> under a resource which will be used to create the resource in synapse.
>>
>> Regards
>> Jo
>>
>>
>>
>>> *Joseph Fonseka*
>>>> WSO2 Inc.; http://wso2.com
>>>> lean.enterprise.middleware
>>>>
>>>> mobile: +94 772 512 430
>>>> skype: jpfonseka
>>>>
>>>> * <http://lk.linkedin.com/in/rumeshbandara>*
>>>>
>>>>
>>>
>>> --
>>> Nuwan Dias
>>>
>>> Technical Lead - WSO2, Inc. http://wso2.com
>>> email : [email protected]
>>> Phone : +94 777 775 729
>>>
>>>
>>
>>
>> --
>>
>> --
>> *Joseph Fonseka*
>> WSO2 Inc.; http://wso2.com
>> lean.enterprise.middleware
>>
>> mobile: +94 772 512 430
>> skype: jpfonseka
>>
>> * <http://lk.linkedin.com/in/rumeshbandara>*
>>
>>
>> _______________________________________________
>> Architecture mailing list
>> [email protected]
>> https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture
>>
>>
>
>
> --
>
> *Sanjeewa Malalgoda*
> WSO2 Inc.
> Mobile : +94713068779
>
> <http://sanjeewamalalgoda.blogspot.com/>blog
> :http://sanjeewamalalgoda.blogspot.com/
> <http://sanjeewamalalgoda.blogspot.com/>
>
>
>
> _______________________________________________
> Architecture mailing list
> [email protected]
> https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture
>
>
--
--
*Joseph Fonseka*
WSO2 Inc.; http://wso2.com
lean.enterprise.middleware
mobile: +94 772 512 430
skype: jpfonseka
* <http://lk.linkedin.com/in/rumeshbandara>*
_______________________________________________
Architecture mailing list
[email protected]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture
