You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hc.apache.org by ol...@apache.org on 2017/05/27 11:21:23 UTC
[30/50] [abbrv] httpcomponents-website git commit: Updated project
website for HttpCore 5.0-alpha1 release
http://git-wip-us.apache.org/repos/asf/httpcomponents-website/blob/9eb81367/src/site/apt/httpcomponents-core-5.0.x/examples.apt
----------------------------------------------------------------------
diff --git a/src/site/apt/httpcomponents-core-5.0.x/examples.apt b/src/site/apt/httpcomponents-core-5.0.x/examples.apt
new file mode 100644
index 0000000..f0f2663
--- /dev/null
+++ b/src/site/apt/httpcomponents-core-5.0.x/examples.apt
@@ -0,0 +1,82 @@
+~~ ====================================================================
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+~~ ====================================================================
+~~
+~~ This software consists of voluntary contributions made by many
+~~ individuals on behalf of the Apache Software Foundation. For more
+~~ information on the Apache Software Foundation, please see
+~~ <http://www.apache.org/>.
+
+ ----------
+ HttpComponents HttpCore Examples
+ ----------
+ ----------
+ ----------
+
+HttpCore Examples
+
+ * {{{./httpcore/examples/org/apache/hc/core5/http/examples/ElementalHttpGet.java}
+ Synchronous HTTP GET requests}}
+
+ This example demonstrates how to execute a series of synchronous (blocking) HTTP GET requests.
+
+ * {{{./httpcore/examples/org/apache/hc/core5/http/examples/ElementalHttpPost.java}
+ Synchronous HTTP POST requests}}
+
+ This example demonstrates how to execute a series of synchronous (blocking) HTTP POST requests
+ that enclose entity content of various types: a string, a byte array, an arbitrary input stream.
+
+ * {{{./httpcore/examples/org/apache/hc/core5/http/examples/ElementalPoolingHttpGet.java}
+ Synchronous HTTP GET requests with connection pooling}}
+
+ This example demonstrates how to execute a series of synchronous (blocking) HTTP GET requests
+ using a pool of perssitent connections.
+
+ * {{{./httpcore/examples/org/apache/hc/core5/http/examples/HttpFileServer.java}
+ Synchronous HTTP file server}}
+
+ This is an example of an HTTP/1.1 file server based on a synchronous (blocking) I/O model.
+
+ * {{{./httpcore/examples/org/apache/hc/core5/http/examples/ElementalReverseProxy.java}
+ Synchronous HTTP reverse proxy}}
+
+ This is an example of an HTTP/1.1 reverse proxy based on a synchronous (blocking) I/O model.
+
+ * {{{./httpcore/examples/org/apache/hc/core5/http/examples/NHttpClient.java}
+ Asynchronous HTTP GET requests}}
+
+ This example demonstrates how HttpCore can be used to execute multiple HTTP requests
+ asynchronously.
+
+ * {{{./httpcore/examples/org/apache/hc/core5/http/examples/PipeliningHttpClient.java}
+ Pipelined HTTP GET requests}}
+
+ This example demonstrates how HttpCore can be used to execute series of pipelined HTTP requests.
+
+ * {{{./httpcore/examples/org/apache/hc/core5/http/examples/NHttpFileServer.java}
+ Asynchronous HTTP server}}
+
+ This example demonstrates the use of HttpCore to build an asynchronous (non-blocking)
+ HTTP server capable of direct channel (zero copy) data transfer.
+
+ * {{{./httpcore/examples/org/apache/hc/core5/http/examples/NHttpReverseProxy.java}
+ Asynchronous HTTP reverse proxy}}
+
+ This example demonstrates how HttpCore can be used to build an asynchronous, fully streaming
+ reverse HTTP proxy.
+
http://git-wip-us.apache.org/repos/asf/httpcomponents-website/blob/9eb81367/src/site/apt/httpcomponents-core-5.0.x/index.apt
----------------------------------------------------------------------
diff --git a/src/site/apt/httpcomponents-core-5.0.x/index.apt b/src/site/apt/httpcomponents-core-5.0.x/index.apt
new file mode 100644
index 0000000..6d0b723
--- /dev/null
+++ b/src/site/apt/httpcomponents-core-5.0.x/index.apt
@@ -0,0 +1,58 @@
+~~ ====================================================================
+~~ Licensed to the Apache Software Foundation (ASF) under one
+~~ or more contributor license agreements. See the NOTICE file
+~~ distributed with this work for additional information
+~~ regarding copyright ownership. The ASF licenses this file
+~~ to you under the Apache License, Version 2.0 (the
+~~ "License"); you may not use this file except in compliance
+~~ with the License. You may obtain a copy of the License at
+~~
+~~ http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing,
+~~ software distributed under the License is distributed on an
+~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~~ KIND, either express or implied. See the License for the
+~~ specific language governing permissions and limitations
+~~ under the License.
+~~ ====================================================================
+~~
+~~ This software consists of voluntary contributions made by many
+~~ individuals on behalf of the Apache Software Foundation. For more
+~~ information on the Apache Software Foundation, please see
+~~ <http://www.apache.org/>.
+
+ ----------
+ HttpComponents HttpCore Overview
+ ----------
+ ----------
+ ----------
+
+HttpCore Overview
+
+ HttpCore is a set of low level HTTP transport components that can be used to build custom
+ client and server side HTTP services with a minimal footprint. HttpCore supports two I/O models:
+ blocking I/O model based on the classic Java I/O and non-blocking, event driven I/O model based
+ on Java NIO.
+
+{Documentation}
+
+ [[1]] Some examples of HttpCore components in action can be found {{{./examples.html}here}}
+
+ [[1]] Project reports
+
+ * {{{./httpcore/project-reports.html}HttpCore}}
+
+{Standards Compliance}
+
+ HttpCore components strive to conform to the following specifications endorsed by the Internet
+ Engineering Task Force (IETF) and the internet at large:
+
+ * {{{http://tools.ietf.org/html/rfc7230}RFC 7230}} - Hypertext Transfer Protocol (HTTP/1.1):
+ Message Syntax and Routing
+
+ * {{{http://tools.ietf.org/html/rfc7231}RFC 7231}} - Hypertext Transfer Protocol (HTTP/1.1):
+ Semantics and Content
+
+ * {{{http://tools.ietf.org/html/rfc1945}RFC 1945}} - Hypertext Transfer Protocol -- HTTP/1.0
+
http://git-wip-us.apache.org/repos/asf/httpcomponents-website/blob/9eb81367/src/site/apt/news.apt
----------------------------------------------------------------------
diff --git a/src/site/apt/news.apt b/src/site/apt/news.apt
index d454239..7d815c9 100644
--- a/src/site/apt/news.apt
+++ b/src/site/apt/news.apt
@@ -30,6 +30,24 @@
HttpComponents Project News
+* 3 January 2016 - HttpComponents HttpCore 5.0-alpa1 released
+
+ This is a major release that renders HttpCore API incompatible with the stable 4.x branch
+ and upgrades HTTP/1.1 protocol conformance to the requirements and recommendations of the
+ latest protocol specification. This release lays the foundation for transition to HTTP/2 as
+ the primary transport protocol in the future releases.
+
+ Notable changes and features included in the 5.0 series are:
+
+ * Improved conformance to requirements and recommendations of the latest HTTP/1.1 protocol
+ specification (RFC 7230, RFC 7231)
+
+ * Blocking I/O and NIO HTTP transport implementation has been folded into one module
+
+ * Package name space changed to 'org.apache.hc.core5'
+
+ * Maven group id changed to 'org.apache.httpcomponents.core5'
+
* 9 November 2015 - HttpComponents HttpAsyncClient 4.1.1 (GA) released
This is a maintenance release that fixes a number of issues discovered since release 4.1 and
http://git-wip-us.apache.org/repos/asf/httpcomponents-website/blob/9eb81367/src/site/apt/status.apt
----------------------------------------------------------------------
diff --git a/src/site/apt/status.apt b/src/site/apt/status.apt
index 5376ca3..dbb36b7 100644
--- a/src/site/apt/status.apt
+++ b/src/site/apt/status.apt
@@ -42,21 +42,16 @@ HttpComponents Project Status
series is ensuring full compliance with RFC 7230, 7231, laying a foundation for transition to
HTTP/2.0 and incremental API improvements.
-* {HttpComponents HttpClient 4.4.x}
+* {HttpComponents HttpClient 4.5.x}
- HttpClient 4.4.x branch is considered stable and production ready. It is being actively
+ HttpClient 4.5.x branch is considered stable and production ready. It is being actively
maintained and supported. Users of all versions of HttpClient are advised to upgrade to the
- latest release of the 4.4 series.
-
-* {HttpComponents HttpAsyncClient 4.0.x}
-
- HttpAsyncClient 4.0.x branch is considered stable and production ready. It is being actively
- maintained and supported.
+ latest release of the 4.5 series.
* {HttpComponents HttpAsyncClient 4.1.x}
- HttpAsyncClient 4.1.x branch is the current unstable development branch. Noteworthy features
- being developed in 4.1 are support for pipelined request execution and processing.
+ HttpAsyncClient 4.1.x branch is considered stable and production ready. It is being actively
+ maintained and supported.
* {Commons HttpClient 3.1.x}
http://git-wip-us.apache.org/repos/asf/httpcomponents-website/blob/9eb81367/src/site/site.xml
----------------------------------------------------------------------
diff --git a/src/site/site.xml b/src/site/site.xml
index fff4d4f..f972b82 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -88,6 +88,11 @@
<item name="Download" href="httpcomponents-client-4.5.x/download.html"/>
<item name="Project Info" href="httpcomponents-client-4.5.x/project-info.html"/>
</item>
+ <item name="HttpCore 5.0 alpha" collapse="true" href="httpcomponents-core-5.0.x/index.html">
+ <item name="Examples" href="httpcomponents-core-5.0.x/examples.html"/>
+ <item name="Download" href="httpcomponents-core-5.0.x/download.html"/>
+ <item name="Project Info" href="httpcomponents-core-5.0.x/project-info.html"/>
+ </item>
<item name="HttpCore 4.4" collapse="true" href="httpcomponents-core-4.4.x/index.html">
<item name="Tutorial" href="httpcomponents-core-4.4.x/tutorial/html/index.html"/>
<item name="Examples" href="httpcomponents-core-4.4.x/examples.html"/>
http://git-wip-us.apache.org/repos/asf/httpcomponents-website/blob/9eb81367/src/site/xdoc/downloads.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/downloads.xml b/src/site/xdoc/downloads.xml
index 98c9fe3..019b6d6 100644
--- a/src/site/xdoc/downloads.xml
+++ b/src/site/xdoc/downloads.xml
@@ -149,9 +149,52 @@
<p>Recent releases of HttpCore can be found <a href="[preferred]/httpcomponents/httpcore">here</a></p>
</subsection>
+ <subsection name="HttpCore 5.0-alpha1">
+ <a href="http://www.apache.org/dist/httpcomponents/httpcore/KEYS">KEYS</a>
+ <a href="http://www.apache.org/dist/httpcomponents/httpcore/RELEASE_NOTES-5.0.x.txt">Release Notes</a>
+ <br/>
+ <p>Binary</p>
+ <ul>
+ <li>
+ <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-bin.tar.gz">5.0-alpha1.tar.gz</a>
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-bin.tar.gz.md5">md5</a>]
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-bin.tar.gz.asc">pgp</a>]
+ </li>
+ <li>
+ <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-bin.zip">5.0-alpha1.zip</a>
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-bin.zip.md5">md5</a>]
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-bin.zip.asc">pgp</a>]
+ </li>
+ <li>
+ <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-osgi-bin.tar.gz">5.0-alpha1.tar.gz (OSGi bundle)</a>
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-osgi-bin.tar.gz.md5">md5</a>]
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-osgi-bin.tar.gz.asc">pgp</a>]
+ </li>
+ <li>
+ <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-osgi-bin.zip">5.0-alpha1.zip (OSGi bundle)</a>
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-osgi-bin.zip.md5">md5</a>]
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/binary/httpcomponents-core-5.0-alpha1-osgi-bin.zip.asc">pgp</a>]
+ </li>
+ </ul>
+ <p>Source</p>
+ <ul>
+ <li>
+ <a href="[preferred]/httpcomponents/httpcore/source/httpcomponents-core-5.0-alpha1-src.tar.gz">5.0-alpha1.tar.gz</a>
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/source/httpcomponents-core-5.0-alpha1-src.tar.gz.md5">md5</a>]
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/source/httpcomponents-core-5.0-alpha1-src.tar.gz.asc">pgp</a>]
+ </li>
+ <li>
+ <a href="[preferred]/httpcomponents/httpcore/source/httpcomponents-core-5.0-alpha1-src.zip">5.0-alpha1.zip</a>
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/source/httpcomponents-core-5.0-alpha1-src.zip.md5">md5</a>]
+ [<a href="http://www.apache.org/dist/httpcomponents/httpcore/source/httpcomponents-core-5.0-alpha1-src.zip.asc">pgp</a>]
+ </li>
+ </ul>
+ <p>Recent releases of HttpCore can be found <a href="[preferred]/httpcomponents/httpcore">here</a></p>
+ </subsection>
+
<subsection name="HttpAsyncClient 4.1.1 (GA)">
<a href="http://www.apache.org/dist/httpcomponents/httpasyncclient/KEYS">KEYS</a>
- <a href="http://www.apache.org/dist/httpcomponents/httpasyncclient/RELEASE_NOTES-4.1.1.x.txt">Release Notes</a>
+ <a href="http://www.apache.org/dist/httpcomponents/httpasyncclient/RELEASE_NOTES-4.1.x.txt">Release Notes</a>
<br/>
<p>Binary</p>
<ul>