On 01/09/11 13:27, Marek Potociar wrote:
>
>
> On 09/01/2011 02:06 PM, Sergey Beryozkin wrote:
>> Hi All,
>>
>> what are the differentiators between low-level and high-level APIs ?
>
> Low-level works with requests and responses. High-level works in some way with resource& representation objects,
> type-safely, the actual requests and responses happen in the background as needed. I don't have a better idea right now.
>
> There's a high-level RESTEasy API, which looks somewhat RPC-oriented to me, but I need to give it a more careful look:
> http://docs.jboss.org/resteasy/docs/2.2.1.GA/userguide/html/RESTEasy_Client_Framework.html
>
That may not sound very 'REST' friendly, but proxies are liked by a fair
number of users, I can judge it from a number of fixes I had to apply in
CXF to the relevant api...They are all RPC on the outside but produce
perfect HTTP requests...I'm sure we can talk a lot about whether using
proxies encourage a correct 'mindset' and such - but I think that they
can help with promoting the idea of building programmatic RESTful
endpoints...
> There's also a higher-level API in Jersey, which seems more RESTful and HATEOAS-oriented, but users may find it slightly
> difficult to fully understand at first:
> http://jersey.java.net/nonav/documentation/latest/user-guide.html#d4e1558
>
>>
>> Example, how would you imagine posting a payload (setting a Content-Type and a request entity) in either API ?
>>
>> By the way, is High-Level API still on the map for 2.0 ?
>
> Not sure yet. It's possible that we may need to drop it.
>
Right - that can make it more difficult for me in my quest to push
Entity API away from the low-level one to the high-level one :-)
Sergey
> Marek
>
>>
>> Thanks, Sergey
>>
--
Sergey Beryozkin
http://sberyozkin.blogspot.com
Talend - http://www.talend.com