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

[jsr339-experts] Re: client revisions

From: Bill Burke <bburke_at_redhat.com>
Date: Tue, 23 Aug 2011 12:20:25 -0400

On 8/23/11 7:19 AM, Marek Potociar wrote:
>
>
> On 08/22/2011 05:49 PM, Sergey Beryozkin wrote:
>> I was actually looking forward to Bill's revision being approved too - thought there was some agreement about
>> finalizing the chain with get()/etc in most cases and generally I thought it was step forward toward the simplification of the client api.
>
> While we agree with Bill in the end result (i.e. what the end-user sees in code), we seem to differ in the solution.
> Bill prefers API simplicity over consistency. I prefer API consistency over simplicity, esp. in case of a fluent API.
> When it comes to the ease of use, both versions are comparably easy to use.
>

The thing is, I doubt anybody will care if its 100% fluent. The
previous version was already pretty much 99% fluent. Even that 1%
difference was up for debate, IMO on whether it was "fluent" or not.

Easy-to-use needs also to be easy-to-learn. You can't learn this API
looking at the javadoc, which is a huge minus IMO.

-- 
Bill Burke
JBoss, a division of Red Hat
http://bill.burkecentral.com