jsr339-experts@jax-rs-spec.java.net

[jsr339-experts] Re: Client API: Low-Level vs High Level

From: Marek Potociar <marek.potociar_at_oracle.com>
Date: Thu, 01 Sep 2011 14:27:24 +0200

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

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.

Marek

>
> Thanks, Sergey
>