You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hc.apache.org by ab...@apache.org on 2025/12/23 20:46:17 UTC
(httpcomponents-website) branch master updated (387e25d -> fa0ed05)
This is an automated email from the ASF dual-hosted git repository.
abernal pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/httpcomponents-website.git
from 387e25d Add experimental.
new 411cc22 Add connection management and pooling guides to site
new f8c4e98 Updated project website for HttpCore 5.4 GA release
new a27f47f Add report sections for SSE and Observations modules
new 7640167 Updated project website for HttpClient 5.5.2 GA release
new fa0ed05 Updated project website for HttpClient 5.6 GA release
The 5 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.../httpcomponents-client-5.5.x/download.md | 38 ----
.../httpcomponents-client-5.5.x/examples-async.md | 85 ---------
.../httpcomponents-client-5.5.x/examples.md | 119 -------------
.../markdown/httpcomponents-client-5.5.x/index.md | 95 ----------
.../httpcomponents-client-5.5.x/quickstart.md | 178 -------------------
.../android.md | 0
.../architecture.md | 0
.../configuration.md | 0
.../connection-management.md | 197 +++++++++++++++++++++
.../httpcomponents-client-5.6.x/early-hints.md | 7 +-
.../markdown/httpcomponents-client-5.6.x/index.md | 75 ++++----
.../logging.md | 0
.../migration-guide/index.md | 0
.../migration-guide/migration-to-async-http2.md | 0
.../migration-guide/migration-to-async-simple.md | 0
.../migration-to-async-streaming.md | 0
.../migration-guide/migration-to-classic.md | 0
.../migration-guide/preparation.md | 0
.../related-projects.md | 0
.../index.md} | 26 ++-
.../server-sent-events.md | 0
.../markdown/httpcomponents-core-5.3.x/download.md | 38 ----
.../markdown/httpcomponents-core-5.3.x/examples.md | 95 ----------
.../markdown/httpcomponents-core-5.3.x/index.md | 53 ------
.../related-projects.md | 0
src/site/markdown/news.md | 30 +++-
src/site/markdown/status.md | 28 +--
.../documentation.links | 3 +-
.../documentation.links | 3 +-
.../httpcomponents-core-5.4.x/documentation.links | 3 +-
src/site/site.xml | 42 ++---
src/site/xdoc/downloads.xml | 96 +++-------
32 files changed, 343 insertions(+), 868 deletions(-)
delete mode 100644 src/site/markdown/httpcomponents-client-5.5.x/download.md
delete mode 100644 src/site/markdown/httpcomponents-client-5.5.x/examples-async.md
delete mode 100644 src/site/markdown/httpcomponents-client-5.5.x/examples.md
delete mode 100644 src/site/markdown/httpcomponents-client-5.5.x/index.md
delete mode 100644 src/site/markdown/httpcomponents-client-5.5.x/quickstart.md
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/android.md (100%)
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/architecture.md (100%)
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/configuration.md (100%)
create mode 100644 src/site/markdown/httpcomponents-client-5.6.x/connection-management.md
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/logging.md (100%)
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/migration-guide/index.md (100%)
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/migration-guide/migration-to-async-http2.md (100%)
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/migration-guide/migration-to-async-simple.md (100%)
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/migration-guide/migration-to-async-streaming.md (100%)
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/migration-guide/migration-to-classic.md (100%)
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/migration-guide/preparation.md (100%)
rename src/site/markdown/{httpcomponents-client-5.5.x => httpcomponents-client-5.6.x}/related-projects.md (100%)
rename src/site/markdown/{httpcomponents-client-5.5.x/examples-reactive.md => httpcomponents-client-5.7.x/index.md} (57%)
rename src/site/markdown/{httpcomponents-client-5.6.x => httpcomponents-client-5.7.x}/server-sent-events.md (100%)
delete mode 100644 src/site/markdown/httpcomponents-core-5.3.x/download.md
delete mode 100644 src/site/markdown/httpcomponents-core-5.3.x/examples.md
delete mode 100644 src/site/markdown/httpcomponents-core-5.3.x/index.md
rename src/site/markdown/{httpcomponents-core-5.3.x => httpcomponents-core-5.4.x}/related-projects.md (100%)
(httpcomponents-website) 02/05: Updated project website for HttpCore 5.4 GA release
Posted by ab...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
abernal pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/httpcomponents-website.git
commit f8c4e988ad9bc71f2c03c946b45645348a5e21e5
Author: Oleg Kalnichevski <ol...@apache.org>
AuthorDate: Thu Dec 18 11:29:42 2025 +0100
Updated project website for HttpCore 5.4 GA release
---
.../markdown/httpcomponents-core-5.3.x/download.md | 38 ---------
.../markdown/httpcomponents-core-5.3.x/examples.md | 95 ----------------------
.../markdown/httpcomponents-core-5.3.x/index.md | 53 ------------
.../related-projects.md | 0
src/site/markdown/news.md | 45 ++++++----
src/site/markdown/status.md | 13 +--
.../httpcomponents-core-5.4.x/documentation.links | 3 +-
src/site/site.xml | 9 +-
src/site/xdoc/downloads.xml | 68 +++-------------
9 files changed, 47 insertions(+), 277 deletions(-)
diff --git a/src/site/markdown/httpcomponents-core-5.3.x/download.md b/src/site/markdown/httpcomponents-core-5.3.x/download.md
deleted file mode 100644
index c5e9270..0000000
--- a/src/site/markdown/httpcomponents-core-5.3.x/download.md
+++ /dev/null
@@ -1,38 +0,0 @@
-<!--
- 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.
--->
-
-HttpCore Downloads
-==================
-
-The latest release available for download:
-
-[Release packages](https://hc.apache.org/downloads.cgi) -
-[Release Notes](https://www.apache.org/dist/httpcomponents/httpcore/RELEASE_NOTES-5.3.x.txt) -
-[License](https://www.apache.org/licenses/LICENSE-2.0.html)
-
-Dependency management
----------------------
-
-If you are using a dependency manager for your project such as [Apache Maven](https://maven.apache.org),
-[Gradle](https://gradle.org/) or [Apache Ivy](https://ant.apache.org/projects/ivy.html), you can create a dependency on
-HttpCore modules by using this information:
-
-- [HttpCore HTTP/1.1](https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5)
-- [HttpCore HTTP/2](https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5-h2)
-- [HttpCore Reactive Streams](https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5-reactive)
diff --git a/src/site/markdown/httpcomponents-core-5.3.x/examples.md b/src/site/markdown/httpcomponents-core-5.3.x/examples.md
deleted file mode 100644
index 1ca86ab..0000000
--- a/src/site/markdown/httpcomponents-core-5.3.x/examples.md
+++ /dev/null
@@ -1,95 +0,0 @@
-<!--
- 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.
--->
-
-HttpCore Examples
-=================
-
-- [ Classic (blocking) HTTP/1.1 GET requests](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicGetExecutionExample.java)
-
- This example demonstrates synchronous execution of multiple HTTP/1.1 GET requests.
-
-- [ Classic (blocking) HTTP/1.1 POST requests](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicPostExecutionExample.java)
-
- This example demonstrates synchronous execution of multiple HTTP/1.1 POST requests with enclosed content of various
- types.
-
-- [ Asynchronous HTTP/1.1 GET requests](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncRequestExecutionExample.java)
-
- This example demonstrates asynchronous execution of multiple HTTP/1.1 requests.
-
-- [ Asynchronous HTTP/2 GET requests](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2RequestExecutionExample.java)
-
- This example demonstrates asynchronous execution of multiple HTTP/2 requests.
-
-- [ HTTP/2 requests over TLS connections with ALPN support on Java 1.7 and Java 1.8](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2ConscriptRequestExecutionExample.java)
-
- This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support on Java 1.7 and Java
- 1.8.
-
-- [ Asynchronous HTTP/1.1 GET requests with message pipelining](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncPipelinedRequestExecutionExample.java)
-
- This example demonstrates asynchronous, pipelined execution multiple HTTP/1.1 requests.
-
-- [ Asynchronous HTTP/2 GET requests with multiple concurrent streams](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2MultiStreamExecutionExample.java)
-
- This example demonstrates asynchronous, multistream execution of multiple HTTP/2 requests.
-
-- [ Classic (blocking) HTTP/1.1 file server](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicFileServerExample.java)
-
- This is an example of an embedded HTTP/1.1 file server with a classic (blocking) message transport.
-
-- [ Request filters with classic (blocking) HTTP/1.1 server](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicServerFilterExample.java)
-
- This is an example of using synchronous request filters with an embedded HTTP/1.1 server.
-
-- [ Asynchronous HTTP/1.1 file server](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncFileServerExample.java)
-
- This is an example of an embedded HTTP/1.1 file server with an event driven, non-blocking message transport.
-
-- [ Request filters with asynchronous HTTP/1.1 server](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncServerFilterExample.java)
-
- This is an example of using asynchronous request filters with an embedded HTTP/1.1 server.
-
-- [ Asynchronous HTTP/2 file server](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2FileServerExample.java)
-
- This is an example of an embedded HTTP/2 file server with an event driven, non-blocking message transport.
-
-- [ Classic (blocking) HTTP reverse proxy](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicReverseProxyExample.java)
-
- This is an example of an embedded HTTP/1.1 reverse proxy with a classic (blocking) message transport.
-
-- [ Asynchronous HTTP reverse proxy](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncReverseProxyExample.java)
-
- This is an example of an embedded HTTP/1.1 reverse proxy with an event driven, non-blocking message transport.
-
-- [ Client Reactive Streams](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-reactive/src/test/java/org/apache/hc/core5/reactive/examples/ReactiveFullDuplexClientExample.java)
-
- This is an example of full-duplex HTTP/1.1 client side message exchanges using reactive streaming.
-
-- [ Server Reactive Streams](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-reactive/src/test/java/org/apache/hc/core5/reactive/examples/ReactiveFullDuplexServerExample.java)
-
- This is an example of full-duplex HTTP/1.1 server side message exchanges using reactive streaming.
-
-- [ SNI (Server Name Identification) with classic (blocking) I/O](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicGetExecutionExample.java)
-
- This is an example of SNI (Server Name Identification) usage with classic I/O.
-
-- [ SNI (Server Name Identification) with async I/O](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncClientSNIExample.java)
-
- This is an example of SNI (Server Name Identification) usage with async I/O.
diff --git a/src/site/markdown/httpcomponents-core-5.3.x/index.md b/src/site/markdown/httpcomponents-core-5.3.x/index.md
deleted file mode 100644
index 1cf64ed..0000000
--- a/src/site/markdown/httpcomponents-core-5.3.x/index.md
+++ /dev/null
@@ -1,53 +0,0 @@
-<!--
- 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.
--->
-
-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 [here](./examples.html)
-
-1. Javadocs
- - [HttpCore HTTP/1.1](./current/httpcore5/apidocs/)
- - [HttpCore HTTP/2](./current/httpcore5-h2/apidocs/)
- - [HttpCore Reactive Streams](./current/httpcore5-reactive/apidocs/)
-
-1. API compatibility reports
- - [HttpCore HTTP/1.1](./current/httpcore5/japicmp.html)
- - [HttpCore HTTP/2](./current/httpcore5-h2/japicmp.html)
- - [HttpCore Reactive Streams](./current/httpcore5-reactive/japicmp.html)
-
-Standards Compliance
---------------------
-
-HttpCore components strive to conform to the following specifications endorsed by the Internet Engineering Task Force
-(IETF) and the internet at large:
-
-- [RFC 9110](https://datatracker.ietf.org/doc/html/rfc9110) - HTTP Semantics
-- [RFC 9112](https://datatracker.ietf.org/doc/html/rfc9112) - Hypertext Transfer Protocol Version 1.1 (HTTP/1.1)
-- [RFC 7540](https://datatracker.ietf.org/doc/html/rfc7540) - Hypertext Transfer Protocol Version 2 (HTTP/2)
-- [RFC 7541](https://datatracker.ietf.org/doc/html/rfc7541) - HPACK: Header Compression for HTTP/2
-- [RFC 1945](https://datatracker.ietf.org/doc/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0
-- [RFC 2396](https://datatracker.ietf.org/doc/html/rfc2396) - Uniform Resource Identifiers (URI): Generic Syntax
diff --git a/src/site/markdown/httpcomponents-core-5.3.x/related-projects.md b/src/site/markdown/httpcomponents-core-5.4.x/related-projects.md
similarity index 100%
rename from src/site/markdown/httpcomponents-core-5.3.x/related-projects.md
rename to src/site/markdown/httpcomponents-core-5.4.x/related-projects.md
diff --git a/src/site/markdown/news.md b/src/site/markdown/news.md
index 71357fa..8996f71 100644
--- a/src/site/markdown/news.md
+++ b/src/site/markdown/news.md
@@ -20,6 +20,33 @@
HttpComponents Project News
===========================
+###### 16 December 2025 - HttpComponents Core 5.4 GA released
+
+This is the first GA release in the 5.4 release series that improves HTTP/2 protocol
+support by ensuring conformance to the latest HTTP specification (RFC 9113) and adds
+support for Unix domain sockets.
+
+Notable changes and features included in the 5.4 series:
+
+* Experimental OFFLOCK (lock-free) connection pool.
+
+* Conformance to RFC 9218 (Extensible Prioritization Scheme for HTTP).
+
+* Improved conformance to RFC 9113 (Hypertext Transfer Protocol Version 2).
+
+* Five-second TCP keep-alive enabled by default.
+
+* Unix domain socket support by the classic and async transports.
+
+* Redesign of classic over async API bridge.
+
+* Improved URI encoding per RFC 3986.
+
+* QUERY method support.
+
+* Improved idle connection validation in the async transport.
+
+
###### 27 October 2025 - HttpComponents Client 5.6-alpha1 released
This is the first ALPHA release in the 5.6 release series. It adds several features
@@ -51,24 +78,6 @@ This is the first ALPHA release in the 5.4 release series that improves HTTP/2 p
support by ensuring conformance to the latest HTTP specification (RFC 9113) and adds
support for Unix domain sockets.
-Notable changes and features included in the 5.4 series:
-
-* Experimental OFFLOCK (lock-free) connection pool.
-
-* Conformance to RFC 9218 (Extensible Prioritization Scheme for HTTP).
-
-* Improved conformance to RFC 9113 (Hypertext Transfer Protocol Version 2).
-
-* Five-second TCP keep-alive enabled by default.
-
-* Unix domain socket support by the classic and async transports.
-
-* Redesign of classic over async API bridge.
-
-* Improved URI encoding per RFC 3986.
-
-* QUERY method support.
-
###### 22 September 2025 - HttpComponents Core 5.3.6 GA released
This maintenance release fixes a regression introduced by the previous release that can
diff --git a/src/site/markdown/status.md b/src/site/markdown/status.md
index 68053c3..87d08b0 100644
--- a/src/site/markdown/status.md
+++ b/src/site/markdown/status.md
@@ -40,17 +40,10 @@ use of HTTP/2 message multiplexing.
HttpComponents HttpCore 5.4.x
-------------------------------
-HttpCore 5.4.x branch is the current development branch. The 5.4.x release series improves HTTP/2 protocol support
-by ensuring conformance to the latest HTTP specification (RFC 9113), adds support for Unix domain sockets, and
-also redesigns the classic over async API compatibity bridge.
+HttpCore 5.4.x branch is the current stable and production ready. The 5.4.x release series improves HTTP/2 protocol
+support by ensuring conformance to the latest HTTP specification (RFC 9113), adds support for Unix domain sockets,
+and also redesigns the classic over async API compatibity bridge.
-HttpComponents HttpCore 5.3.x
--------------------------------
-
-HttpCore 5.3.x branch is considered stable and production ready. It is being actively maintained and supported.
-The 5.3.x release series upgrades HTTP protocol conformance level to RFC 9110 and replaces `synchronized`
-blocks with lock primitives.
-
HttpComponents HttpClient 4.5.x
-------------------------------
diff --git a/src/site/resources/httpcomponents-core-5.4.x/documentation.links b/src/site/resources/httpcomponents-core-5.4.x/documentation.links
index 999f21f..e56c956 100644
--- a/src/site/resources/httpcomponents-core-5.4.x/documentation.links
+++ b/src/site/resources/httpcomponents-core-5.4.x/documentation.links
@@ -21,4 +21,5 @@
# links to components in https://hc.apache.org/components/
5.4-alpha1 ../components/httpcomponents-core-5.4.x/5.4-alpha1
-current ../components/httpcomponents-core-5.4.x/5.4-alpha1
+5.4 ../components/httpcomponents-core-5.4.x/5.4
+current ../components/httpcomponents-core-5.4.x/5.4
diff --git a/src/site/site.xml b/src/site/site.xml
index d14ca83..bfb275c 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -98,14 +98,9 @@ under the License.
<item name="Examples (Reactive)" href="httpcomponents-client-5.6.x/examples-reactive.html"/>
<item name="Download" href="httpcomponents-client-5.6.x/download.html"/>
</item>
- <item name="HttpCore 5.3" collapse="true" href="httpcomponents-core-5.3.x/index.html">
- <item name="Examples" href="httpcomponents-core-5.3.x/examples.html"/>
- <item name="Related" href="httpcomponents-core-5.3.x/related-projects.html"/>
- <item name="Download" href="httpcomponents-core-5.3.x/download.html"/>
- </item>
- <item name="HttpCore 5.4 ALPHA" collapse="true" href="httpcomponents-core-5.4.x/index.html">
+ <item name="HttpCore 5.4" collapse="true" href="httpcomponents-core-5.4.x/index.html">
<item name="Examples" href="httpcomponents-core-5.4.x/examples.html"/>
- <item name="Related" href="httpcomponents-core-5.3.x/related-projects.html"/>
+ <item name="Related" href="httpcomponents-core-5.4.x/related-projects.html"/>
<item name="Download" href="httpcomponents-core-5.4.x/download.html"/>
</item>
<item name="HttpClient 4.5" collapse="true" href="httpcomponents-client-4.5.x/index.html">
diff --git a/src/site/xdoc/downloads.xml b/src/site/xdoc/downloads.xml
index e3bde37..fab3158 100644
--- a/src/site/xdoc/downloads.xml
+++ b/src/site/xdoc/downloads.xml
@@ -96,85 +96,43 @@
</ul>
</subsection>
- <subsection name="HttpCore 5.3.6 (GA)">
- <a href="https://downloads.apache.org/httpcomponents/httpcore/KEYS">KEYS</a>
- <a href="https://downloads.apache.org/httpcomponents/httpcore/RELEASE_NOTES-5.3.x.txt">Release Notes</a>
- <br/>
- <p>Binary</p>
- <ul>
- <li>
- <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.3.6-bin.tar.gz">5.3.6.tar.gz</a>
- [<a
- href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.3.6-bin.tar.gz.sha512">
- sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.3.6-bin.tar.gz.asc">
- pgp</a>]
- </li>
- <li>
- <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.3.6-bin.zip">5.3.6.zip</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.3.6-bin.zip.sha512">
- sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.3.6-bin.zip.asc">
- pgp</a>]
- </li>
- </ul>
- <p>Source</p>
- <ul>
- <li>
- <a href="[preferred]/httpcomponents/httpcore/source/httpcomponents-core-5.3.6-src.tar.gz">5.3.6.tar.gz</a>
- [<a
- href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.3.6-src.tar.gz.sha512">
- sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.3.6-src.tar.gz.asc">
- pgp</a>]
- </li>
- <li>
- <a href="[preferred]/httpcomponents/httpcore/source/httpcomponents-core-5.3.6-src.zip">5.3.6.zip</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.3.6-src.zip.sha512">
- sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.3.6-src.zip.asc">
- pgp</a>]
- </li>
- </ul>
- </subsection>
-
- <subsection name="HttpCore 5.4-alpha1">
+ <subsection name="HttpCore 5.4">
<a href="https://downloads.apache.org/httpcomponents/httpcore/KEYS">KEYS</a>
<a href="https://downloads.apache.org/httpcomponents/httpcore/RELEASE_NOTES-5.4.x.txt">Release Notes</a>
<br/>
<p>Binary</p>
<ul>
<li>
- <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.4-alpha1-bin.tar.gz">5.4-alpha1.tar.gz</a>
+ <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.4-bin.tar.gz">5.4.tar.gz</a>
[<a
- href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.4-alpha1-bin.tar.gz.sha512">
+ href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.4-bin.tar.gz.sha512">
sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.4-alpha1-bin.tar.gz.asc">
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.4-bin.tar.gz.asc">
pgp</a>]
</li>
<li>
- <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.4-alpha1-bin.zip">5.4-alpha1.zip</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.4-alpha1-bin.zip.sha512">
+ <a href="[preferred]/httpcomponents/httpcore/binary/httpcomponents-core-5.4-bin.zip">5.4.zip</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.4-bin.zip.sha512">
sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.4-alpha1-bin.zip.asc">
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/binary/httpcomponents-core-5.4-bin.zip.asc">
pgp</a>]
</li>
</ul>
<p>Source</p>
<ul>
<li>
- <a href="[preferred]/httpcomponents/httpcore/source/httpcomponents-core-5.4-alpha1-src.tar.gz">5.4-alpha1.tar.gz</a>
+ <a href="[preferred]/httpcomponents/httpcore/source/httpcomponents-core-5.4-src.tar.gz">5.4.tar.gz</a>
[<a
- href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.4-alpha1-src.tar.gz.sha512">
+ href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.4-src.tar.gz.sha512">
sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.4-alpha1-src.tar.gz.asc">
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.4-src.tar.gz.asc">
pgp</a>]
</li>
<li>
- <a href="[preferred]/httpcomponents/httpcore/source/httpcomponents-core-5.4-alpha1-src.zip">5.4-alpha1.zip</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.4-alpha1-src.zip.sha512">
+ <a href="[preferred]/httpcomponents/httpcore/source/httpcomponents-core-5.4-src.zip">5.4.zip</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.4-src.zip.sha512">
sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.4-alpha1-src.zip.asc">
+ [<a href="https://downloads.apache.org/httpcomponents/httpcore/source/httpcomponents-core-5.4-src.zip.asc">
pgp</a>]
</li>
</ul>
(httpcomponents-website) 01/05: Add connection management and pooling guides to site
Posted by ab...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
abernal pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/httpcomponents-website.git
commit 411cc2251a336d563d7f47c76ad46778312ce11b
Author: Arturo Bernal <ab...@apache.org>
AuthorDate: Fri Dec 12 09:06:32 2025 +0100
Add connection management and pooling guides to site
---
.../connection-management.md | 197 +++++++++++++++++++++
.../markdown/httpcomponents-client-5.6.x/index.md | 2 +-
2 files changed, 198 insertions(+), 1 deletion(-)
diff --git a/src/site/markdown/httpcomponents-client-5.6.x/connection-management.md b/src/site/markdown/httpcomponents-client-5.6.x/connection-management.md
new file mode 100644
index 0000000..d85f00d
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.6.x/connection-management.md
@@ -0,0 +1,197 @@
+<!--
+ 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.
+-->
+
+Connection management
+=====================
+
+HttpClient reuses persistent connections to reduce latency and resource usage.
+Connection management is handled by dedicated connection managers for classic
+(blocking) and async I/O.
+
+Connection managers
+-------------------
+
+The main connection managers are:
+
+* `PoolingHttpClientConnectionManager` (classic I/O)
+* `PoolingAsyncClientConnectionManager` (async I/O)
+
+Both managers:
+
+* Maintain per-route and total connection limits.
+* Reuse persistent connections when possible.
+* Enforce connection time-to-live (TTL) and idle expiry.
+* Provide APIs to close idle or expired connections explicitly.
+
+For a detailed description of pooling policies see
+[Connection pooling](connection-pooling.md).
+
+Per-route and total limits
+--------------------------
+
+Connection limits are expressed in terms of:
+
+* **Per-route limit** – maximum number of connections for a single `HttpRoute`.
+* **Total limit** – maximum number of connections across all routes.
+
+Classic:
+
+```java
+final PoolingHttpClientConnectionManager cm =
+ PoolingHttpClientConnectionManagerBuilder.create()
+ .setMaxConnTotal(200)
+ .setMaxConnPerRoute(50)
+ .build();
+```
+
+Async:
+
+```java
+final PoolingAsyncClientConnectionManager cm =
+ PoolingAsyncClientConnectionManagerBuilder.create()
+ .setMaxConnTotal(200)
+ .setMaxConnPerRoute(50)
+ .build();
+```
+
+These limits should reflect expected concurrency and the capacity of the remote
+services and network.
+
+Connection lifetime and idle timeout
+------------------------------------
+
+Connection lifetime (TTL) limits how long a persistent connection can be reused
+regardless of its keep-alive semantics. Idle timeout limits how long a
+connection may stay idle in the pool before being considered stale.
+
+Both are configured via `ConnectionConfig`:
+
+```java
+final ConnectionConfig connectionConfig = ConnectionConfig.custom()
+ .setTimeToLive(TimeValue.ofMinutes(5))
+ .setIdleTimeout(TimeValue.ofMinutes(1))
+ .build();
+```
+
+Classic:
+
+```java
+final PoolingHttpClientConnectionManager cm =
+ PoolingHttpClientConnectionManagerBuilder.create()
+ .setDefaultConnectionConfig(connectionConfig)
+ .build();
+```
+
+Async:
+
+```java
+final PoolingAsyncClientConnectionManager cm =
+ PoolingAsyncClientConnectionManagerBuilder.create()
+ .setDefaultConnectionConfig(connectionConfig)
+ .build();
+```
+
+Connections that exceed their TTL or idle timeout are discarded when leased or
+by explicit eviction.
+
+Evicting idle and expired connections
+-------------------------------------
+
+Applications are encouraged to run a background task to evict idle and expired
+connections from the pool.
+
+Classic:
+
+```java
+cm.closeExpired();
+cm.closeIdle(TimeValue.ofMinutes(1));
+```
+
+Async:
+
+```java
+asyncManager.closeExpired();
+asyncManager.closeIdle(TimeValue.ofMinutes(1));
+```
+
+This keeps the pool clean in long-lived applications and reduces the probability
+of using dead connections after long periods of inactivity.
+
+Validation after inactivity
+---------------------------
+
+Persistent connections kept idle for a long time can become half-closed by
+intermediaries (stale connections). HttpClient can validate such connections
+before re-use based on a configurable inactivity threshold:
+
+```java
+final ConnectionConfig connectionConfig = ConnectionConfig.custom()
+ .setValidateAfterInactivity(TimeValue.ofSeconds(2))
+ .build();
+```
+
+When the inactivity period of a connection exceeds this threshold, the manager
+will perform a lightweight `isStale()` check before leasing it.
+
+* A small positive value (e.g. 1–2 seconds) is often a good compromise.
+* A non-positive value disables validation and may increase the risk of
+ encountering stale connections on the first request after a long idle period.
+
+Classic and async managers both honour `validateAfterInactivity` when leasing
+connections.
+
+Concurrency policies and off-lock disposal
+------------------------------------------
+
+Connection managers support different pool concurrency policies via
+`PoolConcurrencyPolicy`:
+
+* `STRICT` – per-route queues and strong fairness (default).
+* `LAX` – relaxed fairness in favour of higher throughput.
+* `OFFLOCK` – experimental route-segmented policy reducing contention on shared
+ structures.
+
+See [Connection pooling](connection-pooling.md) for details and examples.
+
+Blocking connection pools can optionally move slow graceful closes off the hot
+pool locks:
+
+```java
+final PoolingHttpClientConnectionManager cm =
+ PoolingHttpClientConnectionManagerBuilder.create()
+ .setPoolConcurrencyPolicy(PoolConcurrencyPolicy.STRICT)
+ .setOffLockDisposalEnabled(true)
+ .build();
+```
+
+With off-lock disposal enabled, removal from the pool happens immediately, while
+the actual graceful close is performed outside the core pool synchronisation.
+
+Practical recommendations
+-------------------------
+
+* Start with the default `STRICT` policy and conservative limits.
+* Size `maxConnTotal` and `maxConnPerRoute` based on expected concurrency and
+ backend capacity; monitor and adjust.
+* Always run periodic eviction of idle and expired connections in long-lived
+ applications.
+* Enable `validateAfterInactivity` with a small positive value if connections
+ are kept idle for extended periods.
+* Consider `LAX` or `OFFLOCK` (experimental) for highly concurrent workloads
+ where reducing contention is more important than strict per-route fairness.
diff --git a/src/site/markdown/httpcomponents-client-5.6.x/index.md b/src/site/markdown/httpcomponents-client-5.6.x/index.md
index c532179..29c8600 100644
--- a/src/site/markdown/httpcomponents-client-5.6.x/index.md
+++ b/src/site/markdown/httpcomponents-client-5.6.x/index.md
@@ -46,7 +46,7 @@ Documentation
* [HttpClient (sse APIs)](server-sent-events.md)
1. Guides
-
+ * [Connection management](connection-management.md)
* [Connection pooling](connection-pooling.md)
1. Javadocs
(httpcomponents-website) 03/05: Add report sections for SSE and Observations modules
Posted by ab...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
abernal pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/httpcomponents-website.git
commit a27f47fbda9a8a0e9d7d1105398e1627dcfa36fe
Author: Arturo Bernal <ab...@apache.org>
AuthorDate: Sat Dec 20 13:39:01 2025 +0100
Add report sections for SSE and Observations modules
---
src/site/markdown/httpcomponents-client-5.6.x/index.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/src/site/markdown/httpcomponents-client-5.6.x/index.md b/src/site/markdown/httpcomponents-client-5.6.x/index.md
index 29c8600..da460d9 100644
--- a/src/site/markdown/httpcomponents-client-5.6.x/index.md
+++ b/src/site/markdown/httpcomponents-client-5.6.x/index.md
@@ -62,6 +62,8 @@ Documentation
* [HttpClient](./current/httpclient5/japicmp.html)
* [HC Fluent](./current/httpclient5-fluent/japicmp.html)
* [HttpClient Cache](./current/httpclient5-cache/japicmp.html)
+ * [HC Observation](./current/httpclient5-observation/japicmp.html)
+ * [HC sse](./current/httpclient5-sse/japicmp.html)
Features
--------
(httpcomponents-website) 05/05: Updated project website for HttpClient 5.6 GA release
Posted by ab...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
abernal pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/httpcomponents-website.git
commit fa0ed05a2abd51c606a680c6ebe1e0dd020d12a6
Author: Oleg Kalnichevski <ol...@apache.org>
AuthorDate: Sat Dec 20 15:58:37 2025 +0100
Updated project website for HttpClient 5.6 GA release
---
.../httpcomponents-client-5.5.x/download.md | 38 -----
.../httpcomponents-client-5.5.x/examples-async.md | 85 ----------
.../httpcomponents-client-5.5.x/examples.md | 119 --------------
.../markdown/httpcomponents-client-5.5.x/index.md | 95 -----------
.../httpcomponents-client-5.5.x/quickstart.md | 178 ---------------------
.../android.md | 0
.../architecture.md | 0
.../configuration.md | 0
.../httpcomponents-client-5.6.x/early-hints.md | 7 +-
.../markdown/httpcomponents-client-5.6.x/index.md | 77 ++++-----
.../logging.md | 0
.../migration-guide/index.md | 0
.../migration-guide/migration-to-async-http2.md | 0
.../migration-guide/migration-to-async-simple.md | 0
.../migration-to-async-streaming.md | 0
.../migration-guide/migration-to-classic.md | 0
.../migration-guide/preparation.md | 0
.../related-projects.md | 0
.../index.md} | 26 ++-
.../server-sent-events.md | 0
src/site/markdown/news.md | 46 +++---
src/site/markdown/status.md | 15 +-
.../documentation.links | 3 +-
src/site/site.xml | 33 ++--
src/site/xdoc/downloads.xml | 30 ++--
25 files changed, 126 insertions(+), 626 deletions(-)
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/download.md b/src/site/markdown/httpcomponents-client-5.5.x/download.md
deleted file mode 100644
index 7d67f48..0000000
--- a/src/site/markdown/httpcomponents-client-5.5.x/download.md
+++ /dev/null
@@ -1,38 +0,0 @@
-<!--
- 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.
--->
-
-HttpClient Downloads
-====================
-
-The latest release available for download:
-
-[Release packages](https://hc.apache.org/downloads.cgi) -
-[Release Notes](https://www.apache.org/dist/httpcomponents/httpclient/RELEASE_NOTES-5.5.x.txt) -
-[License](https://www.apache.org/licenses/LICENSE-2.0.html)
-
-Dependency management
----------------------
-
-If you are using a dependency manager for your project such as [Apache Maven](https://maven.apache.org),
-[Gradle](https://gradle.org/) or [Apache Ivy](https://ant.apache.org/projects/ivy.html), you can create a dependency on
-HttpClient modules by using this information:
-
-- [HttpClient](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5)
-- [HttpClient Fluent](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-fluent)
-- [HttpClient Cache](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-cache)
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/examples-async.md b/src/site/markdown/httpcomponents-client-5.5.x/examples-async.md
deleted file mode 100644
index 34147c9..0000000
--- a/src/site/markdown/httpcomponents-client-5.5.x/examples-async.md
+++ /dev/null
@@ -1,85 +0,0 @@
-<!--
- 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.
--->
-
-HttpClient Examples (Async)
-===========================
-
-- [Asynchronous HTTP exchange](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java)
-
- This example demonstrates a basic asynchronous HTTP request / response exchange. Response content is buffered in
- memory for simplicity.
-
-- [Asynchronous HTTP exchange with content streaming](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchangeStreaming.java)
-
- This example demonstrates an asynchronous HTTP request / response exchange with a full content streaming.
-
-- [Pipelined HTTP/1.1 exchanges](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp1Pipelining.java)
-
- This example demonstrates a pipelined execution of multiple HTTP/1.1 request / response exchanges. Response content is
- buffered in memory for simplicity.
-
-- [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientH2Multiplexing.java)
-
- This example demonstrates a multiplexed execution of multiple HTTP/2 request / response exchanges. Response content is
- buffered in memory for simplicity.
-
-- [Request execution interceptors](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientInterceptors.java)
-
- This example demonstrates how to insert custom request interceptor and an execution interceptor to the request
- execution chain.
-
-- [Message trailers](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientMessageTrailers.java)
-
- This example demonstrates how to use a custom execution interceptor to add trailers to all outgoing request enclosing
- an entity..
-
-- [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp2ServerPush.java)
-
-This example demonstrates handling of HTTP/2 message exchanges pushed by the server.
-
-- [Client authentication](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientAuthentication.java)
-
- This example demonstrates execution of an HTTP request against a target site that requires user authentication.
-
-- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientCustomSSL.java)
-
- This example demonstrates how to create secure connections with a custom SSL context.
-
-- [Connection / TLS configuation per route / host](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientConnectionConfig.java)
-
- This example demonstrates how to use connection configuration on a per-route or a per-host basis.
-
-- [Connection eviction](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientConnectionEviction.java)
-
- This example demonstrates how to evict expired and idle connections from the connection pool.
-
-- [Preemptive BASIC authentication](https://github.com/apache/httpcomponents-client/blob/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncPreemptiveBasicClientAuthentication.java)
-
- This example shows how HttpClient can be customized to authenticate preemptively using BASIC scheme. Generally,
- preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
- discouraged.
-
-- [HTTP version negotiation](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpVersionPolicy.java)
-
- This example demonstrates how to make HttpClient negotiate or force a particular version of HTTP protocol during
- the TLS handshake. Please note that protocol version policy setting also applies to non-HTTPS connections.
-
-- [Virtual HTTPS / SNI](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientSNI.java)
-
- This example demonstrates how to use SNI to send requests to a virtual HTTPS endpoint using the async I/O.
\ No newline at end of file
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/examples.md b/src/site/markdown/httpcomponents-client-5.5.x/examples.md
deleted file mode 100644
index 03f034e..0000000
--- a/src/site/markdown/httpcomponents-client-5.5.x/examples.md
+++ /dev/null
@@ -1,119 +0,0 @@
-<!--
- 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.
--->
-
-HttpClient Examples (Classic)
-=============================
-
-- [Response handling](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientResponseProcessing.java)
-
- This example demonstrates how to process HTTP responses using a response handler. This is the recommended way of
- executing HTTP requests and processing HTTP responses. This approach enables the caller to concentrate on the process
- of digesting HTTP responses and to delegate the task of system resource deallocation to HttpClient. The use of an HTTP
- response handler guarantees that the underlying HTTP connection will be released back to the connection manager
- automatically in all cases.
-
-- [Manual connection release](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionRelease.java)
-
- This example demonstrates how to ensure the release of the underlying HTTP connection back to the connection manager
- in case of a manual processing of HTTP responses.
-
-- [HttpClient configuration](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConfiguration.java)
-
- This example demonstrates how to customize and configure the most common aspects of HTTP request execution and
- connection management.
-
-- [Request execution interceptors](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientInterceptors.java)
-
- This example demonstrates how to insert custom request interceptor and an execution interceptor to the request
- execution chain.
-
-- [Classic APIs over async HttpClient](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientClassicOverAsync.java)
-
- This example demonstrates create a classic HttpClient adaptor over an async HttpClient providing compatibility
- with the classic APIs based on the InputStream / OutputStream model.
-
-- [Abort method](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAbortMethod.java)
-
- This example demonstrates how to abort an HTTP request before its normal completion.
-
-- [Client authentication](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAuthentication.java)
-
- This example uses HttpClient to execute an HTTP request against a target site that requires user authentication.
-
-- [Request via a proxy](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientExecuteProxy.java)
-
- This example demonstrates how to send an HTTP request via a proxy.
-
-- [Proxy authentication](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientProxyAuthentication.java)
-
- A simple example showing execution of an HTTP request over a secure connection tunneled through an authenticating
- proxy.
-
-- [Chunk encoded POST](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientChunkEncodedPost.java)
-
- This example shows how to stream out a request entity using chunk encoding.
-
-- [Custom execution context](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomContext.java)
-
- This example demonstrates the use of a local HTTP context populated custom attributes.
-
-- [Form based logon](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientFormLogin.java)
-
- This example demonstrates how HttpClient can be used to perform form-based logon.
-
-- [Threaded request execution](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultiThreadedExecution.java)
-
- An example that executes HTTP requests from multiple worker threads.
-
-- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomSSL.java)
-
- This example demonstrates how to create secure connections with a custom SSL context.
-
-- [Connection / TLS configuation per route / host](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionConfig.java)
-
- This example demonstrates how to use connection configuration on a per-route or a per-host basis.
-
-- [Preemptive BASIC authentication](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveBasicAuthentication.java)
-
- This example shows how HttpClient can be customized to authenticate preemptively using BASIC scheme. Generally,
- preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
- discouraged.
-
-- [Preemptive DIGEST authentication](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveDigestAuthentication.java)
-
- This example shows how HttpClient can be customized to authenticate preemptively using DIGEST scheme. Generally,
- preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
- discouraged.
-
-- [Proxy tunnel](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ProxyTunnelDemo.java)
-
- This example shows how to use ProxyClient in order to establish a tunnel through an HTTP proxy for an arbitrary
- protocol.
-
-- [Multipart encoded request entity](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultipartFormPost.java)
-
- This example shows how to execute requests enclosing a multipart encoded entity.
-
-- [Connection endpoint details](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientRemoteEndpointDetails.java)
-
- This example demonstrates how to get details of the underlying connection endpoint.
-
-- [Virtual HTTPS / SNI](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientSNI.java)
-
- This example demonstrates how to use SNI to send requests to a virtual HTTPS endpoint using the classic I/O.
\ No newline at end of file
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/index.md b/src/site/markdown/httpcomponents-client-5.5.x/index.md
deleted file mode 100644
index 432e000..0000000
--- a/src/site/markdown/httpcomponents-client-5.5.x/index.md
+++ /dev/null
@@ -1,95 +0,0 @@
-<!--
- 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.
--->
-
-HttpClient 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. HttpClient 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, HttpClient may be of interest to
-anyone building HTTP-aware client applications such as web browsers, web service clients, or systems that leverage or
-extend the HTTP protocol for distributed communication.
-
-Documentation
--------------
-
-1. [Quick Start](quickstart.md) - contains simple, complete examples of request execution
- with the classic, fluent and async APIs.
-1. [Architecture](architecture.md) - describes HttpClient architecture pronciples such as
- the layering concept.
-2. [Configuration guide](configuration.md) - describes principles of HttpClient
- configuration.
-3. [Migration guide](migration-guide/index.md) - helps choose the best migration path from
- older version of Apache HttpClient, different i/o models supported by Apache HttpClient
- or other HTTP clients.
-1. Examples demonstrating some common as well as more complex use cases
-
- * [HttpClient (classic APIs)](examples.md)
- * [HttpClient (async APIs)](examples-async.md)
- * [HttpClient (reactive APIs)](examples-reactive.md)
-
-1. Javadocs
-
- * [HttpClient](./current/httpclient5/apidocs/)
- * [HC Fluent](./current/httpclient5-fluent/apidocs/)
- * [HttpClient Cache](./current/httpclient5-cache/apidocs/)
-
-1. API compatibility reports
-
- * [HttpClient](./current/httpclient5/japicmp.html)
- * [HC Fluent](./current/httpclient5-fluent/japicmp.html)
- * [HttpClient Cache](./current/httpclient5-cache/japicmp.html)
-
-Features
---------
-
-- Standards based, pure Java, implementation of HTTP versions 1.0, 1.1, 2.0
-- Supports encryption with HTTPS (HTTP over SSL) protocol.
-- Pluggable TLS strategies.
-- Transparent message exchanges through HTTP/1.1, HTTP/1.0 and SOCKS proxies.
-- Tunneled HTTPS connections through HTTP/1.1 and HTTP/1.0 proxies, via the CONNECT method.
-- Basic, Digest, Bearer authentication schemes.
-- HTTP state management and cookie support.
-- Flexible connection management and pooling.
-- Support for HTTP response caching.
-- Source code is freely available under the Apache License.
-
-Standards Compliance
---------------------
-
-HttpClient strives to conform to the following specifications endorsed by the Internet Engineering Task Force (IETF) and
-the internet at large:
-
-- [RFC 9110](https://datatracker.ietf.org/doc/html/rfc9110) - HTTP Semantics
-- [RFC 9111](https://datatracker.ietf.org/doc/html/rfc9111) - HTTP Caching
-- [RFC 9112](https://datatracker.ietf.org/doc/html/rfc9112) - Hypertext Transfer Protocol Version 1.1 (HTTP/1.1)
-- [RFC 7540](https://datatracker.ietf.org/doc/html/rfc7540) - Hypertext Transfer Protocol Version 2 (HTTP/2)
-- [RFC 7541](https://datatracker.ietf.org/doc/html/rfc7541) - HPACK: Header Compression for HTTP/2
-- [RFC 1945](https://datatracker.ietf.org/doc/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0
-- [RFC 2396](https://datatracker.ietf.org/doc/html/rfc2396) - Uniform Resource Identifiers (URI): Generic Syntax
-- [RFC 6265](https://datatracker.ietf.org/doc/html/rfc6265) - HTTP State Management Mechanism (Cookies)
-- [RFC 7616](https://datatracker.ietf.org/doc/html/rfc7616) - HTTP Digest Access Authentication
-- [RFC 7617](https://datatracker.ietf.org/doc/html/rfc7617) - HTTP 'Basic' Authentication Scheme
-- [RFC 5861](https://datatracker.ietf.org/doc/html/rfc5861) - HTTP Cache-Control Extensions for Stale Content
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/quickstart.md b/src/site/markdown/httpcomponents-client-5.5.x/quickstart.md
deleted file mode 100644
index d32caca..0000000
--- a/src/site/markdown/httpcomponents-client-5.5.x/quickstart.md
+++ /dev/null
@@ -1,178 +0,0 @@
-<!--
- 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.
--->
-
-HttpClient Quick Start
-======================
-
-- Download 'Binary' package of the latest HttpClient 5.5 release or configure dependency on `HttpClient` and `Fluent HC`
- modules using a dependency manager of your choice as described [here](./download.md).
-
-- HttpClient 5.5 requires Java 1.8 or newer.
-
-- The below code fragment illustrates the execution of HTTP GET and POST requests using the HttpClient native API.
-
- ```
- try (CloseableHttpClient httpclient = HttpClients.createDefault()) {
- ClassicHttpRequest httpGet = ClassicRequestBuilder.get("http://httpbin.org/get")
- .build();
- // The underlying HTTP connection is still held by the response object
- // to allow the response content to be streamed directly from the network socket.
- // In order to ensure correct deallocation of system resources
- // the user MUST call CloseableHttpResponse#close() from a finally clause.
- // Please note that if response content is not fully consumed the underlying
- // connection cannot be safely re-used and will be shut down and discarded
- // by the connection manager.
- httpclient.execute(httpGet, response -> {
- System.out.println(response.getCode() + " " + response.getReasonPhrase());
- final HttpEntity entity1 = response.getEntity();
- // do something useful with the response body
- // and ensure it is fully consumed
- EntityUtils.consume(entity1);
- return null;
- });
-
- ClassicHttpRequest httpPost = ClassicRequestBuilder.post("http://httpbin.org/post")
- .setEntity(new UrlEncodedFormEntity(Arrays.asList(
- new BasicNameValuePair("username", "vip"),
- new BasicNameValuePair("password", "secret"))))
- .build();
- httpclient.execute(httpPost, response -> {
- System.out.println(response.getCode() + " " + response.getReasonPhrase());
- final HttpEntity entity2 = response.getEntity();
- // do something useful with the response body
- // and ensure it is fully consumed
- EntityUtils.consume(entity2);
- return null;
- });
- }
- ```
-
-- The same requests can be executed using a simpler, albeit less flexible, fluent API.
-
- ```
- // The fluent API relieves the user from having to deal with manual deallocation of system
- // resources at the cost of having to buffer response content in memory in some cases.
-
- Request.Get("http://targethost/homepage")
- .execute().returnContent();
- Request.Post("http://targethost/login")
- .bodyForm(Form.form().add("username", "vip").add("password", "secret").build())
- .execute().returnContent();
- ```
-
-- The below code fragment illustrates the execution of HTTP requests using HttpClient async API.
-
- ```
- try (CloseableHttpAsyncClient httpclient = HttpAsyncClients.createDefault()) {
- // Start the client
- httpclient.start();
-
- // Execute request
- SimpleHttpRequest request1 = SimpleRequestBuilder.get("http://httpbin.org/get").build();
- Future<SimpleHttpResponse> future = httpclient.execute(request1, null);
- // and wait until response is received
- SimpleHttpResponse response1 = future.get();
- System.out.println(request1.getRequestUri() + "->" + response1.getCode());
-
- // One most likely would want to use a callback for operation result
- CountDownLatch latch1 = new CountDownLatch(1);
- SimpleHttpRequest request2 = SimpleRequestBuilder.get("http://httpbin.org/get").build();
- httpclient.execute(request2, new FutureCallback<SimpleHttpResponse>() {
-
- @Override
- public void completed(SimpleHttpResponse response2) {
- latch1.countDown();
- System.out.println(request2.getRequestUri() + "->" + response2.getCode());
- }
-
- @Override
- public void failed(Exception ex) {
- latch1.countDown();
- System.out.println(request2.getRequestUri() + "->" + ex);
- }
-
- @Override
- public void cancelled() {
- latch1.countDown();
- System.out.println(request2.getRequestUri() + " cancelled");
- }
-
- });
- latch1.await();
-
- // In real world one most likely would want also want to stream
- // request and response body content
- CountDownLatch latch2 = new CountDownLatch(1);
- AsyncRequestProducer producer3 = AsyncRequestBuilder.get("http://httpbin.org/get").build();
- AbstractCharResponseConsumer<HttpResponse> consumer3 = new AbstractCharResponseConsumer<HttpResponse>() {
-
- HttpResponse response;
-
- @Override
- protected void start(HttpResponse response, ContentType contentType) throws HttpException, IOException {
- this.response = response;
- }
-
- @Override
- protected int capacityIncrement() {
- return Integer.MAX_VALUE;
- }
-
- @Override
- protected void data(CharBuffer data, boolean endOfStream) throws IOException {
- // Do something useful
- }
-
- @Override
- protected HttpResponse buildResult() throws IOException {
- return response;
- }
-
- @Override
- public void releaseResources() {
- }
-
- };
- httpclient.execute(producer3, consumer3, new FutureCallback<HttpResponse>() {
-
- @Override
- public void completed(HttpResponse response3) {
- latch2.countDown();
- System.out.println(request2.getRequestUri() + "->" + response3.getCode());
- }
-
- @Override
- public void failed(Exception ex) {
- latch2.countDown();
- System.out.println(request2.getRequestUri() + "->" + ex);
- }
-
- @Override
- public void cancelled() {
- latch2.countDown();
- System.out.println(request2.getRequestUri() + " cancelled");
- }
-
- });
- latch2.await();
-
- }
- ```
-
-
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/android.md b/src/site/markdown/httpcomponents-client-5.6.x/android.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/android.md
rename to src/site/markdown/httpcomponents-client-5.6.x/android.md
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/architecture.md b/src/site/markdown/httpcomponents-client-5.6.x/architecture.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/architecture.md
rename to src/site/markdown/httpcomponents-client-5.6.x/architecture.md
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/configuration.md b/src/site/markdown/httpcomponents-client-5.6.x/configuration.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/configuration.md
rename to src/site/markdown/httpcomponents-client-5.6.x/configuration.md
diff --git a/src/site/markdown/httpcomponents-client-5.6.x/early-hints.md b/src/site/markdown/httpcomponents-client-5.6.x/early-hints.md
index c3380b5..fe24a5a 100644
--- a/src/site/markdown/httpcomponents-client-5.6.x/early-hints.md
+++ b/src/site/markdown/httpcomponents-client-5.6.x/early-hints.md
@@ -1,4 +1,4 @@
- <!--
+<!--
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
@@ -17,11 +17,10 @@
under the License.
-->
-RFC 8297 – 103 Early Hints (async)
+103 Early Hints (async)
==================================
-HttpClient 5.6 adds async support for **RFC 8297 – 103 Early Hints** via a
-callback interface:
+HttpClient 5.6 adds async support for **103 Early Hints** via a callback interface:
- `EarlyHintsListener` – functional interface invoked for each `103` response.
- `HttpAsyncClientBuilder#setEarlyHintsListener(...)` – registers a global
diff --git a/src/site/markdown/httpcomponents-client-5.6.x/index.md b/src/site/markdown/httpcomponents-client-5.6.x/index.md
index da460d9..dd05275 100644
--- a/src/site/markdown/httpcomponents-client-5.6.x/index.md
+++ b/src/site/markdown/httpcomponents-client-5.6.x/index.md
@@ -35,35 +35,45 @@ extend the HTTP protocol for distributed communication.
Documentation
-------------
-1. [Quick Start](quickstart.md) - contains simple, complete examples of request execution with the classic, fluent and
- async APIs.
-1. Examples demonstrating some common as well as more complex use cases
-
- * [HttpClient (classic APIs)](examples.md)
- * [HttpClient (async APIs)](examples-async.md)
- * [HttpClient (reactive APIs)](examples-reactive.md)
- * [HttpClient (observation APIs)](examples-observation.md)
- * [HttpClient (sse APIs)](server-sent-events.md)
-
+1. [Quick Start](quickstart.md) - contains simple, complete examples of request execution
+ with the classic, fluent and async APIs.
+1. [Architecture](architecture.md) - describes HttpClient architecture pronciples such as
+ the layering concept.
1. Guides
- * [Connection management](connection-management.md)
- * [Connection pooling](connection-pooling.md)
+ * [Migration](migration-guide/index.md) - helps choose the best migration path from
+ older version of Apache HttpClient, different i/o models supported by Apache HttpClient
+ or other HTTP clients.
+ * [Configuration](configuration.md) - describes principles of HttpClient configuration.
+ * [Logging](logging.md)
+ * [Connection management](connection-management.md)
+ * [Connection pooling](connection-pooling.md)
+ * [Async content compression / decompression](async-compression.md)
+ * [Android support](android.md)
+ * [Early Hints](early-hints.md)
+ * [Observation](observation.md)
+ * [SCRAM-SHA-256](scram-sha-256.md)
+ * [SPKI pinning TLS strategy](spki-pinning.md)
+
+6. Examples demonstrating some common as well as more complex use cases
+
+ * [HttpClient (classic APIs)](examples.md)
+ * [HttpClient (async APIs)](examples-async.md)
+ * [HttpClient (reactive APIs)](examples-reactive.md)
+ * [HttpClient (observation APIs)](examples-observation.md)
1. Javadocs
- * [HttpClient](./current/httpclient5/apidocs/)
- * [HC Fluent](./current/httpclient5-fluent/apidocs/)
- * [HttpClient Cache](./current/httpclient5-cache/apidocs/)
- * [HttpClient Observation](./current/httpclient5-observation/apidocs/)
- * [HttpClient sse](./current/httpclient5-sse/apidocs/)
+ * [HttpClient](./current/httpclient5/apidocs/)
+ * [HC Fluent](./current/httpclient5-fluent/apidocs/)
+ * [HttpClient Cache](./current/httpclient5-cache/apidocs/)
+ * [HttpClient Observation](./current/httpclient5-observation/apidocs/)
1. API compatibility reports
- * [HttpClient](./current/httpclient5/japicmp.html)
- * [HC Fluent](./current/httpclient5-fluent/japicmp.html)
- * [HttpClient Cache](./current/httpclient5-cache/japicmp.html)
- * [HC Observation](./current/httpclient5-observation/japicmp.html)
- * [HC sse](./current/httpclient5-sse/japicmp.html)
+ * [HttpClient](./current/httpclient5/japicmp.html)
+ * [HC Fluent](./current/httpclient5-fluent/japicmp.html)
+ * [HttpClient Cache](./current/httpclient5-cache/japicmp.html)
+ * [HC Observation](./current/httpclient5-observation/japicmp.html)
Features
--------
@@ -77,22 +87,18 @@ Features
- HTTP state management and cookie support.
- Flexible connection management and pooling with STRICT, LAX and OFFLOCK concurrency policies.
- Optional off-lock disposal for blocking connection pools to move slow graceful closes off hot pool locks.
-- Support for HTTP response caching.
-- Transparent content decompression.
+- Basic, Digest, Bearer, and SCRAM-SHA-256 authentication schemes.
+- Support for HTTP response caching. Pluggable storage backends based on Ehcache, Memcached, Caffeine.
+- Transparent content decompression with deflate, gzip, and optional zstd / brotli codecs.
- Support for Unix domain sockets.
-- Source code is freely available under the Apache License.
- Experimental RFC 9218 prioritization (Priority header & PRIORITY_UPDATE for HTTP/2).
-- Optional observability module [httpclient5-observation)](observation.md) with Micrometer / OpenTelemetry support for request timers/counters,
- I/O byte counters, connection-pool gauges, and DNS/TLS meters for classic and async clients.
-- Optional Caffeine-based cache backend for in-memory HTTP cache storage.
-- Basic, Digest, Bearer, and [SCRAM-SHA-256](scram-sha-256.md) authentication schemes.
-- Async transparent content compression and decompression with `deflate`, `gzip`, and optional `zstd` / `brotli` codecs. See
- [Async content compression & decompression](async-compression.md).
-- Async support for RFC 8297 **103 Early Hints** via a pluggable
- [`EarlyHintsListener`](./current/httpclient5/apidocs/org/apache/hc/client5/http/EarlyHintsListener.html).
-- Optional [SPKI pinning TLS strategy](scram-sha-256.md) (`SpkiPinningClientTlsStrategy`) for host / wildcard public-key pinning.
-- Optional [Server-Sent Events (SSE) module](server-sent-events.md) (`httpclient5-sse`) for consuming long-lived event
+- Optional SPKI pinning TLS strategy for host / wildcard public-key pinning.
+- Async support for 103 Early Hints via a pluggable
+- Optional Observability nodule with Micrometer / OpenTelemetry support for request timers/counters,
+- Optional Server-Sent Events (SSE) module for consuming long-lived event
streams over HTTP/1.1 and HTTP/2 using the async transport.
+- Source code is freely available under the Apache License.
Standards Compliance
@@ -104,7 +110,7 @@ the internet at large:
- [RFC 9110](https://datatracker.ietf.org/doc/html/rfc9110) - HTTP Semantics
- [RFC 9111](https://datatracker.ietf.org/doc/html/rfc9111) - HTTP Caching
- [RFC 9112](https://datatracker.ietf.org/doc/html/rfc9112) - Hypertext Transfer Protocol Version 1.1 (HTTP/1.1)
-- [RFC 9113](https://datatracker.ietf.org/doc/html/rfc9113) - Hypertext Transfer Protocol Version 2 (HTTP/2)
+- [RFC 7540](https://datatracker.ietf.org/doc/html/rfc7540) - Hypertext Transfer Protocol Version 2 (HTTP/2)
- [RFC 7541](https://datatracker.ietf.org/doc/html/rfc7541) - HPACK: Header Compression for HTTP/2
- [RFC 1945](https://datatracker.ietf.org/doc/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0
- [RFC 2396](https://datatracker.ietf.org/doc/html/rfc2396) - Uniform Resource Identifiers (URI): Generic Syntax
@@ -115,5 +121,4 @@ the internet at large:
- [RFC 2817](https://datatracker.ietf.org/doc/html/rfc2817) - Upgrading to TLS Within HTTP/1.1
- [RFC 9218](https://datatracker.ietf.org/doc/html/rfc9218) - Extensible Prioritization Scheme for HTTP
- [RFC 7804](https://datatracker.ietf.org/doc/html/rfc7804) - Salted Challenge Response HTTP Authentication Mechanism
-- [RFC 9218](https://datatracker.ietf.org/doc/html/rfc9218) - Extensible Prioritization Scheme for HTTP *(experimental support: Priority header & PRIORITY_UPDATE for HTTP/2)*
- [RFC 8297](https://datatracker.ietf.org/doc/html/rfc8297) – Early Hints status code
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/logging.md b/src/site/markdown/httpcomponents-client-5.6.x/logging.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/logging.md
rename to src/site/markdown/httpcomponents-client-5.6.x/logging.md
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/migration-guide/index.md b/src/site/markdown/httpcomponents-client-5.6.x/migration-guide/index.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/migration-guide/index.md
rename to src/site/markdown/httpcomponents-client-5.6.x/migration-guide/index.md
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/migration-guide/migration-to-async-http2.md b/src/site/markdown/httpcomponents-client-5.6.x/migration-guide/migration-to-async-http2.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/migration-guide/migration-to-async-http2.md
rename to src/site/markdown/httpcomponents-client-5.6.x/migration-guide/migration-to-async-http2.md
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/migration-guide/migration-to-async-simple.md b/src/site/markdown/httpcomponents-client-5.6.x/migration-guide/migration-to-async-simple.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/migration-guide/migration-to-async-simple.md
rename to src/site/markdown/httpcomponents-client-5.6.x/migration-guide/migration-to-async-simple.md
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/migration-guide/migration-to-async-streaming.md b/src/site/markdown/httpcomponents-client-5.6.x/migration-guide/migration-to-async-streaming.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/migration-guide/migration-to-async-streaming.md
rename to src/site/markdown/httpcomponents-client-5.6.x/migration-guide/migration-to-async-streaming.md
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/migration-guide/migration-to-classic.md b/src/site/markdown/httpcomponents-client-5.6.x/migration-guide/migration-to-classic.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/migration-guide/migration-to-classic.md
rename to src/site/markdown/httpcomponents-client-5.6.x/migration-guide/migration-to-classic.md
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/migration-guide/preparation.md b/src/site/markdown/httpcomponents-client-5.6.x/migration-guide/preparation.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/migration-guide/preparation.md
rename to src/site/markdown/httpcomponents-client-5.6.x/migration-guide/preparation.md
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/related-projects.md b/src/site/markdown/httpcomponents-client-5.6.x/related-projects.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.5.x/related-projects.md
rename to src/site/markdown/httpcomponents-client-5.6.x/related-projects.md
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/examples-reactive.md b/src/site/markdown/httpcomponents-client-5.7.x/index.md
similarity index 57%
rename from src/site/markdown/httpcomponents-client-5.5.x/examples-reactive.md
rename to src/site/markdown/httpcomponents-client-5.7.x/index.md
index 6b04496..ba31db7 100644
--- a/src/site/markdown/httpcomponents-client-5.5.x/examples-reactive.md
+++ b/src/site/markdown/httpcomponents-client-5.7.x/index.md
@@ -17,9 +17,27 @@
under the License.
-->
-HttpClient Examples (Async)
-===========================
+HttpClient Overview
+===================
-- [HTTP exchange with Reactive Streams](https://github.com/apache/httpcomponents-client/tree/5.5.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java)
+Documentation
+-------------
- This example demonstrates a reactive, full-duplex HTTP/1.1 message exchange using RxJava.
+4. Examples demonstrating some common as well as more complex use cases
+
+ * [HttpClient (sse APIs)](server-sent-events.md)
+
+1. Javadocs
+
+ * [HttpClient sse](./current/httpclient5-sse/apidocs/)
+
+1. API compatibility reports
+
+ * [HC sse](./current/httpclient5-sse/japicmp.html)
+
+Features
+--------
+
+- Support for HTTP response caching. Pluggable storage backends based on Ehcache, Memcached, Caffeine.
+- Optional Server-Sent Events (SSE) module for consuming long-lived event
+ streams over HTTP/1.1 and HTTP/2 using the async transport.
\ No newline at end of file
diff --git a/src/site/markdown/httpcomponents-client-5.6.x/server-sent-events.md b/src/site/markdown/httpcomponents-client-5.7.x/server-sent-events.md
similarity index 100%
rename from src/site/markdown/httpcomponents-client-5.6.x/server-sent-events.md
rename to src/site/markdown/httpcomponents-client-5.7.x/server-sent-events.md
diff --git a/src/site/markdown/news.md b/src/site/markdown/news.md
index 56840db..ebdb57d 100644
--- a/src/site/markdown/news.md
+++ b/src/site/markdown/news.md
@@ -20,6 +20,33 @@
HttpComponents Project News
===========================
+###### 22 December 2025 - HttpComponents Client 5.6 GA released
+
+This is the first GA release in the 5.6 release series. It adds several features
+such as transport content decompression and content compression for the async transport,
+support for Unix sockets, experimental support for SCRAM-SHA-256 authentication scheme,
+and Micrometer/OTel observations & metrics.
+
+Notable changes and features included in the 5.6 series:
+
+* Unix domain socket support.
+
+* Support for pluggable content codecs via Commons-Compress in the classic transport.
+ (optional).
+
+* Support for transparent content decompression and content compression with `deflate`,
+ `gzip`, `zstd` (optional), and `brotli` (optional) codecs in the async transport.
+
+* Micrometer/OTel observations & metrics (optinal).
+
+* Off-lock connection disposal by the classic pooling connection manager. Experimental.
+
+* SCRAM-SHA-256 authentication scheme (RFC 7804). Experimental.
+
+* Request Priority support (RFC 9218). Experimental.
+
+* OFFLOCK connection pool concurrency policy. Experimental.
+
###### 22 December 2025 - HttpComponents Client 5.5.2 GA released
This is a maintenance release that fixes incompatibility with the 5.4 branch
@@ -51,7 +78,6 @@ Notable changes and features included in the 5.4 series:
* Improved idle connection validation in the async transport.
-
###### 27 October 2025 - HttpComponents Client 5.6-alpha1 released
This is the first ALPHA release in the 5.6 release series. It adds several features
@@ -59,24 +85,6 @@ such as transport content decompression and content compression for the async tr
support for Unix sockets, experimental support for SCRAM-SHA-256 authentication scheme,
and Micrometer/OTel observations & metrics.
-Notable changes and features included in the 5.6 series:
-
-* Unix domain socket support.
-
-* Support for pluggable content codecs via Commons-Compress in the classic transport.
- (optional).
-
-* Support for transparent content decompression and content compression with `deflate`,
- `gzip`, `zstd` (optional), and `brotli` (optional) codecs in the async transport.
-
-* Micrometer/OTel observations & metrics (optinal).
-
-* Off-lock connection disposal by the classic pooling connection manager. Experimental.
-
-* SCRAM-SHA-256 authentication scheme (RFC 7804). Experimental.
-
-* Request Priority support (RFC 9218). Experimental.
-
###### 13 October 2025 - HttpComponents Core 5.4-alpha1 released
This is the first ALPHA release in the 5.4 release series that improves HTTP/2 protocol
diff --git a/src/site/markdown/status.md b/src/site/markdown/status.md
index 87d08b0..344429c 100644
--- a/src/site/markdown/status.md
+++ b/src/site/markdown/status.md
@@ -23,19 +23,10 @@ HttpComponents Project Status
HttpComponents HttpClient 5.6.x
-------------------------------
-HttpClient 5.6.x branch is the current development branch. The 5.6.x release series improves HTTP/2 protocol support
-by ensuring conformance to the latest HTTP specification (RFC 9113), adds support for Unix domain sockets and
-transparent content decompression for the async transport, also provides experimental SCRAM-SHA-256 authentication
-scheme.
-
-HttpComponents HttpClient 5.5.x
--------------------------------
-
HttpClient 5.5.x branch is considered stable and production ready. It is being actively maintained and supported.
-The 5.5.x release series features an experimental Classic API facade acting as a compatibility bridge between
-the classic I/O client services (based on the standard InputStream / OutputStream model) and the asynchronous
-message transport used internally. This branch also makes it possible for the pooling connection manager to make
-use of HTTP/2 message multiplexing.
+The 5.6.x release series improves HTTP/2 protocol support by ensuring conformance to the latest HTTP specification
+(RFC 9113), adds support for Unix domain sockets and transparent content decompression for the async transport,
+also provides experimental SCRAM-SHA-256 authentication scheme.
HttpComponents HttpCore 5.4.x
-------------------------------
diff --git a/src/site/resources/httpcomponents-client-5.6.x/documentation.links b/src/site/resources/httpcomponents-client-5.6.x/documentation.links
index d57af08..cc5e24e 100644
--- a/src/site/resources/httpcomponents-client-5.6.x/documentation.links
+++ b/src/site/resources/httpcomponents-client-5.6.x/documentation.links
@@ -21,4 +21,5 @@
# links to components in https://hc.apache.org/components/
5.6-alpha1 ../components/httpcomponents-client-5.6.x/5.6-alpha1
-current ../components/httpcomponents-client-5.6.x/5.6-alpha1
+5.6 ../components/httpcomponents-client-5.6.x/5.6
+current ../components/httpcomponents-client-5.6.x/5.6
diff --git a/src/site/site.xml b/src/site/site.xml
index bfb275c..78e0e3e 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -72,30 +72,23 @@ under the License.
<item name="Get Involved" href="get-involved.html"/>
</menu>
<menu name="Components">
- <item name="HttpClient 5.5" collapse="true" href="httpcomponents-client-5.5.x/index.html">
- <item name="Architecture" href="httpcomponents-client-5.5.x/architecture.html"/>
- <item name="Quick Start" href="httpcomponents-client-5.5.x/quickstart.html"/>
- <item name="Configuration Guide" href="httpcomponents-client-5.5.x/configuration.html"/>
- <item name="Examples (Classic)" href="httpcomponents-client-5.5.x/examples.html"/>
- <item name="Examples (Async)" href="httpcomponents-client-5.5.x/examples-async.html"/>
- <item name="Examples (Reactive)" href="httpcomponents-client-5.5.x/examples-reactive.html"/>
- <item name="Migration Guide" collapse="true" href="httpcomponents-client-5.5.x/migration-guide/index.html">
- <item name="Preparation" href="httpcomponents-client-5.5.x/migration-guide/preparation.html"/>
- <item name="Classic" href="httpcomponents-client-5.5.x/migration-guide/migration-to-classic.html"/>
- <item name="Async Simple" href="httpcomponents-client-5.5.x/migration-guide/migration-to-async-simple.html"/>
- <item name="Async Streaming" href="httpcomponents-client-5.5.x/migration-guide/migration-to-async-streaming.html"/>
- <item name="Async HTTP/2 only" href="httpcomponents-client-5.5.x/migration-guide/migration-to-async-http2.html"/>
- </item>
- <item name="Logging Guide" href="httpcomponents-client-5.5.x/logging.html"/>
- <item name="Android" href="httpcomponents-client-5.5.x/android.html"/>
- <item name="Related" href="httpcomponents-client-5.5.x/related-projects.html"/>
- <item name="Download" href="httpcomponents-client-5.5.x/download.html"/>
- </item>
- <item name="HttpClient 5.6 ALPHA" collapse="true" href="httpcomponents-client-5.6.x/index.html">
+ <item name="HttpClient 5.6" collapse="true" href="httpcomponents-client-5.6.x/index.html">
<item name="Quick Start" href="httpcomponents-client-5.6.x/quickstart.html"/>
+ <item name="Architecture" href="httpcomponents-client-5.6.x/architecture.html"/>
+ <item name="Configuration Guide" href="httpcomponents-client-5.6.x/configuration.html"/>
+ <item name="Migration Guide" collapse="true" href="httpcomponents-client-5.6.x/migration-guide/index.html">
+ <item name="Preparation" href="httpcomponents-client-5.6.x/migration-guide/preparation.html"/>
+ <item name="Classic" href="httpcomponents-client-5.6.x/migration-guide/migration-to-classic.html"/>
+ <item name="Async Simple" href="httpcomponents-client-5.6.x/migration-guide/migration-to-async-simple.html"/>
+ <item name="Async Streaming" href="httpcomponents-client-5.6.x/migration-guide/migration-to-async-streaming.html"/>
+ <item name="Async HTTP/2 only" href="httpcomponents-client-5.6.x/migration-guide/migration-to-async-http2.html"/>
+ </item>
+ <item name="Logging Guide" href="httpcomponents-client-5.6.x/logging.html"/>
+ <item name="Android" href="httpcomponents-client-5.6.x/android.html"/>
<item name="Examples (Classic)" href="httpcomponents-client-5.6.x/examples.html"/>
<item name="Examples (Async)" href="httpcomponents-client-5.6.x/examples-async.html"/>
<item name="Examples (Reactive)" href="httpcomponents-client-5.6.x/examples-reactive.html"/>
+ <item name="Related" href="httpcomponents-client-5.6.x/related-projects.html"/>
<item name="Download" href="httpcomponents-client-5.6.x/download.html"/>
</item>
<item name="HttpCore 5.4" collapse="true" href="httpcomponents-core-5.4.x/index.html">
diff --git a/src/site/xdoc/downloads.xml b/src/site/xdoc/downloads.xml
index b0ecdc2..edcf342 100644
--- a/src/site/xdoc/downloads.xml
+++ b/src/site/xdoc/downloads.xml
@@ -64,39 +64,39 @@
<code>sha512</code> link downloads the SHA 512 checksum from the main site.
</p>
- <subsection name="HttpClient 5.5.2 (GA)">
+ <subsection name="HttpClient 5.6 (GA)">
<a href="https://downloads.apache.org/httpcomponents/httpclient/KEYS">KEYS</a>
- <a href="https://downloads.apache.org/httpcomponents/httpclient/RELEASE_NOTES-5.5.x.txt">Release Notes</a>
+ <a href="https://downloads.apache.org/httpcomponents/httpclient/RELEASE_NOTES-5.6.x.txt">Release Notes</a>
<br/>
<p>Binary</p>
<ul>
<li>
- <a href="[preferred]/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.tar.gz">5.5.tar.gz</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.tar.gz.sha512">sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.tar.gz.asc">pgp</a>]
+ <a href="[preferred]/httpcomponents/httpclient/binary/httpcomponents-client-5.6-bin.tar.gz">5.5.tar.gz</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.6-bin.tar.gz.sha512">sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.6-bin.tar.gz.asc">pgp</a>]
</li>
<li>
- <a href="[preferred]/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.zip">5.5.zip</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.zip.sha512">sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.zip.asc">pgp</a>]
+ <a href="[preferred]/httpcomponents/httpclient/binary/httpcomponents-client-5.6-bin.zip">5.5.zip</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.6-bin.zip.sha512">sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.6-bin.zip.asc">pgp</a>]
</li>
</ul>
<p>Source</p>
<ul>
<li>
- <a href="[preferred]/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.tar.gz">5.5.tar.gz</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.tar.gz.sha512">sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.tar.gz.asc">pgp</a>]
+ <a href="[preferred]/httpcomponents/httpclient/source/httpcomponents-client-5.6-src.tar.gz">5.5.tar.gz</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.6-src.tar.gz.sha512">sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.6-src.tar.gz.asc">pgp</a>]
</li>
<li>
- <a href="[preferred]/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.zip">5.5.zip</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.zip.sha512">sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.zip.asc">pgp</a>]
+ <a href="[preferred]/httpcomponents/httpclient/source/httpcomponents-client-5.6-src.zip">5.5.zip</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.6-src.zip.sha512">sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.6-src.zip.asc">pgp</a>]
</li>
</ul>
</subsection>
- <subsection name="HttpCore 5.4">
+ <subsection name="HttpCore 5.4 (GA)">
<a href="https://downloads.apache.org/httpcomponents/httpcore/KEYS">KEYS</a>
<a href="https://downloads.apache.org/httpcomponents/httpcore/RELEASE_NOTES-5.4.x.txt">Release Notes</a>
<br/>
(httpcomponents-website) 04/05: Updated project website for HttpClient 5.5.2 GA release
Posted by ab...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
abernal pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/httpcomponents-website.git
commit 7640167435b709690169aadc66c4a6c29b8c7440
Author: Oleg Kalnichevski <ol...@apache.org>
AuthorDate: Sat Dec 20 14:31:13 2025 +0100
Updated project website for HttpClient 5.5.2 GA release
---
src/site/markdown/news.md | 5 +++++
.../documentation.links | 3 ++-
src/site/xdoc/downloads.xml | 26 +++++++++++-----------
3 files changed, 20 insertions(+), 14 deletions(-)
diff --git a/src/site/markdown/news.md b/src/site/markdown/news.md
index 8996f71..56840db 100644
--- a/src/site/markdown/news.md
+++ b/src/site/markdown/news.md
@@ -20,6 +20,11 @@
HttpComponents Project News
===========================
+###### 22 December 2025 - HttpComponents Client 5.5.2 GA released
+
+This is a maintenance release that fixes incompatibility with the 5.4 branch
+of HttpCore.
+
###### 16 December 2025 - HttpComponents Core 5.4 GA released
This is the first GA release in the 5.4 release series that improves HTTP/2 protocol
diff --git a/src/site/resources/httpcomponents-client-5.5.x/documentation.links b/src/site/resources/httpcomponents-client-5.5.x/documentation.links
index 605dbaa..9e0ec74 100644
--- a/src/site/resources/httpcomponents-client-5.5.x/documentation.links
+++ b/src/site/resources/httpcomponents-client-5.5.x/documentation.links
@@ -23,4 +23,5 @@
5.5-alpha1 ../components/httpcomponents-client-5.5.x/5.5-alpha1
5.5 ../components/httpcomponents-client-5.5.x/5.5
5.5.1 ../components/httpcomponents-client-5.5.x/5.5.1
-current ../components/httpcomponents-client-5.5.x/5.5.1
+5.5.2 ../components/httpcomponents-client-5.5.x/5.5.2
+current ../components/httpcomponents-client-5.5.x/5.5.2
diff --git a/src/site/xdoc/downloads.xml b/src/site/xdoc/downloads.xml
index fab3158..b0ecdc2 100644
--- a/src/site/xdoc/downloads.xml
+++ b/src/site/xdoc/downloads.xml
@@ -64,34 +64,34 @@
<code>sha512</code> link downloads the SHA 512 checksum from the main site.
</p>
- <subsection name="HttpClient 5.5 (GA)">
+ <subsection name="HttpClient 5.5.2 (GA)">
<a href="https://downloads.apache.org/httpcomponents/httpclient/KEYS">KEYS</a>
<a href="https://downloads.apache.org/httpcomponents/httpclient/RELEASE_NOTES-5.5.x.txt">Release Notes</a>
<br/>
<p>Binary</p>
<ul>
<li>
- <a href="[preferred]/httpcomponents/httpclient/binary/httpcomponents-client-5.5-bin.tar.gz">5.5.tar.gz</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5-bin.tar.gz.sha512">sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5-bin.tar.gz.asc">pgp</a>]
+ <a href="[preferred]/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.tar.gz">5.5.tar.gz</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.tar.gz.sha512">sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.tar.gz.asc">pgp</a>]
</li>
<li>
- <a href="[preferred]/httpcomponents/httpclient/binary/httpcomponents-client-5.5-bin.zip">5.5.zip</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5-bin.zip.sha512">sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5-bin.zip.asc">pgp</a>]
+ <a href="[preferred]/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.zip">5.5.zip</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.zip.sha512">sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/binary/httpcomponents-client-5.5.2-bin.zip.asc">pgp</a>]
</li>
</ul>
<p>Source</p>
<ul>
<li>
- <a href="[preferred]/httpcomponents/httpclient/source/httpcomponents-client-5.5-src.tar.gz">5.5.tar.gz</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5-src.tar.gz.sha512">sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5-src.tar.gz.asc">pgp</a>]
+ <a href="[preferred]/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.tar.gz">5.5.tar.gz</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.tar.gz.sha512">sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.tar.gz.asc">pgp</a>]
</li>
<li>
- <a href="[preferred]/httpcomponents/httpclient/source/httpcomponents-client-5.5-src.zip">5.5.zip</a>
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5-src.zip.sha512">sha512</a>]
- [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5-src.zip.asc">pgp</a>]
+ <a href="[preferred]/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.zip">5.5.zip</a>
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.zip.sha512">sha512</a>]
+ [<a href="https://downloads.apache.org/httpcomponents/httpclient/source/httpcomponents-client-5.5.2-src.zip.asc">pgp</a>]
</li>
</ul>
</subsection>