CronetEngine

public static final int ACTIVE_REQUEST_COUNT_UNKNOWN = -1

Значение счетчика активных запросов неизвестно.

public static final int CONNECTION_METRIC_UNKNOWN = -1

Значение метрики соединения неизвестно.

public static final int EFFECTIVE_CONNECTION_TYPE_2G = 3

По оценкам, эффективный тип подключения — 2G.

public static final int EFFECTIVE_CONNECTION_TYPE_3G = 4

По оценкам, эффективный тип подключения — 3G.

public static final int EFFECTIVE_CONNECTION_TYPE_4G = 5

По оценкам, эффективный тип подключения — 4G.

public static final int EFFECTIVE_CONNECTION_TYPE_OFFLINE = 1

Устройство отключено от сети.

public static final int EFFECTIVE_CONNECTION_TYPE_SLOW_2G = 2

Оценка эффективного типа соединения показывает медленный 2G.

public static final int EFFECTIVE_CONNECTION_TYPE_UNKNOWN = 0

Оценка эффективного типа соединения неизвестна.

public static final long UNBIND_NETWORK_HANDLE = -1

Значение, которое будет использоваться для отмены любой предыдущей сетевой привязки.

public void addRequestFinishedListener(RequestFinishedInfo.Listener listener)

Регистрирует обработчик событий, который вызывается после завершения каждого запроса с информацией о запросе.

Слушатель вызывается для объекта java.util.concurrent.Executor , предоставленного слушателем.

public void addRttListener(NetworkQualityRttListener listener)

Регистрирует обработчик событий, который вызывается всякий раз, когда оценщик качества сети фиксирует время кругового пути. Этот обработчик должен вызываться после enableNetworkQualityEstimator , в противном случае — генерировать исключение. Время кругового пути может записываться на различных уровнях сетевого стека, включая TCP, QUIC и уровень запроса URL. Обработчик событий вызывается для объекта java.util.concurrent.Executor , переданного в enableNetworkQualityEstimator .

public void addThroughputListener(NetworkQualityThroughputListener listener)

Регистрирует слушатель, который вызывается всякий раз, когда оценщик качества сети фиксирует выборочное измерение пропускной способности. Этот вызов должен быть выполнен после enableNetworkQualityEstimator . Наблюдения за пропускной способностью вычисляются путем измерения количества байтов, прочитанных через активный сетевой интерфейс в моменты, когда получен хотя бы один ответ на URL-адрес. Слушатель вызывается для объекта java.util.concurrent.Executor , переданного в enableNetworkQualityEstimator .

public void bindToNetwork(long networkHandle)

Привязывает движок к указанному сетевому дескриптору. Все запросы, созданные через этот движок, будут использовать сеть, связанную с этим дескриптором. Если эта сеть отключается, все запросы завершатся с ошибкой; точная ошибка будет зависеть от стадии обработки запроса в момент отключения сети. Сетевые дескрипторы можно получить с помощью Network#getNetworkHandle . Доступно только начиная с Android Marshmallow.

public void configureNetworkQualityEstimatorForTesting(
    boolean useLocalHostRequests,
    boolean useSmallerResponses,
    boolean disableOfflineCheck
)

Настраивает средство оценки качества сети для тестирования. Этот вызов необходимо выполнить до добавления слушателей времени кругового пути и пропускной способности, а также после включения средства оценки качества сети.

public abstract URLStreamHandlerFactory createURLStreamHandlerFactory()

Создает объект URLStreamHandlerFactory для обработки HTTP и HTTPS-трафика. Экземпляр этого класса можно установить с помощью setURLStreamHandlerFactory таким образом, по умолчанию для всех запросов, создаваемых через openConnection, будет использоваться этот CronetEngine.

Cronet не использует некоторые функции HTTP, предоставляемые системой:

• HTTP-кэш устанавливается с помощью HttpResponseCache.install()
• метод HTTP-аутентификации, установленный с помощью setDefault
• хранилище HTTP-cookie, установленное с помощью setDefault

Хотя Cronet поддерживает и поощряет запросы с использованием протокола HTTPS, Cronet не предоставляет поддержку API HttpsURLConnection . Отсутствие поддержки также включает в себя невозможность использования некоторых функций HTTPS, предоставляемых системой:

• Верификатор имени хоста HTTPS, устанавливаемый через HttpsURLConnection.setDefaultHostnameVerifier()
• Фабрика HTTPS-сокетов устанавливается с помощью HttpsURLConnection.setDefaultSSLSocketFactory()

public int getActiveRequestCount()

Возвращает количество активных запросов.

Запрос становится "активным" в методе UrlRequest.start(), если этот метод не вызывает исключение. Он становится неактивным, когда все коллбэки возвращают управление и в будущем невозможно запустить дополнительные коллбэки. На практике это означает, что запрос становится неактивным после того, как метод onSucceeded/onCanceled/onFailed вернет управление и все обработчики завершения запроса вернут управление. Для получения дополнительной информации см. жизненный цикл запросов Cronet .

public int getDownstreamThroughputKbps()

Возвращает оценку пропускной способности нисходящего потока (в килобитах в секунду), вычисленную оценщиком качества сети. Если значение недоступно, установите значение CONNECTION_METRIC_UNKNOWN . Этот метод необходимо вызывать после enableNetworkQualityEstimator , в противном случае будет сгенерировано исключение.

public int getEffectiveConnectionType()

Возвращает оценку эффективного типа соединения, вычисленную с помощью оценщика качества сети. Вызовите enableNetworkQualityEstimator , чтобы начать вычисление этого значения.

public int getHttpRttMs()

Возвращает оценку времени кругового обхода HTTP (в миллисекундах), вычисленную оценщиком качества сети. Если значение недоступно, установите значение CONNECTION_METRIC_UNKNOWN . Этот метод необходимо вызывать после enableNetworkQualityEstimator , в противном случае будет сгенерировано исключение.

public int getTransportRttMs()

Возвращает оценку времени кругового обхода (в миллисекундах), вычисленную оценщиком качества сети. Если значение недоступно, установите значение CONNECTION_METRIC_UNKNOWN . Этот метод необходимо вызывать после enableNetworkQualityEstimator , в противном случае будет сгенерировано исключение.

public abstract UrlRequest.Builder newUrlRequestBuilder(
    String url,
    UrlRequest.Callback callback,
    Executor executor
)

Создаёт конструктор для UrlRequest . Все обратные вызовы для сгенерированных объектов UrlRequest будут вызываться в потоках executor . executor не должен запускать задачи в потоке, вызывающем execute чтобы предотвратить блокировку сетевых операций и возникновение исключений во время завершения работы.

public abstract URLConnection openConnection(URL url)

Устанавливает новое соединение с ресурсом, указанным в URL url .

Примечание: реализация java.net.HttpURLConnection в Cronet имеет определенные ограничения, подробности см. createURLStreamHandlerFactory .

public void removeRequestFinishedListener(RequestFinishedInfo.Listener listener)

Удаляет обработчик завершенного запроса.

public void removeRttListener(NetworkQualityRttListener listener)

Удаляет слушатель времени кругового пути, если он ранее был зарегистрирован с помощью addRttListener . Этот метод следует вызывать после добавления NetworkQualityRttListener , чтобы прекратить получение наблюдений.

public void removeThroughputListener(NetworkQualityThroughputListener listener)

Удаляет слушатель пропускной способности. Этот метод следует вызывать после добавления NetworkQualityThroughputListener с помощью addThroughputListener , чтобы прекратить получение наблюдений.

public abstract void shutdown()

При отсутствии активных запросов CronetEngine отключает его, в противном случае генерирует исключение.

Вызов невозможен в сетевом потоке — в потоке, в котором Cronet вызывает Executor (который отличается от потока, в котором Executor вызывает обратные вызовы). Может блокировать выполнение до тех пор, пока не будут очищены все ресурсы CronetEngine .

public void startNetLogToDisk(String dirPath, boolean logAll, int maxSize)

Запускает запись логов NetLog в указанный каталог с ограниченным размером. NetLog будет содержать события, генерируемые всеми работающими CronetEngines. NetLog полезен для отладки. После остановки записи логов stopNetLog данные будут записаны в файл netlog.json в dirPath . Если запись логов прервана, вы можете вручную объединить файлы, находящиеся в подкаталоге .inprogress, используя: https://chromium.googlesource.com/chromium/src/+/main/net/tools/stitch_net_log_files.py. Журнал можно просмотреть в браузере Chrome, перейдя по адресу chrome://net-internals/#import.

public abstract void startNetLogToFile(String fileName, boolean logAll)

Запускает запись логов NetLog в файл. Файл NetLog будет содержать события, генерируемые всеми работающими устройствами CronetEngines. Файл NetLog полезен для отладки. Файл можно просмотреть в браузере Chrome, перейдя по адресу chrome://net-internals/#import

public abstract void stopNetLog()

Останавливает запись в NetLog и записывает файл на диск. Если сеанс записи не запущен, этот вызов игнорируется.