add documentation about setting a specific HTTP protocol version

Author: jenschude

commercetools/internal-docs/build.gradle

@@ -5,13 +5,15 @@ dependencies {
     implementation project(":commercetools:commercetools-http-client")
     implementation project(":commercetools:commercetools-okhttp-client4")
     implementation project(":commercetools:commercetools-apachehttp-client")
+    implementation project(":commercetools:commercetools-reactornetty-client")
     implementation project(":commercetools:commercetools-sdk-compat-v1")
     implementation project(":commercetools:commercetools-graphql-api")
     implementation project(":commercetools:commercetools-monitoring-newrelic")
     implementation project(":commercetools:commercetools-monitoring-datadog")
 
     testImplementation ctsdkv1.client version ctsdkv1.version
     implementation ctsdkv1.models version ctsdkv1.version
+    testImplementation project(":commercetools:commercetools-javanet-client")
 
     testImplementation commons.io version commons.io_version
 

commercetools/internal-docs/src/main/java/com/commercetools/docs/meta/ClientTuning.java

@@ -65,6 +65,14 @@
  * <p>The third option is to use the timeout functionality of the futures</p>
  *
  * {@include.example example.ExamplesTest#timeoutFuture()}
+ *
+ * <h3 id=http-version>HTTP protocol version</h3>
+ *
+ * <p>In case it's needed so specify a specific HTTP protocol version this can be done through the HTTP client package itself.</p>
+ *
+ * {@include.example example.ExamplesTest#httpVersion()}
+ *
+ * <p>The AsyncHttpClient and OkHttp packages use HTTP1.1 by default.</p>
  */
 public class ClientTuning {
 }

commercetools/internal-docs/src/test/java/example/ExamplesTest.java

@@ -8,6 +8,7 @@
 
 import java.net.InetSocketAddress;
 import java.net.Proxy;
+import java.net.http.HttpClient;
 import java.time.Duration;
 import java.util.Arrays;
 import java.util.Collections;
@@ -35,6 +36,8 @@
 import com.commercetools.api.models.project.Project;
 import com.commercetools.api.models.tax_category.TaxCategoryPagedQueryResponse;
 import com.commercetools.http.apachehttp.CtApacheHttpClient;
+import com.commercetools.http.javanet.CtJavaNetHttpClient;
+import com.commercetools.http.netty.CtNettyHttpClient;
 import com.commercetools.http.okhttp4.CtOkHttp4Client;
 
 import io.vrap.rmf.base.client.*;
@@ -43,13 +46,15 @@
 
 import org.apache.commons.lang3.tuple.Pair;
 import org.apache.hc.client5.http.config.RequestConfig;
+import org.apache.hc.core5.http2.HttpVersionPolicy;
 import org.apache.hc.core5.util.Timeout;
 import org.assertj.core.api.Assertions;
 import org.junit.jupiter.api.Test;
 import org.slf4j.event.Level;
 
 import dev.failsafe.Failsafe;
 import dev.failsafe.FailsafeExecutor;
+import reactor.netty.http.HttpProtocol;
 
 public class ExamplesTest {
 
@@ -623,4 +628,10 @@ public void mdcProjectApiRoot() {
         ProjectApiRoot globalRoot = ProjectApiRoot.of("test");
         ProjectApiRoot apiRoot = ProjectApiRoot.withContext(globalRoot, new MDCContext());
     }
+
+    public void httpVersion() {
+        CtApacheHttpClient apacheHttpClient = new CtApacheHttpClient(HttpVersionPolicy.FORCE_HTTP_1);
+        CtNettyHttpClient nettyHttpClient = new CtNettyHttpClient(HttpProtocol.HTTP11);
+        CtJavaNetHttpClient javaNetHttpClient = new CtJavaNetHttpClient(HttpClient.Version.HTTP_1_1);
+    }
 }