Return-Path: X-Original-To: apmail-hc-commits-archive@www.apache.org Delivered-To: apmail-hc-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 4CF0417802 for ; Thu, 16 Oct 2014 19:38:42 +0000 (UTC) Received: (qmail 53454 invoked by uid 500); 16 Oct 2014 19:38:42 -0000 Delivered-To: apmail-hc-commits-archive@hc.apache.org Received: (qmail 53414 invoked by uid 500); 16 Oct 2014 19:38:42 -0000 Mailing-List: contact commits-help@hc.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "HttpComponents Project" Delivered-To: mailing list commits@hc.apache.org Received: (qmail 53405 invoked by uid 99); 16 Oct 2014 19:38:42 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 16 Oct 2014 19:38:42 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 16 Oct 2014 19:38:37 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 4263F23888FE for ; Thu, 16 Oct 2014 19:38:17 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1632422 [1/2] - in /httpcomponents/site: ./ httpcomponents-asyncclient-4.1.x/ Date: Thu, 16 Oct 2014 19:38:16 -0000 To: commits@hc.apache.org From: olegk@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20141016193817.4263F23888FE@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: olegk Date: Thu Oct 16 19:38:15 2014 New Revision: 1632422 URL: http://svn.apache.org/r1632422 Log: Updated project website for HttpAsyncClient 4.1-beta1 release Added: httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html (with props) httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html (with props) httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html (with props) httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html (with props) Modified: httpcomponents/site/charter.html httpcomponents/site/dev-docs.html httpcomponents/site/downloads.html httpcomponents/site/get-involved.html httpcomponents/site/index.html httpcomponents/site/issue-tracking.html httpcomponents/site/license.html httpcomponents/site/mail-lists.html httpcomponents/site/mail.html httpcomponents/site/news.html httpcomponents/site/poweredby.html httpcomponents/site/project-info.html httpcomponents/site/status.html httpcomponents/site/team-list.html Modified: httpcomponents/site/charter.html URL: http://svn.apache.org/viewvc/httpcomponents/site/charter.html?rev=1632422&r1=1632421&r2=1632422&view=diff ============================================================================== --- httpcomponents/site/charter.html (original) +++ httpcomponents/site/charter.html Thu Oct 16 19:38:15 2014 @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ @import url("./css/site.css"); - + @@ -31,7 +31,7 @@
- Last Published: 2014-09-27 + Last Published: 2014-10-16  | Version: 1-SNAPSHOT
Apache @@ -102,6 +102,9 @@ HttpCore 4.3 + Modified: httpcomponents/site/dev-docs.html URL: http://svn.apache.org/viewvc/httpcomponents/site/dev-docs.html?rev=1632422&r1=1632421&r2=1632422&view=diff ============================================================================== --- httpcomponents/site/dev-docs.html (original) +++ httpcomponents/site/dev-docs.html Thu Oct 16 19:38:15 2014 @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ @import url("./css/site.css"); - + @@ -31,7 +31,7 @@
- Last Published: 2014-09-27 + Last Published: 2014-10-16  | Version: 1-SNAPSHOT
Apache @@ -102,6 +102,9 @@ HttpCore 4.3 + Modified: httpcomponents/site/downloads.html URL: http://svn.apache.org/viewvc/httpcomponents/site/downloads.html?rev=1632422&r1=1632421&r2=1632422&view=diff ============================================================================== --- httpcomponents/site/downloads.html (original) +++ httpcomponents/site/downloads.html Thu Oct 16 19:38:15 2014 @@ -1,5 +1,5 @@ - + @@ -12,7 +12,7 @@ @import url("./css/site.css"); - + @@ -32,7 +32,7 @@
- Last Published: 2014-09-27 + Last Published: 2014-10-16  | Version: 1-SNAPSHOT
Apache @@ -103,6 +103,9 @@ HttpCore 4.3 + @@ -517,6 +520,48 @@
+

HttpAsyncClient 4.1-beta1

+ KEYS + Release Notes +
+ +

Binary

+ + + +

Source

+ + +
+ + +

Older releases

Modified: httpcomponents/site/get-involved.html URL: http://svn.apache.org/viewvc/httpcomponents/site/get-involved.html?rev=1632422&r1=1632421&r2=1632422&view=diff ============================================================================== --- httpcomponents/site/get-involved.html (original) +++ httpcomponents/site/get-involved.html Thu Oct 16 19:38:15 2014 @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ @import url("./css/site.css"); - + @@ -31,7 +31,7 @@

- Last Published: 2014-09-27 + Last Published: 2014-10-16  | Version: 1-SNAPSHOT
Apache @@ -102,6 +102,9 @@ HttpCore 4.3 + Added: httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html?rev=1632422&view=auto ============================================================================== --- httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html (added) +++ httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html Thu Oct 16 19:38:15 2014 @@ -0,0 +1,219 @@ + + + + + + + Apache HttpComponents - HttpComponents HttpAsyncClient Download Page + + + + + + + + + +
+ +
+
+
+
+

HttpAsyncClient Downloads

+

The latest release available for download:

+

Release packages - Release Notes - License

+
+

Dependency management

+

If you are using a dependency manager for your project such as Apache Maven or Apache Ivy, you can create a dependency on HttpClient modules by using this information:

+

HttpAsyncClient

+

HttpAsyncClient Cache

+
+
+
+
+
+ + + Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html ------------------------------------------------------------------------------ svn:keywords = Date Revision Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/download.html ------------------------------------------------------------------------------ svn:mime-type = text/html Added: httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html?rev=1632422&view=auto ============================================================================== --- httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html (added) +++ httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html Thu Oct 16 19:38:15 2014 @@ -0,0 +1,239 @@ + + + + + + + Apache HttpComponents - HttpComponents HttpAsyncClient Examples + + + + + + + + + +
+ +
+
+
+
+

HttpAsyncClient Examples

+
    +
  • Asynchronous HTTP exchange +

    This example demonstrates a basic asynchronous HTTP request / response exchange. Response content is buffered in memory for simplicity.

    • +
  • Asynchronous HTTP exchange with content streaming +

    This example demonstrates an asynchronous HTTP request / response exchange with a full content streaming.

    • +
  • Concurrent asynchronous HTTP exchanges +

    This example demonstrates a fully asynchronous execution of multiple HTTP exchanges where the result of an individual operation is reported using a callback interface.

    • +
  • Pipelined HTTP exchanges +

    This example demonstrates a pipelined execution of multiple HTTP request / response exchanges. Response content is buffered in memory for simplicity.

    • +
  • Pipelined HTTP exchanges with content streaming +

    This example demonstrates a pipelined execution of multiple HTTP request / response exchanges with a full content streaming.

    • +
  • Asynchronous request via a proxy +

    This example demonstrates how to send an HTTP request via a proxy.

    • +
  • HttpAsyncClient configuration +

    This example demonstrates how to customize and configure the most common aspects of HTTP request execution and connection management.

    • +
  • Custom execution context +

    This example demonstrates the use of a local execution context with custom context settings.

    • +
  • Client authentication +

    This example demonstrates execution of an HTTP request against a target site that requires user authentication.

    • +
  • Proxy authentication +

    This example shows execution of an HTTP request over a secure connection tunneled through an authenticating proxy.

    • +
  • Custom SSL context +

    This example demonstrates how to create secure connections with a custom SSL context.

    • +
  • Zero copy file upload / download +

    This example demonstrates how HttpAsyncClient can be used to upload or download files without creating an intermediate content buffer in memory (zero copy file transfer).

    • +
  • Connection eviction +

    This example demonstrates how to evict expired and idle connections from the connection pool.

+
+
+
+
+
+ + + Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html ------------------------------------------------------------------------------ svn:keywords = Date Revision Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/examples.html ------------------------------------------------------------------------------ svn:mime-type = text/html Added: httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html?rev=1632422&view=auto ============================================================================== --- httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html (added) +++ httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html Thu Oct 16 19:38:15 2014 @@ -0,0 +1,252 @@ + + + + + + + Apache HttpComponents - HttpComponents HttpAsyncClient Overview + + + + + + + + + +
+ +
+
+
+
+

HttpAsyncClient Overview

+

The Hyper-Text Transfer Protocol (HTTP) is perhaps the most significant protocol used on the Internet today. Web services, network-enabled appliances and the growth of network computing 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. HttpAsyncClient seeks to fill this void by providing an efficient, up-to-date, and feature-rich package implementing the client side of the most recent HTTP standards and recommendations.

+

Designed for extension while providing robust support for the base HTTP protocol, HttpAsyncClient may be of interest to anyone building HTTP-aware client applications based on asynchronous, event driven I/O model.

+
+

Documentation

+
    +
  1. Quick Start - contains a simple, complete example of asynchronous request execution.
    2. +
  2. HttpAsyncClient Examples - a set of examples demonstrating some of the more complex behavior.
    3. +
  3. Project reports +
+
+

Features

+
    +
  • Standards based, pure Java, implementation of HTTP versions 1.0 and 1.1
    • +
  • Full implementation of all HTTP methods (GET, POST, PUT, DELETE, HEAD, OPTIONS, and TRACE) in an extensible OO framework.
    • +
  • Supports encryption with HTTPS (HTTP over SSL) protocol.
    • +
  • Transparent connections through HTTP proxies.
    • +
  • Tunneled HTTPS connections through HTTP proxies, via the CONNECT method.
    • +
  • Connection management support concurrent request execution. Supports setting the maximum total connections as well as the maximum connections per host. Detects and closes expired connections.
    • +
  • Persistent connections using KeepAlive in HTTP/1.0 and persistance in HTTP/1.1
    • +
  • The ability to set connection timeouts.
    • +
  • Source code is freely available under the Apache License.
    • +
  • Basic, Digest, NTLMv1, NTLMv2, NTLM2 Session, SNPNEGO and Kerberos authentication schemes.
    • +
  • Plug-in mechanism for custom authentication schemes.
    • +
  • Automatic Cookie handling for reading Set-Cookie: headers from the server and sending them back out in a Cookie: header when appropriate.
    • +
  • Plug-in mechanism for custom cookie policies.
    • +
  • Support for HTTP/1.1 response caching.
    • +
  • Support for pipelined request execution and processing.
+
+

Standards Compliance

+

HttpAsyncClient strives to conform to the following specifications endorsed by the Internet Engineering Task Force (IETF) and the internet at large:

+
    +
  • RFC 1945 Hypertext Transfer Protocol -- HTTP/1.0
    • +
  • RFC 2616 Hypertext Transfer Protocol -- HTTP/1.1
    • +
  • RFC 2617 HTTP Authentication: Basic and Digest Access Authentication
    • +
  • RFC 2109 HTTP State Management Mechanism (Cookies)
    • +
  • RFC 2965 HTTP State Management Mechanism (Cookies v2)
+
+
+
+
+
+ + + Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html ------------------------------------------------------------------------------ svn:keywords = Date Revision Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/index.html ------------------------------------------------------------------------------ svn:mime-type = text/html Added: httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html URL: http://svn.apache.org/viewvc/httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html?rev=1632422&view=auto ============================================================================== --- httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html (added) +++ httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html Thu Oct 16 19:38:15 2014 @@ -0,0 +1,306 @@ + + + + + + + Apache HttpComponents - HttpAsyncClient Quick Start + + + + + + + + + +
+ +
+
+
+
+

HttpAsyncClient Quick Start

+
    +
  1. Download 'Binary' package of the latest HttpAsyncClient 4.1 release or configure dependency on HttpAsyncClient module using a dependency manager of your choice as described here.
    2. +
  2. HttpAsyncClient 4.1 requires Java 1.6 or newer.
    3. +
  3. The code fragment below illustrates the most fundamental aspects of asynchronous request execution with HttpAsyncClient. +
    +
    CloseableHttpAsyncClient httpclient = HttpAsyncClients.createDefault();
+try {
+    // Start the client
+    httpclient.start();
+
+    // Execute request
+    final HttpGet request1 = new HttpGet("http://www.apache.org/");
+    Future<HttpResponse> future = httpclient.execute(request1, null);
+    // and wait until a response is received
+    HttpResponse response1 = future.get();
+    System.out.println(request1.getRequestLine() + "->" + response1.getStatusLine());
+
+    // One most likely would want to use a callback for operation result
+    final CountDownLatch latch1 = new CountDownLatch(1);
+    final HttpGet request2 = new HttpGet("http://www.apache.org/");
+    httpclient.execute(request2, new FutureCallback<HttpResponse>() {
+
+        public void completed(final HttpResponse response2) {
+            latch1.countDown();
+            System.out.println(request2.getRequestLine() + "->" + response2.getStatusLine());
+        }
+
+        public void failed(final Exception ex) {
+            latch1.countDown();
+            System.out.println(request2.getRequestLine() + "->" + ex);
+        }
+
+        public void cancelled() {
+            latch1.countDown();
+            System.out.println(request2.getRequestLine() + " cancelled");
+        }
+
+    });
+    latch1.await();
+
+    // In real world one most likely would also want to stream
+    // request and response body content
+    final CountDownLatch latch2 = new CountDownLatch(1);
+    final HttpGet request3 = new HttpGet("http://www.apache.org/");
+    HttpAsyncRequestProducer producer3 = HttpAsyncMethods.create(request3);
+    AsyncCharConsumer<HttpResponse> consumer3 = new AsyncCharConsumer<HttpResponse>() {
+
+        HttpResponse response;
+
+        @Override
+        protected void onResponseReceived(final HttpResponse response) {
+            this.response = response;
+        }
+
+        @Override
+        protected void onCharReceived(final CharBuffer buf, final IOControl ioctrl) throws IOException {
+            // Do something useful
+        }
+
+        @Override
+        protected void releaseResources() {
+        }
+
+        @Override
+        protected HttpResponse buildResult(final HttpContext context) {
+            return this.response;
+        }
+
+    };
+    httpclient.execute(producer3, consumer3, new FutureCallback<HttpResponse>() {
+
+        public void completed(final HttpResponse response3) {
+            latch2.countDown();
+            System.out.println(request2.getRequestLine() + "->" + response3.getStatusLine());
+        }
+
+        public void failed(final Exception ex) {
+            latch2.countDown();
+            System.out.println(request2.getRequestLine() + "->" + ex);
+        }
+
+        public void cancelled() {
+            latch2.countDown();
+            System.out.println(request2.getRequestLine() + " cancelled");
+        }
+
+    });
+    latch2.await();
+
+} finally {
+    httpclient.close();
+}
    4. +
  4. Take a look at the HttpCore tutorial for introduction to fundamentals of asynchronous HTTP communication with HttpComponents.
    5. +
  5. Another good way of getting started with HttpAsyncClient is by seeing it in action. Take a look at the samples shipped with the release package or available online.
+
+
+
+
+
+ + + Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html ------------------------------------------------------------------------------ svn:keywords = Date Revision Propchange: httpcomponents/site/httpcomponents-asyncclient-4.1.x/quickstart.html ------------------------------------------------------------------------------ svn:mime-type = text/html Modified: httpcomponents/site/index.html URL: http://svn.apache.org/viewvc/httpcomponents/site/index.html?rev=1632422&r1=1632421&r2=1632422&view=diff ============================================================================== --- httpcomponents/site/index.html (original) +++ httpcomponents/site/index.html Thu Oct 16 19:38:15 2014 @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ @import url("./css/site.css"); - + @@ -31,7 +31,7 @@
- Last Published: 2014-09-27 + Last Published: 2014-10-16  | Version: 1-SNAPSHOT
Apache @@ -102,6 +102,9 @@ HttpCore 4.3 + Modified: httpcomponents/site/issue-tracking.html URL: http://svn.apache.org/viewvc/httpcomponents/site/issue-tracking.html?rev=1632422&r1=1632421&r2=1632422&view=diff ============================================================================== --- httpcomponents/site/issue-tracking.html (original) +++ httpcomponents/site/issue-tracking.html Thu Oct 16 19:38:15 2014 @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ @import url("./css/site.css"); - + @@ -31,7 +31,7 @@
- Last Published: 2014-09-27 + Last Published: 2014-10-16  | Version: 1-SNAPSHOT
Apache @@ -102,6 +102,9 @@ HttpCore 4.3 + Modified: httpcomponents/site/license.html URL: http://svn.apache.org/viewvc/httpcomponents/site/license.html?rev=1632422&r1=1632421&r2=1632422&view=diff ============================================================================== --- httpcomponents/site/license.html (original) +++ httpcomponents/site/license.html Thu Oct 16 19:38:15 2014 @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ @import url("./css/site.css"); - + @@ -31,7 +31,7 @@
- Last Published: 2014-09-27 + Last Published: 2014-10-16  | Version: 1-SNAPSHOT
Apache @@ -102,6 +102,9 @@ HttpCore 4.3 + Modified: httpcomponents/site/mail-lists.html URL: http://svn.apache.org/viewvc/httpcomponents/site/mail-lists.html?rev=1632422&r1=1632421&r2=1632422&view=diff ============================================================================== --- httpcomponents/site/mail-lists.html (original) +++ httpcomponents/site/mail-lists.html Thu Oct 16 19:38:15 2014 @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ @import url("./css/site.css"); - + @@ -31,7 +31,7 @@
- Last Published: 2014-09-27 + Last Published: 2014-10-16  | Version: 1-SNAPSHOT
Apache @@ -102,6 +102,9 @@ HttpCore 4.3 +