UrlRequest.Builder

public static final int REQUEST_PRIORITY_HIGHEST = 4

Priorità più alta per le richieste. Trasferito a setPriority.

public static final int REQUEST_PRIORITY_IDLE = 0

Priorità più bassa della richiesta. Trasferito a setPriority.

public static final int REQUEST_PRIORITY_LOW = 2

Priorità bassa della richiesta. Trasferito a setPriority.

public static final int REQUEST_PRIORITY_LOWEST = 1

Priorità della richiesta molto bassa. Trasferito a setPriority.

public static final int REQUEST_PRIORITY_MEDIUM = 3

Priorità media della richiesta. Trasferito a setPriority. Questa è la priorità predefinita assegnata alla richiesta.

public abstract UrlRequest.Builder addHeader(String header, String value)

Aggiunge un'intestazione della richiesta.

public UrlRequest.Builder addRequestAnnotation(Object annotation)

Associa l'oggetto annotazione a questa richiesta. Può aggiungerne più di uno. Trasferito a un RequestFinishedInfo.Listener, vedi getAnnotations.

public abstract UrlRequest.Builder allowDirectExecutor()

Indica che gli esecutori che questa richiesta utilizzeranno per notificare i callback (per UploadDataProvider e UrlRequest.Callback) eseguono intenzionalmente l'esecuzione inline, come directExecutor di Guava o java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy.

Avviso:questa opzione semplifica il blocco accidentale del thread di rete. Non deve essere utilizzato se i callback eseguono operazioni di I/O su disco, acquisiscono blocchi o chiamano altro codice che non controlli e non verifichi attentamente.

public UrlRequest.Builder bindToNetwork(long networkHandle)

Associa la richiesta all'handle di rete specificato. Cronet invierà questa richiesta solo utilizzando la rete associata a questo handle. Se la rete si disconnette, la richiesta non andrà a buon fine. L'errore esatto dipende dalla fase di elaborazione della richiesta al momento della disconnessione della rete. Gli handle di rete possono essere ottenuti tramite Network#getNetworkHandle. Disponibile solo a partire da Android Marshmallow.

public abstract UrlRequest build()

Crea un UrlRequest utilizzando la configurazione all'interno di questo Builder. La UrlRequest restituita può essere avviata chiamando il numero start.

public abstract UrlRequest.Builder disableCache()

Disabilita la cache per la richiesta. Se il contesto non è configurato per utilizzare la cache, questa chiamata non ha alcun effetto.

public abstract UrlRequest.Builder setHttpMethod(String method)

Imposta il verbo del metodo HTTP da utilizzare per questa richiesta.

Il valore predefinito quando questo metodo non viene chiamato è "GET" se la richiesta non ha corpo o "POST" se ne ha uno.

public abstract UrlRequest.Builder setPriority(int priority)

Imposta la priorità della richiesta, che deve essere uno dei valori REQUEST_PRIORITY_*. Se questo metodo non viene chiamato, alla richiesta viene assegnata la priorità REQUEST_PRIORITY_MEDIUM.

@UrlRequest.Experimental
public UrlRequest.Builder setRawCompressionDictionary(
    byte[] dictionarySha256Hash,
    ByteBuffer dictionary,
    String dictionaryId
)

Consente a Cronet di utilizzare il dizionario di compressione specificato per questa richiesta. Se specificato, Cronet potrebbe segnalare al server la disponibilità del dizionario di compressione. Affinché questa operazione abbia effetto, CronetEngine che eseguirà questa richiesta deve essere configurato per abilitare uno schema di compressione che supporti dizionari esterni. Questa implementazione parziale della bozza draft-ietf-httpbis-compression-dictionary all'interno di Cronet. Cronet non gestirà direttamente le intestazioni di risposta "Use-As-Dictionary", ma si affiderà all'incorporatore per: gestirle e chiamare in un secondo momento UrlRequest.Builder#setCompressionDictionary per le richieste che corrispondono alle regole di Use-As-Dictionary; oppure recuperare i dizionari di compressione tramite un altro meccanismo out-of-band e chiamare in un secondo momento UrlRequest.Builder#setCompressionDictionary. Cronet interpreterà il dizionario in modo che corrisponda solo a questa UrlRequest. Se la richiesta viene reindirizzata e l'incorporatore decide di seguire il reindirizzamento, il dizionario corrisponderà anche al nuovo URL.

public UrlRequest.Builder setRequestFinishedListener(RequestFinishedInfo.Listener listener)

Imposta un listener che viene richiamato dopo la restituzione di onCanceled(), onFailed() o onSucceeded().

Il listener viene richiamato con le informazioni di fine richiesta su un java.util.concurrent.Executor fornito da getExecutor().

public UrlRequest.Builder setTrafficStatsTag(int tag)

Imposta il tag android.net.TrafficStats da utilizzare per contabilizzare il traffico socket causato da questa richiesta. Leggi i android.net.TrafficStats per avere ulteriori informazioni. Se non viene impostato alcun tag (ad es. questo metodo non viene chiamato), Android considera il traffico socket causato da questa richiesta come se il valore del tag fosse impostato su 0.

NOTA:l'impostazione di un tag non consente la condivisione dei socket con le richieste con altri tag, il che potrebbe influire negativamente sulle prestazioni vietando la condivisione delle connessioni. In altre parole, l'utilizzo di socket multiplexati (ad es. HTTP/2 e QUIC) sarà consentito solo se tutte le richieste hanno lo stesso tag socket.

public UrlRequest.Builder setTrafficStatsUid(int uid)

Imposta un UID specifico da utilizzare per il traffico socket causato da questa richiesta. Consulta android.net.TrafficStats per ulteriori informazioni. Progettato per l'utilizzo durante l'esecuzione di un'operazione per conto di un'altra applicazione. Il chiamante deve disporre dell'autorizzazione MODIFY_NETWORK_ACCOUNTING. Per impostazione predefinita, il traffico viene attribuito all'UID del chiamante.

NOTA:l'impostazione di un UID non consente la condivisione di socket con richieste con altri UID, il che potrebbe influire negativamente sulle prestazioni vietando la condivisione delle connessioni. In altre parole, l'utilizzo di socket multiplexati (ad es. HTTP/2 e QUIC) sarà consentito solo se tutte le richieste hanno lo stesso UID impostato.

public abstract UrlRequest.Builder setUploadDataProvider(
    UploadDataProvider uploadDataProvider,
    Executor executor
)

Imposta il fornitore di dati di caricamento. Se non è impostato esplicitamente, il metodo viene impostato su "POST". L'avvio della richiesta genererà un'eccezione se non è impostata un'intestazione Content-Type.