hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebb <seb...@gmail.com>
Subject Re: [ANNOUNCEMENT] HttpClient 4.0 is nearing API freeze / API review request
Date Sun, 25 May 2008 10:24:04 GMT
On 24/05/2008, Sam Berlin <sberlin@gmail.com> wrote:
> Depending on the timeframe, I think this means httpcore has to have a
>  beta2 sooner, too.  (Can a release of httpclient rely on a snapshot of
>  httpcore?)

For full releases no, but I'm not sure beta releases need to be
restricted that way

On the API freeze, I've not actually had a chance to try httpclient yet.

For classes that are intended to be threadsafe, it's worth trying to
make them immutable as far as possible to reduce the number of states
they can be in. In particular, if class variables can be set via
constructors, having set/get methods as well means that the variables
have to be volatile - or the methods must be synchronized (and the
class itself must use synch. if the variables are accessed through
other methods). Final variables are a lot easier to deal with, so
consider dropping the set methods if they aren't essential.

Another point is visibility of variables - as far as possible these
should be private.
It's easy to relax the restriction later if necessary. This is
particularly important for classes that must be threadsafe.

>  Sam
>  On Sat, May 24, 2008 at 7:03 AM, Oleg Kalnichevski <olegk@apache.org> wrote:
>  > Folks
>  >
>  > The redesign of HttpClient is now complete. All known problems with the
>  > old (3.x) API and architecture limitations have been resolved. All
>  > features planned for the 4.0 release are now in place.
>  >
>  > Due to the release schedule of one of our upstream projects we will have
>  > to freeze the 4.0 API rather sooner than later. The next release is
>  > likely to be BETA1 not ALPHA5, as initially planned.
>  >
>  > If your project depends on HttpClient, this is the time to check the new
>  > API out and let us know what you think. If we do not get more feedback /
>  > change requests, the current SVN snapshot is very likely to be the API
>  > HttpClient 4.0 will ship with. If you ever wanted to have something
>  > fixed or improved in HttpClient API, this is pretty much the last chance
>  > to ask for it.
>  >
>  > The current SVN snapshot can be found here:
>  >
>  > http://people.apache.org/~olegk/4.0-API-review/
>  >
>  > Oleg
>  >
>  >
>  > ---------------------------------------------------------------------
>  > To unsubscribe, e-mail: httpclient-users-unsubscribe@hc.apache.org
>  > For additional commands, e-mail: httpclient-users-help@hc.apache.org
>  >
>  >
> ---------------------------------------------------------------------
>  To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
>  For additional commands, e-mail: dev-help@hc.apache.org

To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org

View raw message