Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

UrlRequest.Callback

abstract class UrlRequest.Callback

Sottoclassi dirette note

ImplicitFlowControlCallback

ImplicitFlowControlCallback

Un'implementazione di UrlRequest.Callback che elimina la difficoltà di gestire il ciclo di vita della richiesta e procede automaticamente alla lettura completa della risposta.

Sottoclassi indirette note

ByteArrayCronetCallback, InMemoryTransformCronetCallback, JsonCronetCallback, StringCronetCallback

`ByteArrayCronetCallback`	Una specializzazione di `InMemoryTransformCronetCallback` che restituisce i byte del corpo verbatim senza alcuna interpretazione.
`InMemoryTransformCronetCallback`	Un callback Cronet astratto che legge l'intero corpo in memoria e, facoltativamente, lo deserializza prima di restituirlo all'emittente della richiesta HTTP.
`JsonCronetCallback`	Una specializzazione di `InMemoryTransformCronetCallback` che interpreta il corpo della risposta come JSON.
`StringCronetCallback`	Una specializzazione di `InMemoryTransformCronetCallback` che interpreta il corpo della risposta come una stringa.

Gli utenti di Cronet estendono questa classe per ricevere callback che indicano l'avanzamento di una UrlRequest in fase di elaborazione. Un'istanza di questa classe viene passata al costruttore di UrlRequest.Builder durante la costruzione di UrlRequest.

Nota: tutti i metodi verranno richiamati sul thread di java.util.concurrent.Executor utilizzato durante la costruzione di UrlRequest.

Riepilogo

Costruttori pubblici
`Callback()`

Funzioni pubbliche
`Unit`	`onCanceled(request: UrlRequest!, info: UrlResponseInfo!)` Richiamato se la richiesta è stata annullata tramite `cancel`.
`abstract Unit`	`onFailed( request: UrlRequest!, info: UrlResponseInfo!, error: CronetException! )` Richiamato se la richiesta non è riuscita per qualsiasi motivo dopo `start`.
`abstract Unit`	`onReadCompleted( request: UrlRequest!, info: UrlResponseInfo!, byteBuffer: ByteBuffer! )` Richiamato ogni volta che è stata letta una parte del corpo della risposta.
`abstract Unit`	`onRedirectReceived( request: UrlRequest!, info: UrlResponseInfo!, newLocationUrl: String! )` Richiamato ogni volta che viene rilevato un reindirizzamento.
`abstract Unit`	`onResponseStarted(request: UrlRequest!, info: UrlResponseInfo!)` Richiamato quando viene ricevuto l'insieme finale di intestazioni, dopo tutti i reindirizzamenti.
`abstract Unit`	`onSucceeded(request: UrlRequest!, info: UrlResponseInfo!)` Richiamato quando la richiesta viene completata correttamente.

Costruttori pubblici

Callback

Callback()

Funzioni pubbliche

onCanceled

fun onCanceled(request: UrlRequest!, info: UrlResponseInfo!): Unit

Richiamato se la richiesta è stata annullata tramite cancel. Una volta richiamato, non verranno richiamati altri metodi Callback. L'implementazione predefinita non esegue alcuna azione.

Parametri
`request: UrlRequest!`	Richiesta annullata.
`info: UrlResponseInfo!`	Informazioni sulla risposta. Può essere `null` se non è stata ricevuta alcuna risposta.

onFailed

abstract fun onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
): Unit

Richiamato se la richiesta non è riuscita per qualsiasi motivo dopo start. Una volta richiamato, non verranno richiamati altri metodi Callback. error fornisce informazioni sull'errore.

Parametri
`request: UrlRequest!`	Richiesta non riuscita.
`info: UrlResponseInfo!`	Informazioni sulla risposta. Può essere `null` se non è stata ricevuta alcuna risposta.
`error: CronetException!`	Informazioni sull'errore.

onReadCompleted

abstract fun onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
): Unit

Richiamato ogni volta che è stata letta una parte del corpo della risposta. Solo una parte del buffer può essere popolata, anche se l'intero corpo della risposta non è ancora stato consumato. Ad eccezione di onCanceled(), non verrà richiamato nessun altro metodo Callback per la richiesta, inclusi onSucceeded() e onFailed(), finché non viene chiamato UrlRequest.read() per tentare di continuare a leggere il corpo della risposta.

Parametri
`request: UrlRequest!`	Richiesta che ha ricevuto i dati.
`info: UrlResponseInfo!`	Informazioni sulla risposta.
`byteBuffer: ByteBuffer!`	Il buffer passato a `UrlRequest.read()`, ora contenente i dati ricevuti. La posizione del buffer viene aggiornata alla fine dei dati ricevuti. Il limite del buffer non viene modificato.

Genera
`java.lang.Exception`	Se si verifica un errore durante l'elaborazione del completamento della lettura. Verrà chiamato `onFailed` con l'eccezione generata impostata come causa di `CallbackException`.

onRedirectReceived

abstract fun onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
): Unit

Richiamato ogni volta che viene rilevato un reindirizzamento. Verrà richiamato solo tra la chiamata a start e onResponseStarted(). Il corpo della risposta di reindirizzamento, se ne ha uno, verrà ignorato. Il reindirizzamento non verrà seguito finché non viene chiamato il metodo followRedirect di URLRequest, in modo sincrono o asincrono.

Parametri
`request: UrlRequest!`	Richiesta in fase di reindirizzamento.
`info: UrlResponseInfo!`	Informazioni sulla risposta.
`newLocationUrl: String!`	Posizione in cui viene reindirizzata la richiesta.

Genera
`java.lang.Exception`	Se si verifica un errore durante l'elaborazione di un reindirizzamento. Verrà chiamato `onFailed` con l'eccezione generata impostata come causa di `CallbackException`.

onResponseStarted

abstract fun onResponseStarted(request: UrlRequest!, info: UrlResponseInfo!): Unit

Richiamato quando viene ricevuto l'insieme finale di intestazioni, dopo tutti i reindirizzamenti. Verrà richiamato una sola volta per ogni richiesta. Ad eccezione di onCanceled(), non verrà richiamato nessun altro metodo Callback per la richiesta, inclusi onSucceeded() e onFailed(), finché non viene chiamato UrlRequest.read() per tentare di iniziare a leggere il corpo della risposta.

Parametri
`request: UrlRequest!`	Richiesta che ha iniziato a ricevere la risposta.
`info: UrlResponseInfo!`	Informazioni sulla risposta.

Genera
`java.lang.Exception`	Se si verifica un errore durante l'elaborazione dell'inizio della risposta. Verrà chiamato `onFailed` con l'eccezione generata impostata come causa di `CallbackException`.

onSucceeded

abstract fun onSucceeded(request: UrlRequest!, info: UrlResponseInfo!): Unit

Richiamato quando la richiesta viene completata correttamente. Una volta richiamato, non verranno richiamati altri metodi Callback.

Parametri
`request: UrlRequest!`	Richiesta riuscita.
`info: UrlResponseInfo!`	Informazioni sulla risposta.