CronetProvider

public abstract class CronetProvider

既知の直接サブクラス
HttpEngineNativeProvider

Android プラットフォームから HttpEngine 実装を読み込む Cronet プロバイダ実装。

JavaCronetProvider

CronetEngine の Java ベースの実装をビルドするための CronetEngine.Builder を作成する CronetProvider の実装。


CronetEngine.Builder インスタンスを作成するファクトリ メソッドを提供します。 CronetEngine.Builder インスタンスを使用して、特定の CronetEngine 実装を作成できます。利用可能な CronetProvider のリストを取得するには、getAllProviderInfos を呼び出します。

注: このクラスは、特定の Cronet 実装を選択したい上級ユーザー向けです。ほとんどのユーザーは、newCronetEngine.Builder を使用するだけで済みます。

概要

定数

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

アプリケーション内にパッケージ化されたネイティブ Cronet 実装を提供する CronetProvidergetName によって返される文字列。

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

システムの java.net.HttpURLConnection 実装に基づく Cronet 実装を提供する CronetProvidergetName によって返される文字列。

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

プラットフォームに存在する HttpEngine 実装に基づく Cronet 実装を提供する CronetProvidergetName によって返される文字列。

保護されたフィールド

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"

アプリケーション内にパッケージ化されたネイティブ Cronet 実装を提供する CronetProvidergetName によって返される文字列。この実装は、フォールバック Cronet 実装に比べてパフォーマンスが大幅に向上します(PROVIDER_NAME_FALLBACK を参照)。

PROVIDER_NAME_FALLBACK

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

システムの java.net.HttpURLConnection 実装に基づく Cronet 実装を提供する CronetProvidergetName によって返される文字列。この実装では、ネイティブの Cronet 実装と比較してパフォーマンスが大幅に低下します(PROVIDER_NAME_APP_PACKAGED を参照)。

PROVIDER_NAME_HTTPENGINE_NATIVE

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

プラットフォームに存在する HttpEngine 実装に基づく Cronet 実装を提供する CronetProvidergetName によって返される文字列。この実装では、実装固有と見なされた機能(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()