CronetProvider

public abstract class CronetProvider

已知的直接子类
HttpEngineNativeProvider

一种 Cronet 提供程序实现,用于从 Android 平台加载 HttpEngine 实现。

JavaCronetProvider

CronetProvider 的实现,用于创建 CronetEngine.Builder 以构建基于 Java 的 CronetEngine 实现。


提供用于创建 CronetEngine.Builder 实例的工厂方法。 CronetEngine.Builder 实例可用于创建特定的 CronetEngine 实现。如需获取可用 CronetProvider 的列表,请调用 getAllProviderInfos

注意 :此类适用于想要选择特定 Cronet 实现的高级用户。大多数用户只需使用 newCronetEngine.Builder。

摘要

常量

static final String
PROVIDER_NAME_APP_PACKAGED = "App-Packaged-Cronet-Provider"

getNameCronetProvider 返回的字符串,该字符串提供打包在应用中的原生 Cronet 实现。

static final String
PROVIDER_NAME_FALLBACK = "Fallback-Cronet-Provider"

getNameCronetProvider 返回的字符串,该字符串提供基于系统的 java.net.HttpURLConnection 实现的 Cronet 实现。

static final String
PROVIDER_NAME_HTTPENGINE_NATIVE = "HttpEngine-Native-Provider"

getNameCronetProvider 返回的字符串,该字符串提供基于平台中存在的 HttpEngine 实现的 Cronet 实现。

受保护的字段

final Context

受保护的构造函数

公共方法

abstract CronetEngine.Builder

创建并返回 CronetEngine.Builder 的实例。

static List<CronetProvider>

返回所有可用 CronetProvider 的不可修改列表。

abstract String

返回提供程序名称。

abstract String

返回提供程序版本。

abstract boolean

返回提供程序是否已启用,以及是否可用于实例化 Cronet 引擎。

String

常量

PROVIDER_NAME_APP_PACKAGED

public static final String PROVIDER_NAME_APP_PACKAGED = "App-Packaged-Cronet-Provider"

getNameCronetProvider 返回的字符串,该字符串提供打包在应用中的原生 Cronet 实现。与备用 Cronet 实现(请参阅 PROVIDER_NAME_FALLBACK)相比,此实现可显著提高性能。

PROVIDER_NAME_FALLBACK

public static final String PROVIDER_NAME_FALLBACK = "Fallback-Cronet-Provider"

getNameCronetProvider 返回的字符串,该字符串提供基于系统的 java.net.HttpURLConnection 实现的 Cronet 实现。与原生 Cronet 实现(请参阅 PROVIDER_NAME_APP_PACKAGED)相比,此实现的性能显著降低。

PROVIDER_NAME_HTTPENGINE_NATIVE

public static final String PROVIDER_NAME_HTTPENGINE_NATIVE = "HttpEngine-Native-Provider"

getNameCronetProvider 返回的字符串,该字符串提供基于平台中存在的 HttpEngine 实现的 Cronet 实现。此实现不提供被视为特定于实现的功能,即访问 netlog 和内部指标。此外,与其他任何 Cronet 提供程序一样,对实验性功能的支持无法保证。

受保护的字段

mContext

protected final Context mContext

受保护的构造函数

CronetProvider

protected CronetProvider(Context context)

公共方法

createBuilder

public abstract CronetEngine.Builder createBuilder()

创建并返回 CronetEngine.Builder 的实例。

注意 :此类适用于想要选择特定 Cronet 实现的高级用户。大多数用户只需使用 newCronetEngine.Builder。
返回
CronetEngine.Builder

CronetEngine.Builder

抛出
java.lang.IllegalStateException

如果提供程序未启用(请参阅 isEnabled)。

getAllProviders

public static List<CronetProvidergetAllProviders(Context context)

返回所有可用 CronetProvider 的不可修改列表。返回的提供程序没有特定的顺序。返回的某些提供程序可能处于停用状态,应由调用方启用。请参阅 isEnabled

返回
List<CronetProvider>

可用提供程序的列表。

getName

public abstract String getName()

返回提供程序名称。众所周知的提供程序名称包括:

返回
String

提供程序名称。

getVersion

public abstract String getVersion()

返回提供程序版本。如果有多个提供程序可用,则可以使用该版本选择最新的可用提供程序。

返回
String

提供程序版本。

isEnabled

public abstract boolean isEnabled()

返回提供程序是否已启用,以及是否可用于实例化 Cronet 引擎。提供方过时(比 API 旧)且需要更新是其可能被停用的一个潜在原因。请阅读提供程序文档,了解启用过程。

返回
boolean

如果提供程序已启用,则返回 true

toString

public String toString()