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 2020/09/19 14:50:31 UTC
[httpcomponents-website] 02/02: Updated project website for
HttpCore 5.1-beta1 release
This is an automated email from the ASF dual-hosted git repository.
olegk pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/httpcomponents-website.git
commit 9d33edcc8a04be8829e8e202d84f883e6e70d52e
Author: Oleg Kalnichevski <ol...@apache.org>
AuthorDate: Sat Sep 19 16:50:11 2020 +0200
Updated project website for HttpCore 5.1-beta1 release
---
.../apt/httpcomponents-core-5.1.x/download.apt | 50 +++++++++
.../apt/httpcomponents-core-5.1.x/examples.apt | 122 +++++++++++++++++++++
src/site/apt/httpcomponents-core-5.1.x/index.apt | 71 ++++++++++++
.../httpcomponents-core-5.1.x/related-projects.apt | 43 ++++++++
src/site/apt/news.apt | 14 +++
src/site/apt/status.apt | 6 +
src/site/site.xml | 6 +
src/site/xdoc/downloads.xml | 42 +++++++
8 files changed, 354 insertions(+)
diff --git a/src/site/apt/httpcomponents-core-5.1.x/download.apt b/src/site/apt/httpcomponents-core-5.1.x/download.apt
new file mode 100644
index 0000000..70197e4
--- /dev/null
+++ b/src/site/apt/httpcomponents-core-5.1.x/download.apt
@@ -0,0 +1,50 @@
+~~ ====================================================================
+~~ 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 Download Page
+ ----------
+ ----------
+ ----------
+
+HttpCore Downloads
+
+ The latest release available for download:
+
+ {{{http://hc.apache.org/downloads.cgi}Release packages}} -
+ {{{http://www.apache.org/dist/httpcomponents/httpcore/RELEASE_NOTES-5.1.x.txt}Release Notes}} -
+ {{{http://www.apache.org/licenses/LICENSE-2.0.html}License}}
+
+{Dependency management}
+
+ If you are using a dependency manager for your project such as
+ {{{http://maven.apache.org}Apache Maven}} or
+ {{{http://ant.apache.org/projects/ivy.html}Apache Ivy}},
+ you can create a dependency on HttpClient modules by using this information:
+
+ {{{./httpcore5/dependency-info.html}HttpCore HTTP/1.1}}
+ {{{./httpcore5-h2/dependency-info.html}HttpCore HTTP/2}}
+ {{{./httpcore5-reactive/dependency-info.html}HttpCore Reactive Streams}}
+ {{{./httpcore5-testing/dependency-info.html}HttpCore testing support}}
+
diff --git a/src/site/apt/httpcomponents-core-5.1.x/examples.apt b/src/site/apt/httpcomponents-core-5.1.x/examples.apt
new file mode 100644
index 0000000..4cfdbf0
--- /dev/null
+++ b/src/site/apt/httpcomponents-core-5.1.x/examples.apt
@@ -0,0 +1,122 @@
+~~ ====================================================================
+~~ 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
+
+ * {{{./httpcore5/examples/ClassicGetExecutionExample.java}
+ Classic (blocking) HTTP/1.1 GET requests}}
+
+ This example demonstrates synchronous execution of multiple HTTP/1.1 GET requests.
+
+ * {{{./httpcore5/examples/ClassicPostExecutionExample.java}
+ Classic (blocking) HTTP/1.1 POST requests}}
+
+ This example demonstrates synchronous execution of multiple HTTP/1.1 POST requests with enclosed
+ content of various types.
+
+ * {{{./httpcore5/examples/AsyncRequestExecutionExample.java}
+ Asynchronous HTTP/1.1 GET requests}}
+
+ This example demonstrates asynchronous execution of multiple HTTP/1.1 requests.
+
+ * {{{./httpcore5-h2/examples/H2RequestExecutionExample.java}
+ Asynchronous HTTP/2 GET requests}}
+
+ This example demonstrates asynchronous execution of multiple HTTP/2 requests.
+
+ * {{{./httpcore5-h2/examples/H2TlsAlpnRequestExecutionExample.java}
+ HTTP/2 requests over TLS connections with ALPN support}}
+
+ This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support.
+ It also explains how to avoid the illegal reflective access operation warning when running
+ Java 9 or older.
+
+ * {{{./httpcore5-h2/examples/H2ConscriptRequestExecutionExample.java}
+ HTTP/2 requests over TLS connections with ALPN support on Java 1.7 and Java 1.8}}
+
+ This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support
+ on Java 1.7 and Java 1.8.
+
+ * {{{./httpcore5/examples/AsyncPipelinedRequestExecutionExample.java}
+ Asynchronous HTTP/1.1 GET requests with message pipelining}}
+
+ This example demonstrates asynchronous, pipelined execution multiple HTTP/1.1 requests.
+
+ * {{{./httpcore5-h2/examples/H2MultiStreamExecutionExample.java}
+ Asynchronous HTTP/2 GET requests with multiple concurrent streams}}
+
+ This example demonstrates asynchronous, multistream execution of multiple HTTP/2 requests.
+
+ * {{{./httpcore5/examples/ClassicFileServerExample.java}
+ Classic (blocking) HTTP/1.1 file server}}
+
+ This is an example of an embedded HTTP/1.1 file server with a classic (blocking) message transport.
+
+ * {{{./httpcore5/examples/ClassicServerFilterExample.java}
+ Request filters with classic (blocking) HTTP/1.1 server}}
+
+ This is an example of using synchronous request filters with an embedded HTTP/1.1 server.
+
+ * {{{./httpcore5/examples/AsyncFileServerExample.java}
+ Asynchronous HTTP/1.1 file server}}
+
+ This is an example of an embedded HTTP/1.1 file server with an event driven, non-blocking message transport.
+
+ * {{{./httpcore5/examples/AsyncServerFilterExample.java}
+ Request filters with asynchronous HTTP/1.1 server}}
+
+ This is an example of using asynchronous request filters with an embedded HTTP/1.1 server.
+
+ * {{{./httpcore5-h2/examples/H2FileServerExample.java}
+ Asynchronous HTTP/2 file server}}
+
+ This is an example of an embedded HTTP/2 file server with an event driven, non-blocking message transport.
+
+ * {{{./httpcore5/examples/ClassicReverseProxyExample.java}
+ Classic (blocking) HTTP reverse proxy}}
+
+ This is an example of an embedded HTTP/1.1 reverse proxy with a classic (blocking) message transport.
+
+ * {{{./httpcore5/examples/AsyncReverseProxyExample.java}
+ Asynchronous HTTP reverse proxy}}
+
+ This is an example of an embedded HTTP/1.1 reverse proxy with an event driven, non-blocking message transport.
+
+HttpCore Reactive Streams Examples
+
+ * {{{./httpcore5-reactive/examples/ReactiveFullDuplexClientExample.java}
+ Client Reactive Streams}}
+
+ This is an example of full-duplex HTTP/1.1 client side message exchanges using reactive streaming.
+
+ * {{{./httpcore5-reactive/examples/ReactiveFullDuplexServerExample.java}
+ Server Reactive Streams}}
+
+ This is an example of full-duplex HTTP/1.1 server side message exchanges using reactive streaming.
diff --git a/src/site/apt/httpcomponents-core-5.1.x/index.apt b/src/site/apt/httpcomponents-core-5.1.x/index.apt
new file mode 100644
index 0000000..b5531ca
--- /dev/null
+++ b/src/site/apt/httpcomponents-core-5.1.x/index.apt
@@ -0,0 +1,71 @@
+~~ ====================================================================
+~~ 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
+
+ * {{{./httpcore5/project-reports.html}HttpCore HTTP/1.1}}
+
+ * {{{./httpcore5-h2/project-reports.html}HttpCore HTTP/2}}
+
+ * {{{./httpcore5-reactive/project-reports.html}HttpCore Reactive Streams}}
+
+ * {{{./httpcore5-testing/project-reports.html}HttpCore testing support}}
+
+{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/rfc7540}RFC 7540}} - Hypertext Transfer Protocol Version 2
+ (HTTP/2)
+
+ * {{{http://tools.ietf.org/html/rfc7541}RFC 7541}} - HPACK: Header Compression for HTTP/2
+
+ * {{{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://tools.ietf.org/html/rfc3986}RFC 3986}} - Uniform Resource Identifier (URI): Generic
+ Syntax
diff --git a/src/site/apt/httpcomponents-core-5.1.x/related-projects.apt b/src/site/apt/httpcomponents-core-5.1.x/related-projects.apt
new file mode 100644
index 0000000..2a69703
--- /dev/null
+++ b/src/site/apt/httpcomponents-core-5.1.x/related-projects.apt
@@ -0,0 +1,43 @@
+~~ ====================================================================
+~~ 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
+ ----------
+ ----------
+ ----------
+
+Related projects
+
+* Asynchronous JSON message processors
+
+ {{{https://ok2c.github.io/httpcomponents-jackson/}Asynchronous JSON message processors}}
+ library is a companion project for HttpCore 5.0 developed outside the Apache Software Foundation.
+
+ The library provides a number of asynchronous message consumers and producers
+ for efficient, reactive processing of HTTP messages with enclosed JSON content using
+ {{{https://github.com/FasterXML/jackson}Jackson JSON processor}}.
+
+
+
diff --git a/src/site/apt/news.apt b/src/site/apt/news.apt
index e86f693..384537b 100644
--- a/src/site/apt/news.apt
+++ b/src/site/apt/news.apt
@@ -30,6 +30,20 @@
HttpComponents Project News
+* 21 September 2020 - HttpComponents Core 5.1-beta1 released
+
+ This is the first BETA release in the 5.1 release series that includes a number of
+ new features as well performance optimizations in the classic HTTP transport.
+
+ Notable changes and features included in the 5.1 series:
+
+ * Conditional conformance with RFC 3986 (Uniform Resource Identifier (URI):
+ Generic Syntax).
+
+ * Improved support for out of sequence response message handing by the the classic
+ (blocking) HTTP transport.
+
+
* 13 September 2020 - HttpComponents Core 5.0.2 (GA) released
This release reverts changes to early response handling logic introduced in 5.0.1
diff --git a/src/site/apt/status.apt b/src/site/apt/status.apt
index e7a44d0..53fb9db 100644
--- a/src/site/apt/status.apt
+++ b/src/site/apt/status.apt
@@ -30,6 +30,12 @@
HttpComponents Project Status
+* {HttpComponents HttpCore 5.1.x}
+
+ HttpCore 5.1.x branch is the current feature development branch. The 5.x release
+ series is expected to provide conditional conformance to RFC 3986 as well as
+ a number of incremental functional enhancements and performance improvements.
+
* {HttpComponents HttpCore 5.0.x}
HttpCore 5.0.x branch is considered stable and production ready. It is being actively
diff --git a/src/site/site.xml b/src/site/site.xml
index 92e587f..136aa5a 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -87,6 +87,12 @@
<item name="Download" href="httpcomponents-client-5.0.x/download.html"/>
<item name="Project Info" href="httpcomponents-client-5.0.x/project-info.html"/>
</item>
+ <item name="HttpCore 5.1 BETA" collapse="true" href="httpcomponents-core-5.1.x/index.html">
+ <item name="Examples" href="httpcomponents-core-5.1.x/examples.html"/>
+ <item name="Related" href="httpcomponents-core-5.1.x/related-projects.html"/>
+ <item name="Download" href="httpcomponents-core-5.1.x/download.html"/>
+ <item name="Project Info" href="httpcomponents-core-5.1.x/project-info.html"/>
+ </item>
<item name="HttpCore 5.0" collapse="true" href="httpcomponents-core-5.0.x/index.html">
<item name="Examples" href="httpcomponents-core-5.0.x/examples.html"/>
<item name="Related" href="httpcomponents-core-5.0.x/related-projects.html"/>
diff --git a/src/site/xdoc/downloads.xml b/src/site/xdoc/downloads.xml
index 09106d1..6e50942 100644
--- a/src/site/xdoc/downloads.xml
+++ b/src/site/xdoc/downloads.xml
@@ -236,6 +236,48 @@
</ul>
</subsection>
+ <subsection name="HttpCore 5.1 BETA1">
+ <a href="https://downloads.apache.org/httpcomponents/httpcore/KEYS">KEYS</a>
+ <a href="https://downloads.apache.org/httpcomponents/httpcore/RELEASE_NOTES-5.1-beta1.x.txt">Release Notes</a>
+ <br/>
+ <p>Binary</p>
+ <ul>
+ <li>
+ <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.1-beta1-bin.tar.gz">5.1-beta1.tar.gz</a>
+ [<a
+ href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.1-beta1-bin.tar.gz.sha512">
+ sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.1-beta1-bin.tar.gz.asc">
+ pgp</a>]
+ </li>
+ <li>
+ <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.1-beta1-bin.zip">5.1-beta1.zip</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.1-beta1-bin.zip.sha512">
+ sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.1-beta1-bin.zip.asc">
+ pgp</a>]
+ </li>
+ </ul>
+ <p>Source</p>
+ <ul>
+ <li>
+ <a href="[preferred]/httpcomponents/httpcore/source/httpcomponents-core-5.1-beta1-src.tar.gz">5.1-beta1.tar.gz</a>
+ [<a
+ href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.1-beta1-src.tar.gz.sha512">
+ sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.1-beta1-src.tar.gz.asc">
+ pgp</a>]
+ </li>
+ <li>
+ <a href="[preferred]/httpcomponents/httpcore/source/httpcomponents-core-5.1-beta1-src.zip">5.1-beta1.zip</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.1-beta1-src.zip.sha512">
+ sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.1-beta1-src.zip.asc">
+ pgp</a>]
+ </li>
+ </ul>
+ </subsection>
+
<subsection name="Older releases">
<p>
Old releases are available from the