hc-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ol...@apache.org
Subject svn commit: r557633 - in /jakarta/httpcomponents/project/src/site: apt/http-auth.apt apt/http-client.apt apt/http-conn.apt apt/http-cookie.apt apt/index.apt apt/news.apt apt/status.apt site.xml
Date Thu, 19 Jul 2007 14:15:27 GMT
Author: olegk
Date: Thu Jul 19 07:15:25 2007
New Revision: 557633

URL: http://svn.apache.org/viewvc?view=rev&rev=557633
Log:
Updated front page, news and status pages for HttpComponents HttpClient 4.0-alpha1 release

Removed:
    jakarta/httpcomponents/project/src/site/apt/http-auth.apt
    jakarta/httpcomponents/project/src/site/apt/http-client.apt
    jakarta/httpcomponents/project/src/site/apt/http-conn.apt
    jakarta/httpcomponents/project/src/site/apt/http-cookie.apt
Modified:
    jakarta/httpcomponents/project/src/site/apt/index.apt
    jakarta/httpcomponents/project/src/site/apt/news.apt
    jakarta/httpcomponents/project/src/site/apt/status.apt
    jakarta/httpcomponents/project/src/site/site.xml

Modified: jakarta/httpcomponents/project/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/project/src/site/apt/index.apt?view=diff&rev=557633&r1=557632&r2=557633
==============================================================================
--- jakarta/httpcomponents/project/src/site/apt/index.apt (original)
+++ jakarta/httpcomponents/project/src/site/apt/index.apt Thu Jul 19 07:15:25 2007
@@ -11,41 +11,11 @@
     continue to expand the role of the HTTP protocol beyond user-driven web browsers, while

     increasing the number of applications that require HTTP support.
 
-    Although the java.net package provides basic functionality for accessing resources via
HTTP, 
-    it doesn't provide the full flexibility or functionality needed by many applications.
The 
-    Jakarta HttpComponents seek to fill this void by providing an efficient, up-to-date,
and 
-    feature-rich set of components that can be used to assemble custom, standards compliant

-    client- and server-side HTTP services.
-
     Designed for extension while providing robust support for the base HTTP protocol, the

     HttpComponents may be of interest to anyone building HTTP-aware client and server 
     applications such as web browsers, web spiders, HTTP proxies, web service transport 
     libraries, or systems that leverage or extend the HTTP protocol for distributed communication.

     
-Standards Compliance
-
-    HttpComponents strives to conform to the following specifications endorsed by the Internet

-    Engineering Task Force (IETF) and the internet at large:
-
-    * {{{http://www.ietf.org/rfc/rfc1945.txt}RFC 1945}} - Hypertext Transfer Protocol --
HTTP/1.0
-
-    * {{{http://www.ietf.org/rfc/rfc2616.txt}RFC 2116}} - Hypertext Transfer Protocol --
HTTP/1.1
-
-    * {{{http://www.ietf.org/rfc/rfc2617.txt}RFC 2117}} - HTTP Authentication: Basic and
Digest 
-    Access Authentication
-
-    * {{{http://wp.netscape.com/newsref/std/cookie_spec.html}Netscape Cookie Draft}} - Persistent

-    Client State (HTTP cookies, preliminary specification)
-
-    * {{{http://www.ietf.org/rfc/rfc2109.txt}RFC 2109}} - HTTP State Management Mechanism

-    (HTTP cookies, version 1)
-
-    * {{{http://www.ietf.org/rfc/rfc2965.txt}RFC 2965}} - HTTP State Management Mechanism

-    (HTTP Cookies, version 1, second revision)
-
-    * {{{http://www.robotstxt.org/wc/norobots-rfc.html}norobots-rfc}} - A standard for robot

-    exclusion 
-
 Commons HttpClient
 
     The Jakarta HttpComponents project is charged with developing and maintaining 
@@ -62,56 +32,53 @@
 
 * HttpCore
 
-    The {{{httpcomponents-core/index.html}HttpCore}} components implement the most fundamental
aspects 
-    of the HTTP protocol. They are nonetheless sufficient to develop basic client-side and
server-side 
-    HTTP services with a minimal footprint and no external dependencies.
+    The {{{httpcomponents-core/index.html}HttpCore}} components implement the most fundamental

+    aspects of the HTTP protocol. They are nonetheless sufficient to develop basic client-side
and 
+    server-side HTTP services with a minimal footprint and no external dependencies.
 
     HttpCore consists of several modules
 
- ** HttpCore base module
+    <<HttpCore base module>>
 
     This module contains the HttpCore public API and the default implementation based on
the Java 
     classic (blocking) I/O model. It requires a Java 1.3 compatible runtime and has no dependency

     on any external libraries.
 
- ** HttpCore NIO extensions
+    <<HttpCore NIO extensions>>
 
     HttpCore NIO extensions contain optional components that leverage the event driven, non-blocking

     I/O (NIO) model. HttpCore NIO extensions require a Java 1.4 compatible runtime and the
HttpCore 
     base module.
 
-    The NIO model proved inferior to the classic I/O model in terms of raw performance when
the number of 
-    simultaneous HTTP connections is moderate (several hundreds) or when the content is meant
to be 
-    produced/consumed using standard java.io.OutputStream/java.io.InputStream interfaces
such as the
-    Servlet API. HttpCore NIO extensions are intended for those usage scenarios where raw
throughput 
-    is less important than the ability to handle thousands of simultaneous HTTP connections
in a resource 
+    HttpCore NIO extensions are intended for those usage scenarios where raw throughput is
less 
+    important than the ability to handle thousands of simultaneous HTTP connections in a
resource 
     efficient manner.
 
- ** HttpCore NIOSSL extensions
+    <<HttpCore NIOSSL extensions>>
 
     HttpCore NIOSSL extensions contain optional components enabling HttpCore NIO to transparently

     encrypt data in transit using SSL/TLS protocol.
 
-* HttpAuth (planned)
-
-    HttpAuth will provide an abstract API and pluggable implementations of standard authentication

-    schemes such as Basic, Digest and Kerberos (SPNEGO)
-
-* HttpCookie (planned)
+* HttpClient
 
-    HttpCookie will provide an abstract API and pluggable implementations of standard cookie
policies 
-    such as those based on RFC 2109 and RFC 2965 specifications as well as cookie policies
compatible 
-    with Netscate Cookie draft and common practices of popular web browsers
+    {{{httpcomponents-client/index.html}HttpClient}} developed by the HttpComponents project
serves 
+    as an easy to use facade to the lower level components of HttpCore, HttpAuth, HttpCookie,
and 
+    HttpConn. It is intended as successor of and replacement for 
+    {{{http://jakarta.apache.org/commons/httpclient/index.html}Jakarta Commons HttpClient
3.x}}
 
-* HttpConn (planned)
+    <<HttpConn (presently included in HttpClient)>>
 
     HttpConn will provide an API and a number of default implementations of components for
efficient 
     management of HTTP connections
 
-* HttpClient
+    <<HttpCookie (presently included in HttpClient)>>
 
-    Jakarta HttpClient developed by the HttpComponents project will serve as an easy to use
facade to the 
-    lower level components of HttpCore, HttpAuth, HttpCookie, and HttpConn. It is intended
as successor of
-    and replacement for 
-    {{{http://jakarta.apache.org/commons/httpclient/index.html}Jakarta Commons HttpClient
3.x}}
+    HttpCookie will provide an abstract API and pluggable implementations of standard cookie

+    policies such as those based on RFC 2109 and RFC 2965 specifications as well as cookie
policies 
+    compatible with Netscate Cookie draft and common practices of popular web browsers
+
+    <<HttpAuth (presently included in HttpClient)>>
+
+    HttpAuth will provide an abstract API and pluggable implementations of standard authentication

+    schemes such as Basic, Digest and Kerberos (SPNEGO)
 

Modified: jakarta/httpcomponents/project/src/site/apt/news.apt
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/project/src/site/apt/news.apt?view=diff&rev=557633&r1=557632&r2=557633
==============================================================================
--- jakarta/httpcomponents/project/src/site/apt/news.apt (original)
+++ jakarta/httpcomponents/project/src/site/apt/news.apt Thu Jul 19 07:15:25 2007
@@ -6,6 +6,40 @@
 
 HttpComponents Project News 
 
+* 20 July 2007 - HttpComponents HttpClient 4.0-alpha1 released 
+
+    This release represents a complete, ground-up redesign and almost a complete rewrite
of the old 
+    HttpClient 3.x codeline. This release finally addresses several design flaws that existed
since 
+    the 1.0 release and could not be fixed without a major code overhaul and breaking API

+    compatibility. 
+
+    Notable changes and enhancements: 
+
+    * Redesign of the HttpClient internals addressing all known major architectural shortcomings
of 
+    the 3.x codeline  
+
+    * Cleaner, more flexible and expressive API   
+
+    * Better performance and smaller memory footprint due to a more efficient HTTP transport
based 
+    on HttpCore. HttpClient 4.0 is expected to be 10% to 25% faster than HttpClient 3.x codeline
+
+    * More modular structure   
+
+    * Pluggable redirect and authentication handlers   
+
+    * Support for protocol incerceptors
+
+    * Improved connection management 
+
+    * Improved support for sending requests via a proxy or a chain of proxies 
+
+    * Improved handling redirects of entity enclosing requests
+
+    * More flexible SSL context customization 
+
+    * Reduced intermediate garbage in the process of generating HTTP requests and parsing
HTTP 
+    responses  
+
 * 4 July 2007 - HttpComponents HttpCore 4.0-alpha5 released 
 
    The fifth ALPHA version of HttpComponents Core has been released. This release delivers
a number 

Modified: jakarta/httpcomponents/project/src/site/apt/status.apt
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/project/src/site/apt/status.apt?view=diff&rev=557633&r1=557632&r2=557633
==============================================================================
--- jakarta/httpcomponents/project/src/site/apt/status.apt (original)
+++ jakarta/httpcomponents/project/src/site/apt/status.apt Thu Jul 19 07:15:25 2007
@@ -22,22 +22,27 @@
 
 * HttpComponents HttpCore 4.0
 
-    The major part of the redesign of the core HTTP component has been completed. The new
API is 
-    ready for review and use in experimental projects. HttpCore is expected to enter the
BETA 
-    development phase with the next release. As of release 4.0-BETA1 API compatibility will

-    be maintained.
+    HttpCore 4.0 is almost fully feature-complete by now and is nearing the API freeze milestone.

+    It is expected to enter the BETA development phase with the next release. As of release

+    4.0-BETA1 backward API compatibility will be maintained.
 
-    The HttpCore component will form the foundation of the future releases of Apache HttpClient
and 
-    can also be used separately to build custom client- and server-side HTTP services.
+    The HttpCore forms the foundation of HttpClient 4.0 and can also be used separately to
build 
+    custom client- and server-side HTTP services.
+
+    The complete list of bugs and new improvements targeted for the next release can be found

+    {{{https://issues.apache.org/jira/secure/IssueNavigator.jspa?mode=hide&requestId=12311930}here}}
 
 * HttpComponents HttpClient 4.0
 
-    The cookie management API is currently being redesigned in the SVN trunk. The decision
whether cookie 
-    management, authentication and connection management components should be released and
versioned 
-    independently from HttpClient is still pending. Please let us know what you think about
it.  
+    The major part of the Httpclient redesign is now complete. The first ALPHA release fixed
all
+    known architectural deficiencies and problems. HttpClient now sports a cleaner, more
flexible 
+    and expressive API, a more modular structure, improved performance and reduced memory
footprint.
+
+    The new API will be further improved and revised in the course of the ALPHA development
phase. 
+    HttpClient 4.0 is still considered experimental and should be used with caution.
 
-    The complete list of bugs and new improvements targeted for the 4.0 release can be found

-    {{{http://issues.apache.org/jira/secure/IssueNavigator.jspa?mode=hide&requestId=12311033}here}}
+    The complete list of bugs and new improvements targeted for the next release can be found

+    {{{https://issues.apache.org/jira/secure/IssueNavigator.jspa?mode=hide&requestId=12311033}here}}
 
 
 

Modified: jakarta/httpcomponents/project/src/site/site.xml
URL: http://svn.apache.org/viewvc/jakarta/httpcomponents/project/src/site/site.xml?view=diff&rev=557633&r1=557632&r2=557633
==============================================================================
--- jakarta/httpcomponents/project/src/site/site.xml (original)
+++ jakarta/httpcomponents/project/src/site/site.xml Thu Jul 19 07:15:25 2007
@@ -58,10 +58,7 @@
     </menu>
     <menu name="Modules">
       <item name="HttpCore" href="httpcomponents-core/index.html"/>
-      <item name="HttpAuth" href="http-auth.html"/>
-      <item name="HttpCookie" href="http-cookie.html"/>
-      <item name="HttpConn" href="http-conn.html"/>
-      <item name="HttpClient" href="http-client.html"/>
+      <item name="HttpClient" href="httpcomponents-client/index.html"/>
     </menu>
     ${reports}
 



Mime
View raw message