Cronet: a framework to provide alternative Cronet implementations

components/cronet/android/api/src/org/chromium/net/ExperimentalCronetEngine.java

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 package org.chromium.net;
 
 import android.content.Context;
 import android.support.annotation.VisibleForTesting;
 
 import java.io.IOException;
 import java.net.Proxy;
@@ skipping 71 matching lines @@
          *                {@link Builder} to retrieve the application
          *                context. A reference to only the application
          *                context will be kept, so as to avoid extending
          *                the lifetime of {@code context} unnecessarily.
          */
         public Builder(Context context) {
             super(context);
         }
 
         /**
+         * Constructs {@link Builder} with a given delegate that provides the actual implementation
+         * of the {@code Builder} methods. This constructor is used only by the internal
+         * implementation.
+         *
+         * @param builderDelegate delegate that provides the actual implementation.
+         *
+         * {@hide}
+         */
+        public Builder(ICronetEngineBuilder builderDelegate) {
+            super(builderDelegate);
+        }
+
+        /**
          * Enables the network quality estimator, which collects and reports
          * measurements of round trip time (RTT) and downstream throughput at
          * various layers of the network stack. After enabling the estimator,
          * listeners of RTT and throughput can be added with
          * {@link #addRttListener} and {@link #addThroughputListener} and
          * removed with {@link #removeRttListener} and
          * {@link #removeThroughputListener}. The estimator uses memory and CPU
          * only when enabled.
          * @param value {@code true} to enable network quality estimator,
          *            {@code false} to disable.
@@ skipping 29 matching lines @@
          * @return the builder to facilitate chaining.
          */
         public Builder setDataReductionProxyOptions(
                 String primaryProxy, String fallbackProxy, String secureProxyCheckUrl) {
             mBuilderDelegate.setDataReductionProxyOptions(
                     primaryProxy, fallbackProxy, secureProxyCheckUrl);
             return this;
         }
 
         /**
-         * Sets whether the resulting {@link CronetEngine} uses an
-         * implementation based on the system's
-         * {@link java.net.HttpURLConnection} implementation, or if this is
-         * only done as a backup if the native implementation fails to load.
-         * Defaults to disabled.
-         * @param value {@code true} makes the resulting {@link CronetEngine}
-         *              use an implementation based on the system's
-         *              {@link java.net.HttpURLConnection} implementation
-         *              without trying to load the native implementation.
-         *              {@code false} makes the resulting {@code CronetEngine}
-         *              use the native implementation, or if that fails to load,
-         *              falls back to an implementation based on the system's
-         *              {@link java.net.HttpURLConnection} implementation.
-         * @return the builder to facilitate chaining.
-         */
-        public Builder enableLegacyMode(boolean value) {
-            mBuilderDelegate.enableLegacyMode(value);
-            return this;
-        }
-
-        /**
          * Enables
          * <a href="https://developer.chrome.com/multidevice/data-compression">Data
          * Reduction Proxy</a>. Defaults to disabled.
          * @param key key to use when authenticating with the proxy.
          * @return the builder to facilitate chaining.
          */
         public Builder enableDataReductionProxy(String key) {
             mBuilderDelegate.enableDataReductionProxy(key);
             return this;
         }
@@ skipping 271 matching lines @@
      * {@link #CONNECTION_METRIC_UNKNOWN} if the value is
      * unavailable. This must be called after
      * {@link Builder#enableNetworkQualityEstimator}, and will
      * throw an exception otherwise.
      * @return Estimate of the downstream throughput in kilobits per second.
      */
     public int getDownstreamThroughputKbps() {
         return CONNECTION_METRIC_UNKNOWN;
     }
 }