CronetProvider

abstract class CronetProvider

既知の直接サブクラス
HttpEngineNativeProvider

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

JavaCronetProvider

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


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

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

概要

定数

const String!
PROVIDER_NAME_APP_PACKAGED = "App-Packaged-Cronet-Provider"

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

const String!
PROVIDER_NAME_FALLBACK = "Fallback-Cronet-Provider"

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

const String!
PROVIDER_NAME_HTTPENGINE_NATIVE = "HttpEngine-Native-Provider"

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

保護されたコンストラクタ

パブリック関数

abstract CronetEngine.Builder!

CronetEngine.Builder のインスタンスを作成して返します。

java-static (Mutable)List<CronetProvider!>!

使用可能なすべての CronetProvider の変更不可能なリストを返します。

abstract String!

プロバイダ名を返します。

abstract String!

プロバイダのバージョンを返します。

abstract Boolean

プロバイダが有効で、Cronet エンジンのインスタンス化に使用できるかどうかを返します。

String!

保護されたプロパティ

Context!

定数

PROVIDER_NAME_APP_PACKAGED

const val PROVIDER_NAME_APP_PACKAGED = "App-Packaged-Cronet-Provider": String!

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

PROVIDER_NAME_FALLBACK

const val PROVIDER_NAME_FALLBACK = "Fallback-Cronet-Provider": String!

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

PROVIDER_NAME_HTTPENGINE_NATIVE

const val PROVIDER_NAME_HTTPENGINE_NATIVE = "HttpEngine-Native-Provider": String!

プラットフォームに存在する HttpEngine 実装に基づく Cronet 実装を提供する CronetProvidergetName によって返される文字列。この実装では、実装固有と見なされた機能(netlog と内部指標へのアクセス)は提供されません。また、試験運用版の機能のサポートは保証されていません(他の Cronet プロバイダと同様)。

保護されたコンストラクタ

CronetProvider

protected CronetProvider(context: Context!)

パブリック関数

createBuilder

abstract fun createBuilder(): CronetEngine.Builder!

CronetEngine.Builder のインスタンスを作成して返します。

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

CronetEngine.Builder

例外
java.lang.IllegalStateException

プロバイダが有効になっていない場合(isEnabled を参照)。

getAllProviders

java-static fun getAllProviders(context: Context!): (Mutable)List<CronetProvider!>!

使用可能なすべての CronetProvider の変更不可能なリストを返します。プロバイダは順不同で返されます。返されたプロバイダの一部は無効状態になっている可能性があり、呼び出し元によって有効にされる必要があります。isEnabledをご確認ください。

戻り値
(Mutable)List<CronetProvider!>!

利用可能なプロバイダのリスト。

getName

abstract fun getName(): String!

プロバイダ名を返します。よく知られているプロバイダ名には、次のようなものがあります。

戻り値
String!

プロバイダ名。

getVersion

abstract fun getVersion(): String!

プロバイダのバージョンを返します。このバージョンは、複数のプロバイダが利用可能な場合に、利用可能な最新のプロバイダを選択するために使用できます。

戻り値
String!

プロバイダ バージョン。

isEnabled

abstract fun isEnabled(): Boolean

プロバイダが有効で、Cronet エンジンのインスタンス化に使用できるかどうかを返します。プロバイダが古く(API より古い)、更新が必要な場合、無効になる可能性があります。有効化の手順については、プロバイダのドキュメントをご覧ください。

戻り値
Boolean

プロバイダが有効な場合は true

toString

fun toString(): String!

保護されたプロパティ

mContext

protected val mContextContext!