You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@hc.apache.org by Adrian Sutton <ad...@intencha.com> on 2004/03/18 13:15:56 UTC

Re: [PROPOSAL][DRAFT] Promote HttpClient to Jakarta level

Hi all,
Here's the updated proposal as promised.  A change log is below:

* Removed Sean C. Sullivan and Sung-Gu from the list of committers due to
them not having a CLA on file.  The email address for both these people is
their @apache.org address.  I've attempted to contact them at those
addresses but I imagine they will have been disabled.

* Removed Rodney Waldhoff from the list of committers pending his
notification that he'd like to remain with the project.  I have contacted
him off list about this just now and he will be immediately readded if he
wishes to be.  All other committers voted on the proposal to move to Jakarta
and so I assume to be still with the project.  If anyone "wants out", please
let me know.

* Changed to having separate lists for user and dev, with CVS commit
messages going to the dev list.

* Added commons-logging and commons-codec to the list of dependencies.

* Updated list of RFCs implemented to match the current list on the website.

* Updated list of projects using HttpClient to match those on the
applications page of the website.  I'm wondering if we now list too many.
Should we just have a statement to the effect that a wide range of projects
depend on HttpClient or should we actually list the ones we've been told
about?

I think that was all the requests that came in.  Let me know if I missed
something and as always comments and criticisms are encouraged.

Regards,

Adrian Sutton.

----------------
(0) RATIONALE
HTTP is the main protocol used today on the internet.  Although the JDK
includes basic support for building HTTP-aware client applications, it
doesn't provide the flexibility or ease of use needed for many projects.

The current package in Jakarta-Commons is a widely used implementation with
a strong community behind it.  The size of it's community and it's project
has significantly outgrown the commons project and a move to a Jakarta level
project would provide better support for that community and for the on going
development of HttpClient.

(1) SCOPE
The project shall create and maintain a Java library implementing the client
side of the HTTP 1.0 and 1.1 protocol, as defined in RFC 1945, RFC 2616 and
RFC 2617.

HttpClient also supports the following RFCs.

* RFC 2109 for HTTP state management mechanism (Cookies) - an upgrade to RFC
2965 is planned for a future version of HttpClient

* RFC 2396 Uniform Resoruce Identifiers (URI): Generic Syntax

* RFC 1867 Form-based File Upload in HTML

The package should:

* Have an API which should be as simple to use as possible
* Be as easy to extend as possible
* Provide unconditional support for HTTP/1.1

The package is quite different from the HTTP client provided as part of the
JDK (java.net.HttpURLConnection), as it focuses on the HTTP methods being
sent (instead of making that transparent to the user), and generally allows
more interaction with the lower level connection.  The JDK client is also
not very intuitive to use.

The package is used by a wide range of projects both within the ASF and from
third parties.  These include:

* Jakarta Slide
* Jakarta Commons Latka
* Nortel Networks
* HtmlUnit
* Jakarta Cactus
* JSR 147
* NOSE Applied Intelligence ag
* MindIQ's Design-a-Course
* ContactOffice
* Newknow
* de4d2c
* Furies
* Term Highlighting for Verity Ultraseek search results
* Mule - Universal Message Objects
* many more.

(1.5) Interaction With Other Packages

HttpClient relies on:

* Java Development Kit (Version 1.2 or later; 1.3 or later recommended)
* Jakarta commons-logging (Version 1.0 or later)
* Jakarta commons-codec (Version 1.2 or later)

(2) INITIAL SOURCE OF THE PACKAGE

The initial codebase exists as a sub-project of Jakarta-Commons, in the
httpclient subdirectory of the jakarta-commons cvs tree.

The proposed package name for the new sub-project is org.apache.httpclient.

(3) REQUIRED JAKARTA RESOURCES

* CVS Repository - New module, jakarta-httpclient in the CVS repository.

* Initial Committers - The list is provided below.  All of the proposed
committers are currently jakarta-commons committers.

* Mailing List - Two new mailing lists will be required:
httpclient-dev@jakarta.apache.org and httpclient-user@jakarta.apache.org
These will be used for developer discussions and user discussions
respectively.  CVS commit messages will be sent to the httpclient-dev list.

* Bugzilla - New product category "HttpClient", with appropriate version
identifiers as needed.  Existing bugs in the HttpClient component under the
Commons product category will need to be migrated.

(4) INITIAL COMMITTERS
The initial committers on the HttpClient component shall be:

* Michael Becke
* Jeff Dever
* dIon Gillard
* Ortwin Glück
* Oleg Kalnichevski
* Adrian Sutton

=======================================================================
Kangaroo Point MarchFest is an annual festival of music, art, food and
culture, that aims to build community spirit and bring all types of
people together for a time of fun and entertainment.
Sat March 20th, midday till 10pm, at Kangaroo Point Uniting Church.
http://www.soulpurpose.com.au/marchfest
=======================================================================


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


Re: [PROPOSAL][DRAFT] Promote HttpClient to Jakarta level

Posted by Michael Becke <be...@u.washington.edu>.
Yes, 1.3 doesn't bring us much.  I think we should stick with 1.2 until 
we are ready for 1.4.  As Oleg suggested, this probably won't happen 
for some time.

Mike

On Mar 18, 2004, at 7:51 AM, Roland Weber wrote:

> Hello Adrian,
>
> there is reflections stuff in:
>
> HttpConnection -> check for 1.3
> HttpException -> check for 1.4
> util/ExceptionUtil -> check for 1.4
>
> You're right, if getting rid of the reflections
> in HttpConnection is the only improvement,
> there is no point in requiring JDK 1.3.
>
> Does anyone else know about other parts of
> the code where you would have liked to use
> some 1.3 functionality? Improved collection
> classes or so?
>
> cheers,
>   Roland
>
>
>
>
>
>
> Adrian Sutton <ad...@intencha.com>
> 18.03.2004 13:27
> Please respond to "Commons HttpClient Project"
>
>         To:     Commons HttpClient Project
> <co...@jakarta.apache.org>
>         cc:
>         Subject:        Re: [PROPOSAL][DRAFT]  Promote HttpClient to
> Jakarta level
>
>
> On 18/3/04 10:24 PM, "Roland Weber" <RO...@de.ibm.com> wrote:
>
>>> (1.5) Interaction With Other Packages
>>>
>>> HttpClient relies on:
>>>
>>> * Java Development Kit (Version 1.2 or later; 1.3 or later 
>>> recommended)
>>
>> I wonder whether this would be the right time
>> to drop support for JDK 1.2 and require 1.3 ?
>
> I generally find the right time is when there's a good reason to.  Was
> there
> a 1.3 only method we wanted to use?  I know 1.4 has some cool stuff but
> we're not going to be getting to use that for quite some time yet.
>
>> cheers,
>> Roland
>
> Regards,
>
> Adrian Sutton.
>
> =======================================================================
> Kangaroo Point MarchFest is an annual festival of music, art, food and
> culture, that aims to build community spirit and bring all types of
> people together for a time of fun and entertainment.
> Sat March 20th, midday till 10pm, at Kangaroo Point Uniting Church.
> http://www.soulpurpose.com.au/marchfest
> =======================================================================
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail:
> commons-httpclient-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail:
> commons-httpclient-dev-help@jakarta.apache.org
>
>


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


Re: [PROPOSAL][DRAFT] Promote HttpClient to Jakarta level

Posted by Roland Weber <RO...@de.ibm.com>.
Hello Adrian,

there is reflections stuff in:

HttpConnection -> check for 1.3
HttpException -> check for 1.4
util/ExceptionUtil -> check for 1.4

You're right, if getting rid of the reflections
in HttpConnection is the only improvement,
there is no point in requiring JDK 1.3.

Does anyone else know about other parts of
the code where you would have liked to use
some 1.3 functionality? Improved collection
classes or so?

cheers,
  Roland






Adrian Sutton <ad...@intencha.com>
18.03.2004 13:27
Please respond to "Commons HttpClient Project"
 
        To:     Commons HttpClient Project 
<co...@jakarta.apache.org>
        cc: 
        Subject:        Re: [PROPOSAL][DRAFT]  Promote HttpClient to 
Jakarta level


On 18/3/04 10:24 PM, "Roland Weber" <RO...@de.ibm.com> wrote:

>> (1.5) Interaction With Other Packages
>> 
>> HttpClient relies on:
>> 
>> * Java Development Kit (Version 1.2 or later; 1.3 or later recommended)
> 
> I wonder whether this would be the right time
> to drop support for JDK 1.2 and require 1.3 ?

I generally find the right time is when there's a good reason to.  Was 
there
a 1.3 only method we wanted to use?  I know 1.4 has some cool stuff but
we're not going to be getting to use that for quite some time yet.

> cheers,
> Roland

Regards,

Adrian Sutton.

=======================================================================
Kangaroo Point MarchFest is an annual festival of music, art, food and
culture, that aims to build community spirit and bring all types of
people together for a time of fun and entertainment.
Sat March 20th, midday till 10pm, at Kangaroo Point Uniting Church.
http://www.soulpurpose.com.au/marchfest
=======================================================================


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



Re: [PROPOSAL][DRAFT] Promote HttpClient to Jakarta level

Posted by Adrian Sutton <ad...@intencha.com>.
On 18/3/04 10:24 PM, "Roland Weber" <RO...@de.ibm.com> wrote:

>> (1.5) Interaction With Other Packages
>> 
>> HttpClient relies on:
>> 
>> * Java Development Kit (Version 1.2 or later; 1.3 or later recommended)
> 
> I wonder whether this would be the right time
> to drop support for JDK 1.2 and require 1.3 ?

I generally find the right time is when there's a good reason to.  Was there
a 1.3 only method we wanted to use?  I know 1.4 has some cool stuff but
we're not going to be getting to use that for quite some time yet.

> cheers,
> Roland

Regards,

Adrian Sutton.

=======================================================================
Kangaroo Point MarchFest is an annual festival of music, art, food and
culture, that aims to build community spirit and bring all types of
people together for a time of fun and entertainment.
Sat March 20th, midday till 10pm, at Kangaroo Point Uniting Church.
http://www.soulpurpose.com.au/marchfest
=======================================================================


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


Re: [PROPOSAL][DRAFT] Promote HttpClient to Jakarta level

Posted by Roland Weber <RO...@de.ibm.com>.
> (1.5) Interaction With Other Packages
> 
> HttpClient relies on:
> 
> * Java Development Kit (Version 1.2 or later; 1.3 or later recommended)

I wonder whether this would be the right time
to drop support for JDK 1.2 and require 1.3 ?

cheers,
  Roland


Re: [PROPOSAL][DRAFT] Promote HttpClient to Jakarta level

Posted by Michael Becke <be...@u.washington.edu>.
The proposal looks good to me.  I think we are ready for a vote.

Mike

On Mar 23, 2004, at 11:25 PM, Adrian Sutton wrote:

> Hi all,
> Are there any further comments on this or are we ready to put it to a 
> vote?
>
> I have not had any response from any of the inactive committers and 
> figure a
> week is long enough to wait.  They can of course be reinstated as a
> committer at any time in the future by just requesting it (and sorting 
> out
> the CLA if need be).
>
> The proposal below is unchanged from the last draft with the only 
> suggested
> change being moving the dependency to Java 1.3 - the consensus seems 
> to be
> that there's no real cause for dropping Java 1.2 support at this stage.
>
> If there are no further suggestions I'll get a vote thread started in 
> the
> next couple of days.
>
> Regards,
>
> Adrian Sutton.
>
>> ----------------
>> (0) RATIONALE
>> HTTP is the main protocol used today on the internet.  Although the 
>> JDK
>> includes basic support for building HTTP-aware client applications, it
>> doesn't provide the flexibility or ease of use needed for many 
>> projects.
>>
>> The current package in Jakarta-Commons is a widely used 
>> implementation with
>> a strong community behind it.  The size of it's community and it's 
>> project
>> has significantly outgrown the commons project and a move to a 
>> Jakarta level
>> project would provide better support for that community and for the 
>> on going
>> development of HttpClient.
>>
>> (1) SCOPE
>> The project shall create and maintain a Java library implementing the 
>> client
>> side of the HTTP 1.0 and 1.1 protocol, as defined in RFC 1945, RFC 
>> 2616 and
>> RFC 2617.
>>
>> HttpClient also supports the following RFCs.
>>
>> * RFC 2109 for HTTP state management mechanism (Cookies) - an upgrade 
>> to RFC
>> 2965 is planned for a future version of HttpClient
>>
>> * RFC 2396 Uniform Resoruce Identifiers (URI): Generic Syntax
>>
>> * RFC 1867 Form-based File Upload in HTML
>>
>> The package should:
>>
>> * Have an API which should be as simple to use as possible
>> * Be as easy to extend as possible
>> * Provide unconditional support for HTTP/1.1
>>
>> The package is quite different from the HTTP client provided as part 
>> of the
>> JDK (java.net.HttpURLConnection), as it focuses on the HTTP methods 
>> being
>> sent (instead of making that transparent to the user), and generally 
>> allows
>> more interaction with the lower level connection.  The JDK client is 
>> also
>> not very intuitive to use.
>>
>> The package is used by a wide range of projects both within the ASF 
>> and from
>> third parties.  These include:
>>
>> * Jakarta Slide
>> * Jakarta Commons Latka
>> * Nortel Networks
>> * HtmlUnit
>> * Jakarta Cactus
>> * JSR 147
>> * NOSE Applied Intelligence ag
>> * MindIQ's Design-a-Course
>> * ContactOffice
>> * Newknow
>> * de4d2c
>> * Furies
>> * Term Highlighting for Verity Ultraseek search results
>> * Mule - Universal Message Objects
>> * many more.
>>
>> (1.5) Interaction With Other Packages
>>
>> HttpClient relies on:
>>
>> * Java Development Kit (Version 1.2 or later; 1.3 or later 
>> recommended)
>> * Jakarta commons-logging (Version 1.0 or later)
>> * Jakarta commons-codec (Version 1.2 or later)
>>
>> (2) INITIAL SOURCE OF THE PACKAGE
>>
>> The initial codebase exists as a sub-project of Jakarta-Commons, in 
>> the
>> httpclient subdirectory of the jakarta-commons cvs tree.
>>
>> The proposed package name for the new sub-project is 
>> org.apache.httpclient.
>>
>> (3) REQUIRED JAKARTA RESOURCES
>>
>> * CVS Repository - New module, jakarta-httpclient in the CVS 
>> repository.
>>
>> * Initial Committers - The list is provided below.  All of the 
>> proposed
>> committers are currently jakarta-commons committers.
>>
>> * Mailing List - Two new mailing lists will be required:
>> httpclient-dev@jakarta.apache.org and 
>> httpclient-user@jakarta.apache.org
>> These will be used for developer discussions and user discussions
>> respectively.  CVS commit messages will be sent to the httpclient-dev 
>> list.
>>
>> * Bugzilla - New product category "HttpClient", with appropriate 
>> version
>> identifiers as needed.  Existing bugs in the HttpClient component 
>> under the
>> Commons product category will need to be migrated.
>>
>> (4) INITIAL COMMITTERS
>> The initial committers on the HttpClient component shall be:
>>
>> * Michael Becke
>> * Jeff Dever
>> * dIon Gillard
>> * Ortwin Glück
>> * Oleg Kalnichevski
>> * Adrian Sutton
>
> ----------------------------------------------
> Intencha "tomorrow's technology today"
> Ph: 38478913 0422236329
> Suite 8/29 Oatland Crescent
> Holland Park West 4121
> Australia QLD
> www.intencha.com
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: 
> commons-httpclient-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: 
> commons-httpclient-dev-help@jakarta.apache.org
>


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


Re: [PROPOSAL][DRAFT] Promote HttpClient to Jakarta level

Posted by Adrian Sutton <ad...@intencha.com>.
Hi all,
Are there any further comments on this or are we ready to put it to a vote?

I have not had any response from any of the inactive committers and figure a
week is long enough to wait.  They can of course be reinstated as a
committer at any time in the future by just requesting it (and sorting out
the CLA if need be).

The proposal below is unchanged from the last draft with the only suggested
change being moving the dependency to Java 1.3 - the consensus seems to be
that there's no real cause for dropping Java 1.2 support at this stage.

If there are no further suggestions I'll get a vote thread started in the
next couple of days.

Regards,

Adrian Sutton.

> ----------------
> (0) RATIONALE
> HTTP is the main protocol used today on the internet.  Although the JDK
> includes basic support for building HTTP-aware client applications, it
> doesn't provide the flexibility or ease of use needed for many projects.
> 
> The current package in Jakarta-Commons is a widely used implementation with
> a strong community behind it.  The size of it's community and it's project
> has significantly outgrown the commons project and a move to a Jakarta level
> project would provide better support for that community and for the on going
> development of HttpClient.
> 
> (1) SCOPE
> The project shall create and maintain a Java library implementing the client
> side of the HTTP 1.0 and 1.1 protocol, as defined in RFC 1945, RFC 2616 and
> RFC 2617.
> 
> HttpClient also supports the following RFCs.
> 
> * RFC 2109 for HTTP state management mechanism (Cookies) - an upgrade to RFC
> 2965 is planned for a future version of HttpClient
> 
> * RFC 2396 Uniform Resoruce Identifiers (URI): Generic Syntax
> 
> * RFC 1867 Form-based File Upload in HTML
> 
> The package should:
> 
> * Have an API which should be as simple to use as possible
> * Be as easy to extend as possible
> * Provide unconditional support for HTTP/1.1
> 
> The package is quite different from the HTTP client provided as part of the
> JDK (java.net.HttpURLConnection), as it focuses on the HTTP methods being
> sent (instead of making that transparent to the user), and generally allows
> more interaction with the lower level connection.  The JDK client is also
> not very intuitive to use.
> 
> The package is used by a wide range of projects both within the ASF and from
> third parties.  These include:
> 
> * Jakarta Slide
> * Jakarta Commons Latka
> * Nortel Networks
> * HtmlUnit
> * Jakarta Cactus
> * JSR 147
> * NOSE Applied Intelligence ag
> * MindIQ's Design-a-Course
> * ContactOffice
> * Newknow
> * de4d2c
> * Furies
> * Term Highlighting for Verity Ultraseek search results
> * Mule - Universal Message Objects
> * many more.
> 
> (1.5) Interaction With Other Packages
> 
> HttpClient relies on:
> 
> * Java Development Kit (Version 1.2 or later; 1.3 or later recommended)
> * Jakarta commons-logging (Version 1.0 or later)
> * Jakarta commons-codec (Version 1.2 or later)
> 
> (2) INITIAL SOURCE OF THE PACKAGE
> 
> The initial codebase exists as a sub-project of Jakarta-Commons, in the
> httpclient subdirectory of the jakarta-commons cvs tree.
> 
> The proposed package name for the new sub-project is org.apache.httpclient.
> 
> (3) REQUIRED JAKARTA RESOURCES
> 
> * CVS Repository - New module, jakarta-httpclient in the CVS repository.
> 
> * Initial Committers - The list is provided below.  All of the proposed
> committers are currently jakarta-commons committers.
> 
> * Mailing List - Two new mailing lists will be required:
> httpclient-dev@jakarta.apache.org and httpclient-user@jakarta.apache.org
> These will be used for developer discussions and user discussions
> respectively.  CVS commit messages will be sent to the httpclient-dev list.
> 
> * Bugzilla - New product category "HttpClient", with appropriate version
> identifiers as needed.  Existing bugs in the HttpClient component under the
> Commons product category will need to be migrated.
> 
> (4) INITIAL COMMITTERS
> The initial committers on the HttpClient component shall be:
> 
> * Michael Becke
> * Jeff Dever
> * dIon Gillard
> * Ortwin Glück
> * Oleg Kalnichevski
> * Adrian Sutton

----------------------------------------------
Intencha "tomorrow's technology today"
Ph: 38478913 0422236329
Suite 8/29 Oatland Crescent
Holland Park West 4121
Australia QLD
www.intencha.com


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