CronetProvider

public abstract class CronetProvider

Sottoclassi dirette note
HttpEngineNativeProvider

Un'implementazione del provider Cronet che carica l'implementazione di HttpEngine dalla piattaforma Android.

JavaCronetProvider

Implementazione di CronetProvider che crea CronetEngine.Builder per la creazione dell'implementazione basata su Java di CronetEngine.


Fornisce un metodo factory per creare istanze di CronetEngine.Builder. Un'istanza di CronetEngine.Builder può essere utilizzata per creare un'implementazione specifica di CronetEngine. Per ottenere l'elenco dei CronetProvider disponibili, chiama getAllProviderInfos.

NOTA: questa classe è destinata agli utenti avanzati che vogliono selezionare un'implementazione di Cronet specifica. La maggior parte degli utenti dovrebbe semplicemente utilizzare newCronetEngine.Builder.

Riepilogo

Costanti

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

Stringa restituita da getName per CronetProvider che fornisce l'implementazione nativa di Cronet inclusa in un'applicazione.

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

Stringa restituita da getName per CronetProvider che fornisce l'implementazione di Cronet basata sull'implementazione java.net.HttpURLConnection del sistema.

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

Stringa restituita da getName per CronetProvider che fornisce l'implementazione di Cronet basata sull'implementazione di HttpEngine presente nella piattaforma.

Campi protetti

final Context

Costruttori protetti

Metodi pubblici

abstract CronetEngine.Builder

Crea e restituisce un'istanza di CronetEngine.Builder.

static List<CronetProvider>

Restituisce un elenco non modificabile di tutti i CronetProvider disponibili.

abstract String

Restituisce il nome del provider.

abstract String

Restituisce la versione del provider.

abstract boolean

Restituisce un valore che indica se il provider è abilitato e può essere utilizzato per creare un'istanza del motore Cronet.

String

Costanti

PROVIDER_NAME_APP_PACKAGED

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

Stringa restituita da getName per CronetProvider che fornisce l'implementazione nativa di Cronet inclusa in un'applicazione. Questa implementazione offre prestazioni significativamente superiori rispetto alle implementazioni di Cronet di riserva (vedi PROVIDER_NAME_FALLBACK).

PROVIDER_NAME_FALLBACK

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

Stringa restituita da getName per CronetProvider che fornisce l'implementazione di Cronet basata sull'implementazione java.net.HttpURLConnection del sistema. Questa implementazione offre prestazioni significativamente inferiori rispetto alle implementazioni native di Cronet (vedi PROVIDER_NAME_APP_PACKAGED).

PROVIDER_NAME_HTTPENGINE_NATIVE

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

Stringa restituita da getName per CronetProvider che fornisce l'implementazione di Cronet basata sull'implementazione di HttpEngine presente nella piattaforma. Questa implementazione non fornisce funzionalità ritenute specifiche dell'implementazione, ovvero l'accesso a netlog e metriche interne. Inoltre, il supporto per le funzionalità sperimentali non è garantito (come per qualsiasi altro provider Cronet).

Campi protetti

mContext

protected final Context mContext

Costruttori protetti

CronetProvider

protected CronetProvider(Context context)

Metodi pubblici

createBuilder

public abstract CronetEngine.Builder createBuilder()

Crea e restituisce un'istanza di CronetEngine.Builder.

NOTA: questa classe è destinata agli utenti avanzati che vogliono selezionare un'implementazione di Cronet specifica. La maggior parte degli utenti dovrebbe semplicemente utilizzare newCronetEngine.Builder.
Restituisce
CronetEngine.Builder

CronetEngine.Builder.

Genera
java.lang.IllegalStateException

se il provider non è abilitato (vedi isEnabled.

getAllProviders

public static List<CronetProvidergetAllProviders(Context context)

Restituisce un elenco non modificabile di tutti i CronetProvider disponibili. I provider vengono restituiti senza un ordine specifico. Alcuni dei provider restituiti potrebbero essere disabilitati e devono essere abilitati dal chiamante. Vedi isEnabled.

Restituisce
List<CronetProvider>

l'elenco dei provider disponibili.

getName

public abstract String getName()

Restituisce il nome del provider. I nomi dei provider noti includono:

Restituisce
String

nome del provider.

getVersion

public abstract String getVersion()

Restituisce la versione del provider. La versione può essere utilizzata per selezionare il provider disponibile più recente se sono disponibili più provider.

Restituisce
String

versione del provider.

isEnabled

public abstract boolean isEnabled()

Restituisce un valore che indica se il provider è abilitato e può essere utilizzato per creare un'istanza del motore Cronet. Un potenziale motivo per cui un provider potrebbe essere disabilitato è che è obsoleto (più vecchio dell'API) e deve essere aggiornato. Leggi la documentazione del provider per la procedura di abilitazione.

Restituisce
boolean

true se il provider è abilitato.

toString

public String toString()