apache · ok2c · Jan 20, 2026
diff --git a/httpclient5/src/main/java/org/apache/hc/client5/http/impl/async/H2AsyncClientBuilder.java b/httpclient5/src/main/java/org/apache/hc/client5/http/impl/async/H2AsyncClientBuilder.java
@@ -70,7 +70,6 @@
 import org.apache.hc.client5.http.protocol.RequestExpectContinue;
 import org.apache.hc.client5.http.protocol.ResponseProcessCookies;
 import org.apache.hc.client5.http.routing.HttpRoutePlanner;
-import org.apache.hc.client5.http.ssl.DefaultClientTlsStrategy;
 import org.apache.hc.core5.annotation.Experimental;
 import org.apache.hc.core5.annotation.Internal;
 import org.apache.hc.core5.concurrent.DefaultThreadFactory;
@@ -201,7 +200,7 @@ private ExecInterceptorEntry(
     private boolean evictIdleConnections;
     private TimeValue maxIdleTime;
 
-    private boolean systemProperties;
+    private boolean ignoreSystemProperties;
     private boolean automaticRetriesDisabled;
     private boolean redirectHandlingDisabled;
     private boolean cookieManagementDisabled;
@@ -669,13 +668,24 @@ public final H2AsyncClientBuilder setDefaultConnectionConfig(final ConnectionCon
     }
 
     /**
-     * Use system properties when creating and configuring default
-     * implementations.
+     * Use system properties when creating new instances.
      *
      * @return this instance.
      */
     public final H2AsyncClientBuilder useSystemProperties() {
-        this.systemProperties = true;
+        this.ignoreSystemProperties = false;
+        return this;
+    }
+
+    /**
+     * Ignore system properties when creating new instances.
+     *
+     * @return this instance.
+     *
+     * @since 5.7
+     */
+    public final H2AsyncClientBuilder ignoreSystemProperties() {
+        this.ignoreSystemProperties = true;
         return this;
     }
 
@@ -964,24 +974,15 @@ public CloseableHttpAsyncClient build() {
 
         CredentialsProvider credentialsProviderCopy = this.credentialsProvider;
         if (credentialsProviderCopy == null) {
-            if (systemProperties) {
-                credentialsProviderCopy = new SystemDefaultCredentialsProvider();
-            } else {
+            if (ignoreSystemProperties) {
                 credentialsProviderCopy = new BasicCredentialsProvider();
-            }
-        }
-
-        TlsStrategy tlsStrategyCopy = this.tlsStrategy;
-        if (tlsStrategyCopy == null) {
-            if (systemProperties) {
-                tlsStrategyCopy = DefaultClientTlsStrategy.createSystemDefault();
             } else {
-                tlsStrategyCopy = DefaultClientTlsStrategy.createDefault();
+                credentialsProviderCopy = new SystemDefaultCredentialsProvider();
             }
         }
 
         final MultihomeConnectionInitiator connectionInitiator = new MultihomeConnectionInitiator(ioReactor, dnsResolver);
-        final InternalH2ConnPool connPool = new InternalH2ConnPool(connectionInitiator, host -> null, tlsStrategyCopy);
+        final InternalH2ConnPool connPool = new InternalH2ConnPool(connectionInitiator, host -> null, tlsStrategy);
         connPool.setConnectionConfigResolver(connectionConfigResolver);
 
         List<Closeable> closeablesCopy = closeables != null ? new ArrayList<>(closeables) : null;

diff --git a/httpclient5/src/main/java/org/apache/hc/client5/http/impl/async/HttpAsyncClientBuilder.java b/httpclient5/src/main/java/org/apache/hc/client5/http/impl/async/HttpAsyncClientBuilder.java
@@ -252,7 +252,7 @@ private ExecInterceptorEntry(
     private boolean evictIdleConnections;
     private TimeValue maxIdleTime;
 
-    private boolean systemProperties;
+    private boolean ignoreSystemProperties;
     private boolean automaticRetriesDisabled;
     private boolean redirectHandlingDisabled;
     private boolean cookieManagementDisabled;
@@ -776,13 +776,24 @@ public final HttpAsyncClientBuilder setDefaultRequestConfig(final RequestConfig
     }
 
     /**
-     * Use system properties when creating and configuring default
-     * implementations.
+     * Use system properties when creating new instances.
      *
      * @return this instance.
      */
     public final HttpAsyncClientBuilder useSystemProperties() {
-        this.systemProperties = true;
+        this.ignoreSystemProperties = false;
+        return this;
+    }
+
+    /**
+     * Ignore system properties when creating new instances.
+     *
+     * @return this instance.
+     *
+     * @since 5.7
+     */
+    public final HttpAsyncClientBuilder ignoreSystemProperties() {
+        this.ignoreSystemProperties = true;
         return this;
     }
 
@@ -1011,8 +1022,8 @@ public CloseableHttpAsyncClient build() {
         AsyncClientConnectionManager connManagerCopy = this.connManager;
         if (connManagerCopy == null) {
             final PoolingAsyncClientConnectionManagerBuilder connectionManagerBuilder = PoolingAsyncClientConnectionManagerBuilder.create();
-            if (systemProperties) {
-                connectionManagerBuilder.useSystemProperties();
+            if (ignoreSystemProperties) {
+                connectionManagerBuilder.ignoreSystemProperties();
             }
             connManagerCopy = connectionManagerBuilder.build();
         }
@@ -1166,11 +1177,11 @@ public CloseableHttpAsyncClient build() {
                 routePlannerCopy = new DefaultProxyRoutePlanner(proxy, schemePortResolverCopy);
             } else if (this.proxySelector != null) {
                 routePlannerCopy = new SystemDefaultRoutePlanner(schemePortResolverCopy, this.proxySelector);
-            } else if (systemProperties) {
+            } else if (ignoreSystemProperties) {
+                routePlannerCopy = new DefaultRoutePlanner(schemePortResolverCopy);
+            } else {
                 final ProxySelector defaultProxySelector = ProxySelector.getDefault();
                 routePlannerCopy = new SystemDefaultRoutePlanner(schemePortResolverCopy, defaultProxySelector);
-            } else {
-                routePlannerCopy = new DefaultRoutePlanner(schemePortResolverCopy);
             }
         }
 
@@ -1276,10 +1287,10 @@ public CloseableHttpAsyncClient build() {
 
         CredentialsProvider credentialsProviderCopy = this.credentialsProvider;
         if (credentialsProviderCopy == null) {
-            if (systemProperties) {
-                credentialsProviderCopy = new SystemDefaultCredentialsProvider();
-            } else {
+            if (ignoreSystemProperties) {
                 credentialsProviderCopy = new BasicCredentialsProvider();
+            } else {
+                credentialsProviderCopy = new SystemDefaultCredentialsProvider();
             }
         }
 

diff --git a/httpclient5/src/main/java/org/apache/hc/client5/http/impl/async/HttpAsyncClients.java b/httpclient5/src/main/java/org/apache/hc/client5/http/impl/async/HttpAsyncClients.java
@@ -81,17 +81,33 @@ public static HttpAsyncClientBuilder custom() {
 
     /**
      * Creates {@link CloseableHttpAsyncClient} instance with default configuration.
+     *
+     * @deprecated Use {@link #create()}
      */
+    @Deprecated
     public static CloseableHttpAsyncClient createDefault() {
         return HttpAsyncClientBuilder.create().build();
     }
 
     /**
      * Creates {@link CloseableHttpAsyncClient} instance with default
      * configuration and system properties.
+     *
+     * @deprecated Use {@link #create()}
      */
+    @Deprecated
     public static CloseableHttpAsyncClient createSystem() {
-        return HttpAsyncClientBuilder.create().useSystemProperties().build();
+        return HttpAsyncClientBuilder.create().build();
+    }
+
+    /**
+     * Creates {@link CloseableHttpAsyncClient} instance with default
+     * configuration and system properties.
+     *
+     * @since 5.7
+     */
+    public static CloseableHttpAsyncClient create() {
+        return HttpAsyncClientBuilder.create().build();
     }
 
     /**
@@ -116,7 +132,7 @@ public static CloseableHttpAsyncClient createHttp2Default() {
      * system properties optimized for HTTP/2 protocol and message multiplexing.
      */
     public static CloseableHttpAsyncClient createHttp2System() {
-        return H2AsyncClientBuilder.create().useSystemProperties().build();
+        return H2AsyncClientBuilder.create().build();
     }
 
     private static HttpProcessor createMinimalProtocolProcessor() {
@@ -325,7 +341,7 @@ public static MinimalH2AsyncClient createHttp2Minimal(
     public static MinimalH2AsyncClient createHttp2Minimal(
             final H2Config h2Config,
             final IOReactorConfig ioReactorConfig) {
-        return createHttp2Minimal(h2Config, ioReactorConfig, DefaultClientTlsStrategy.createDefault());
+        return createHttp2Minimal(h2Config, ioReactorConfig, DefaultClientTlsStrategy.create());
     }
 
     /**

diff --git a/httpclient5/src/main/java/org/apache/hc/client5/http/impl/classic/HttpClientBuilder.java b/httpclient5/src/main/java/org/apache/hc/client5/http/impl/classic/HttpClientBuilder.java
@@ -225,14 +225,13 @@ private ExecInterceptorEntry(
     private boolean evictIdleConnections;
     private TimeValue maxIdleTime;
 
-    private boolean systemProperties;
+    private boolean ignoreSystemProperties;
     private boolean redirectHandlingDisabled;
     private boolean automaticRetriesDisabled;
     private boolean contentCompressionDisabled;
     private boolean cookieManagementDisabled;
     private boolean authCachingDisabled;
     private boolean connectionStateDisabled;
-    private boolean defaultUserAgentDisabled;
     private ProxySelector proxySelector;
 
     private boolean tlsRequired;
@@ -732,13 +731,24 @@ public final HttpClientBuilder setDefaultRequestConfig(final RequestConfig confi
     }
 
     /**
-     * Use system properties when creating and configuring default
-     * implementations.
+     * Use system properties when creating new instances.
      *
      * @return this instance.
      */
     public final HttpClientBuilder useSystemProperties() {
-        this.systemProperties = true;
+        this.ignoreSystemProperties = false;
+        return this;
+    }
+
+    /**
+     * Ignore system properties when creating new instances.
+     *
+     * @return this instance.
+     *
+     * @since 5.7
+     */
+    public final HttpClientBuilder ignoreSystemProperties() {
+        this.ignoreSystemProperties = true;
         return this;
     }
 
@@ -798,9 +808,11 @@ public final HttpClientBuilder evictIdleConnections(final TimeValue maxIdleTime)
      *
      * @return this instance.
      * @since 4.5.7
+     *
+     * @deprecated Do not use.
      */
+    @Deprecated
     public final HttpClientBuilder disableDefaultUserAgent() {
-        this.defaultUserAgentDisabled = true;
         return this;
     }
 
@@ -883,8 +895,8 @@ public CloseableHttpClient build() {
         HttpClientConnectionManager connManagerCopy = this.connManager;
         if (connManagerCopy == null) {
             final PoolingHttpClientConnectionManagerBuilder connectionManagerBuilder = PoolingHttpClientConnectionManagerBuilder.create();
-            if (systemProperties) {
-                connectionManagerBuilder.useSystemProperties();
+            if (ignoreSystemProperties) {
+                connectionManagerBuilder.ignoreSystemProperties();
             }
             connManagerCopy = connectionManagerBuilder.build();
         }
@@ -1039,11 +1051,11 @@ public CloseableHttpClient build() {
                 routePlannerCopy = new DefaultProxyRoutePlanner(proxy, schemePortResolverCopy);
             } else if (this.proxySelector != null) {
                 routePlannerCopy = new SystemDefaultRoutePlanner(schemePortResolverCopy, this.proxySelector);
-            } else if (systemProperties) {
+            } else if (ignoreSystemProperties) {
+                routePlannerCopy = new DefaultRoutePlanner(schemePortResolverCopy);
+            } else {
                 final ProxySelector defaultProxySelector = ProxySelector.getDefault();
                 routePlannerCopy = new SystemDefaultRoutePlanner(schemePortResolverCopy, defaultProxySelector);
-            } else {
-                routePlannerCopy = new DefaultRoutePlanner(schemePortResolverCopy);
             }
         }
 
@@ -1118,10 +1130,10 @@ public CloseableHttpClient build() {
 
         CredentialsProvider defaultCredentialsProvider = this.credentialsProvider;
         if (defaultCredentialsProvider == null) {
-            if (systemProperties) {
-                defaultCredentialsProvider = new SystemDefaultCredentialsProvider();
-            } else {
+            if (ignoreSystemProperties) {
                 defaultCredentialsProvider = new BasicCredentialsProvider();
+            } else {
+                defaultCredentialsProvider = new SystemDefaultCredentialsProvider();
             }
         }
 

diff --git a/httpclient5/src/main/java/org/apache/hc/client5/http/impl/classic/HttpClients.java b/httpclient5/src/main/java/org/apache/hc/client5/http/impl/classic/HttpClients.java
@@ -52,17 +52,33 @@ public static HttpClientBuilder custom() {
     /**
      * Creates {@link CloseableHttpClient} instance with default
      * configuration.
+     *
+     * @deprecated Use {@link #create()}
      */
+    @Deprecated
     public static CloseableHttpClient createDefault() {
         return HttpClientBuilder.create().build();
     }
 
     /**
      * Creates {@link CloseableHttpClient} instance with default
      * configuration based on system properties.
+     *
+     * @deprecated Use {@link #create()}
      */
+    @Deprecated
     public static CloseableHttpClient createSystem() {
-        return HttpClientBuilder.create().useSystemProperties().build();
+        return HttpClientBuilder.create().build();
+    }
+
+    /**
+     * Creates {@link CloseableHttpClient} instance with default
+     * configuration based on system properties.
+     *
+     * @since 5.7
+     */
+    public static CloseableHttpClient create() {
+        return HttpClientBuilder.create().build();
     }
 
     /**

diff --git a/...t5/src/main/java/org/apache/hc/client5/http/impl/io/BasicHttpClientConnectionManager.java b/...t5/src/main/java/org/apache/hc/client5/http/impl/io/BasicHttpClientConnectionManager.java
@@ -206,7 +206,7 @@ public BasicHttpClientConnectionManager(
     public BasicHttpClientConnectionManager() {
         this(new DefaultHttpClientConnectionOperator(null, null,
                 RegistryBuilder.<TlsSocketStrategy>create()
-                        .register(URIScheme.HTTPS.id, DefaultClientTlsStrategy.createDefault())
+                        .register(URIScheme.HTTPS.id, DefaultClientTlsStrategy.create())
                         .build()),
                 null);
     }

diff --git a/.../src/main/java/org/apache/hc/client5/http/impl/io/PoolingHttpClientConnectionManager.java b/.../src/main/java/org/apache/hc/client5/http/impl/io/PoolingHttpClientConnectionManager.java
@@ -132,7 +132,7 @@ public class PoolingHttpClientConnectionManager
     public PoolingHttpClientConnectionManager() {
         this(new DefaultHttpClientConnectionOperator(null, null,
                 RegistryBuilder.<TlsSocketStrategy>create()
-                    .register(URIScheme.HTTPS.id, DefaultClientTlsStrategy.createDefault())
+                    .register(URIScheme.HTTPS.id, DefaultClientTlsStrategy.create())
                     .build()),
                 PoolConcurrencyPolicy.STRICT,
                 PoolReusePolicy.LIFO,