[camel] branch CAMEL-18995/upgrade-httpcomponents-5 updated: CAMEL-18995: Add Migration note about camel-http

[nf...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

nfilotto pushed a commit to branch CAMEL-18995/upgrade-httpcomponents-5
in repository https://gitbox.apache.org/repos/asf/camel.git


The following commit(s) were added to refs/heads/CAMEL-18995/upgrade-httpcomponents-5 by this push:
     new 0b57f64f86c CAMEL-18995: Add Migration note about camel-http
0b57f64f86c is described below

commit 0b57f64f86c89124eecdd64e323a5d070c9e5349
Author: Nicolas Filotto <nf...@talend.com>
AuthorDate: Fri Mar 17 13:18:31 2023 +0100

    CAMEL-18995: Add Migration note about camel-http
---
 .../modules/ROOT/pages/camel-4-migration-guide.adoc           | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/user-manual/modules/ROOT/pages/camel-4-migration-guide.adoc b/docs/user-manual/modules/ROOT/pages/camel-4-migration-guide.adoc
index 4510bd7c1e2..cb5fd0b7e2b 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4-migration-guide.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4-migration-guide.adoc
@@ -153,3 +153,14 @@ The `keyType` parameter has been removed. The Key for the cache will now be only
 
 The underlying `hapi-fhir` library has been upgraded from 4.2.0 to 6.2.4. Only the `Delete` API method has changed and now returns `ca.uhn.fhir.rest.api.MethodOutcome` instead of `org.hl7.fhir.instance.model.api.IBaseOperationOutcome`. See https://hapifhir.io/hapi-fhir/blog/ for a more detailed list of underlying changes (only the hapi-fhir client is used in Camel).
 
+=== camel-http
+
+The component has been upgraded to use Apache HttpComponents v5 which has an impact on how the underlying client is configured. There are 5 different
+timeouts (`connectionRequestTimeout`, `connectTimeout`, `socketTimeout`, `soTimeout` and `responseTimeout`) instead of initially 3
+(`connectionRequestTimeout`, `connectTimeout` and `socketTimeout`) and their default values have changed for some of them so please refer to the documentation
+for more details.
+
+There is also a noticeable behavior change regarding the `socketTimeout`, it is now needed to configure it with the option `soTimeout` to get the previous behavior.
+
+Finally, the options `connectTimeout` and `socketTimeout` along with any parameters included into `SocketConfig` and `ConnectionConfig`, need to be prefixed by `httpConnection.`,
+the rest of the parameters including those defined into `HttpClientBuilder` and `RequestConfig` still need to be prefixed by `httpClient.` like before.