UrlRequest.Builder

const val REQUEST_PRIORITY_HIGHEST = 4: Int

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

const val REQUEST_PRIORITY_IDLE = 0: Int

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

const val REQUEST_PRIORITY_LOW = 2: Int

Priorità bassa della richiesta. Trasferito a setPriority.

const val REQUEST_PRIORITY_LOWEST = 1: Int

Priorità della richiesta molto bassa. Trasferito a setPriority.

const val REQUEST_PRIORITY_MEDIUM = 3: Int

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

abstract fun addHeader(header: String!, value: String!): UrlRequest.Builder!

Aggiunge un'intestazione della richiesta.

fun addRequestAnnotation(annotation: Any!): UrlRequest.Builder!

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

abstract fun allowDirectExecutor(): UrlRequest.Builder!

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.

fun bindToNetwork(networkHandle: Long): UrlRequest.Builder!

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.

abstract fun build(): UrlRequest!

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

abstract fun disableCache(): UrlRequest.Builder!

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

abstract fun setHttpMethod(method: String!): UrlRequest.Builder!

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.

abstract fun setPriority(priority: Int): UrlRequest.Builder!

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
fun setRawCompressionDictionary(
    dictionarySha256Hash: ByteArray!,
    dictionary: ByteBuffer!,
    dictionaryId: String!
): UrlRequest.Builder!

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.

fun setRequestFinishedListener(listener: RequestFinishedInfo.Listener!): UrlRequest.Builder!

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().

fun setTrafficStatsTag(tag: Int): UrlRequest.Builder!

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.

fun setTrafficStatsUid(uid: Int): UrlRequest.Builder!

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.

abstract fun setUploadDataProvider(
    uploadDataProvider: UploadDataProvider!,
    executor: Executor!
): UrlRequest.Builder!

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.